【Oracle】ORA-31684 完全解説｜impdp でオブジェクトが既存の場合の対処法・EXCLUDE・table_exists_action

Oracle の Data Pump Import（impdp）実行中に大量に出力される ORA-31684: Object type XX:”YY” already exists。「エラーが出たのにインポートは完了している」「このエラーは無視していいのか」と悩んだ経験はないでしょうか。本記事では ORA-31684 の発生メカニズムから、table_exists_action・EXCLUDE・REMAP_SCHEMA・CONTENT=DATA_ONLY まで、状況別の解決策を体系的に解説します。

ORA-31684 とは

ORA-31684 は、impdp がオブジェクトを作成しようとしたとき、同名のオブジェクトがインポート先に既に存在している場合に発生します。

ORA-31684: Object type USER:"SCOTT" already exists
ORA-31684: Object type ROLE:"APP_ROLE" already exists
ORA-31684: Object type TABLE:"EMP" already exists
ORA-31684: Object type TABLESPACE:"USERS" already exists

エラーメッセージの読み方

ORA-31684 が出やすい Object type 一覧

発生パターンと対処法

パターン1：テーブルが既存（最頻出）

同名テーブルが既に存在する場合の対処は table_exists_action パラメータで制御します。

table_exists_action の4オプション比較

-- データを追記（append）
impdp system/manager \
  directory=DATA_PUMP_DIR \
  dumpfile=backup.dmp \
  schemas=SCOTT \
  table_exists_action=append \
  logfile=import.log

-- テーブルを再作成して置き換え（replace）
impdp system/manager \
  directory=DATA_PUMP_DIR \
  dumpfile=backup.dmp \
  schemas=SCOTT \
  table_exists_action=replace \
  logfile=import.log

パターン2：USER / ROLE / TABLESPACE が既存（FULL インポート時）

FULL モードで別のデータベースの全体ダンプをインポートすると、USER・ROLE・TABLESPACE は既存と衝突しやすいです。これらの ORA-31684 は多くの場合無視して問題ありません（テーブルのデータは正常にインポートされます）。

EXCLUDE で特定オブジェクト種別をスキップ

-- USER・TABLESPACE・ROLE の作成をスキップしてインポート
impdp system/manager \
  directory=DATA_PUMP_DIR \
  dumpfile=fullbackup.dmp \
  full=y \
  exclude=USER \
  exclude=TABLESPACE \
  exclude=ROLE \
  table_exists_action=replace \
  logfile=import.log

EXCLUDE で特定オブジェクトをピンポイントにスキップ

-- 特定のテーブルのみ除外（parfile 推奨・コマンドラインはエスケープが複雑）
impdp system/manager \
  directory=DATA_PUMP_DIR \
  dumpfile=backup.dmp \
  schemas=SCOTT \
  exclude=TABLE:\"IN (\'EMP\',\'DEPT\')\" \
  logfile=import.log

-- インデックスのみ除外
impdp system/manager \
  directory=DATA_PUMP_DIR \
  dumpfile=backup.dmp \
  schemas=SCOTT \
  exclude=INDEX \
  logfile=import.log

パターン3：スキーマを別名でインポート（REMAP_SCHEMA）

本番のダンプを開発環境に取り込む場合など、スキーマ名を変えてインポートすることで既存オブジェクトとの衝突を回避できます。

-- SCOTT スキーマの内容を SCOTT_DEV スキーマとしてインポート
impdp system/manager \
  directory=DATA_PUMP_DIR \
  dumpfile=backup.dmp \
  remap_schema=SCOTT:SCOTT_DEV \
  logfile=import.log

パターン4：データのみインポート（CONTENT=DATA_ONLY）

DDL（テーブル定義・インデックス定義など）のインポートを完全に省略し、データの INSERT だけを実行します。ORA-31684 は一切発生しません。

-- データのみインポート（DDL は一切実行しない）
impdp system/manager \
  directory=DATA_PUMP_DIR \
  dumpfile=backup.dmp \
  schemas=SCOTT \
  content=data_only \
  table_exists_action=append \
  logfile=import.log

状況別：どのパラメータを使うべきか

impdp 実行前の事前確認チェックリスト

インポート先の既存オブジェクトを確認するSQL

-- スキーマ内のテーブル一覧
SELECT table_name FROM dba_tables WHERE owner = \'SCOTT\' ORDER BY table_name;

-- スキーマ内の全オブジェクト一覧
SELECT object_name, object_type, status
FROM   dba_objects
WHERE  owner = \'SCOTT\'
ORDER  BY object_type, object_name;

-- ユーザー一覧（FULL インポート前の確認）
SELECT username FROM dba_users ORDER BY username;

チェックリスト

ログファイルで ORA-31684 の影響を確認する

インポート後は必ずログファイルで ORA-31684 の発生箇所と「それに伴う ORA-39111（依存オブジェクトのスキップ）」を確認します。

-- ログの末尾を確認
type import.log | findstr /I "ORA-"    ← Windows
grep "ORA-" import.log                 ← Linux

-- 典型的なログの流れ
ORA-31684: Object type TABLE:"EMP" already exists
ORA-39111: Dependent object type INDEX:"EMP_PK" skipped
-- ↑ EMP が既存のためそのインデックスもスキップされた

よくある質問（FAQ）

-- import.par の内容
directory=DATA_PUMP_DIR
dumpfile=backup.dmp
schemas=SCOTT
table_exists_action=replace
exclude=USER
exclude=TABLESPACE
logfile=import.log

-- 実行
impdp system/manager parfile=import.par

まとめ

ORA-31684 は impdp の仕様上「既存がある環境に再インポートすると必ず出る」エラーです。USER/ROLE/TABLESPACE への衝突は EXCLUDE で回避し、テーブルへの衝突は table_exists_action で動作を制御するという2つの軸を押さえれば、ほぼすべてのケースに対応できます。