【Oracle】バージョンが違うDBでData Pumpを使うときの注意点完全ガイド｜version指定・互換性・エラー対処まで

Oracleデータベースのバージョンアップやシステム移行で、異なるバージョン間でのData Pump（expdp/impdp）を使ったデータ転送は多くの現場で発生します。しかし、バージョンが違う環境でそのままダンプファイルをインポートしようとすると、ORA-39142やORA-31693といったエラーが発生することがあります。

本記事では、Data Pumpのバージョン互換性の基本ルールから、versionパラメータの使い方、バージョン別の制限事項、よくあるエラーの対処法まで、実務で役立つ情報を網羅的に解説します。

Data Pumpのバージョン互換性の基本ルール

Data Pumpのバージョン互換性には、以下の基本ルールがあります。

原則：下位→上位は問題なし、上位→下位はversion指定が必要

Data Pumpのダンプファイルには、エクスポートしたOracleのバージョン情報が埋め込まれています。インポート先のバージョンがダンプファイルのバージョン以上であれば通常通りインポートできます。逆に、インポート先のバージョンがダンプファイルより低い場合はそのままではインポートできません。

versionパラメータの使い方

上位バージョンのDBから下位バージョンへエクスポートする場合、expdpにversionパラメータを指定します。

基本構文

expdp user/password \
  dumpfile=data.dmp \
  schemas=HR \
  directory=DATA_PUMP_DIR \
  version=12.2

versionに指定できる値

バージョン番号の指定例

• Oracle 11gR2：version=11.2
• Oracle 12cR1：version=12.1
• Oracle 12cR2：version=12.2
• Oracle 18c：version=18.1
• Oracle 19c：version=19.1
• Oracle 21c：version=21.1

version指定時の制限事項

古いバージョン向けにversionを指定してエクスポートする場合、そのバージョンに存在しない機能は自動的にスキップまたはエラーになります。

version指定時に併用を推奨するオプション

互換性問題を減らすために、以下のオプションを組み合わせて使うことが多いです。

expdp user/password \
  dumpfile=data.dmp \
  schemas=HR \
  directory=DATA_PUMP_DIR \
  version=12.2 \
  exclude=statistics \
  transform=segment_attributes:n

impdp側の推奨オプション

バージョンが異なるDB間のインポートでは、impdp側でも以下のオプションを指定するとエラーを減らしてスムーズにインポートできます。

impdp user/password \
  dumpfile=data.dmp \
  schemas=HR \
  directory=DATA_PUMP_DIR \
  data_options=skip_constraint_errors \
  transform=oid:n \
  exclude=statistics

ダンプファイルのバージョン確認方法

入手したダンプファイルが何バージョンでエクスポートされたかを確認する方法を説明します。

方法1：impdpのSQLFILEオプション

sqlfileオプションを指定すると、実際にインポートせずDDLをファイルに出力できます。ファイル先頭にバージョン情報が含まれます。

impdp user/password \
  dumpfile=data.dmp \
  directory=DATA_PUMP_DIR \
  sqlfile=check.sql

出力されたcheck.sqlの先頭部分にバージョン情報が記載されます：

-- EXPORT FILE CREATED BY EXPORT:V19.00.00.00.00 AND IMPORT COMPATIBLE: 19.00.00.00.00
-- EXPORT DUMP FILE VERSION IS: 19.00.00.00.00
-- EXPORT COMPATIBILITY VERSION IS: 19.00.00.00.00

方法2：impdpのSHOW=Yオプション（19c以降）

Oracle 19c以降ではshow=yオプションでダンプファイルの内容確認が簡単にできます。

impdp user/password \
  dumpfile=data.dmp \
  directory=DATA_PUMP_DIR \
  show=y

方法3：V$DATAPUMP_JOBで確認

ジョブ実行中は以下のビューで状況確認できます。

-- 実行中のData Pumpジョブを確認
SELECT job_name, operation, job_mode, state, degree
FROM   v$datapump_job;

バージョン別の主な互換性制限

よく発生するバージョン組み合わせごとの主な制限事項をまとめます。

19c → 12c への移行

12c → 11g への移行

21c → 19c への移行

よくあるエラーと対処法

ORA-39142: ダンプファイルのバージョンが新しい

ORA-39142: incompatible version number 19.1 in dump file
"DATA_PUMP_DIR":"data.dmp"

原因：インポート先のOracleバージョンより新しいバージョンでエクスポートされたダンプファイルをインポートしようとしている。

対処：エクスポート元でversionパラメータにインポート先のバージョンを指定して再エクスポートする。

# エクスポート元（19c）でインポート先（12c）向けに再エクスポート
expdp user/password \
  dumpfile=data_for_12c.dmp \
  schemas=HR \
  directory=DATA_PUMP_DIR \
  version=12.2

ORA-31693: オブジェクトのロードに失敗

ORA-31693: Table data object "HR"."EMPLOYEES" failed to load/unload
ORA-02354: error in exporting/importing data
ORA-01555: snapshot too old

原因：エクスポート中にSNAPSHOT TOO OLD（UNDO領域の不足）が発生している。大きなテーブルや長時間のエクスポートで起きやすい。

対処：

• UNDO表領域のサイズを増やす
• UNDO_RETENTIONパラメータを増やす
• エクスポート対象を分割して実行する
• 夜間など更新が少ない時間帯に実行する

-- UNDO領域の使用状況確認
SELECT tablespace_name, status, sum(blocks), sum(bytes)/1024/1024 AS mb
FROM   dba_undo_extents
GROUP  BY tablespace_name, status;

-- UNDO_RETENTIONの確認と変更（DBA権限必要）
SELECT name, value FROM v$parameter WHERE name = 'undo_retention';
ALTER SYSTEM SET undo_retention = 3600;  -- 3600秒(1時間)

ORA-39341: 新機能を含むオブジェクト

ORA-39341: object type TABLE:"HR"."EMPLOYEES" contains
features not supported in version 12.2

原因：エクスポート対象のオブジェクトが、指定したversionではサポートされていない機能を使用している。

対処：

• エラーの原因となっているオブジェクト・機能を特定する
• そのオブジェクトをエクスポート対象から除外する（exclude=TABLE:"TABLENAME"）
• 手動で移行先バージョン対応のDDLに書き直してインポートする

ORA-31684: オブジェクトが既に存在する

ORA-31684: Object type USER:"HR" already exists

原因：インポート先にすでに同名のユーザー・オブジェクトが存在している。

対処：table_exists_action=replaceまたはexclude=userを指定する。詳しくはORA-31684の対処法を参照。

実務でよく使うコマンドまとめ

よくある質問（FAQ）

まとめ

あわせて読みたい

• 【Oracle】expdpで複数テーブルを指定してエクスポートする方法
• 【Oracle】Data PumpのCONTENT=DATA_ONLYオプションの使い方
• 【Oracle】ORA-31684の原因と対処法
• 【Oracle】Data Pump（expdp/impdp）の使い方まとめ
• 【Oracle】Data Pumpのパラレル処理でエクスポート・インポートを高速化する