【Oracle】Data Pump（expdp / impdp）完全ガイド｜エクスポート・インポート・スキーマ移行・よく使うパラメータまで解説

-- DBA 権限でログインして DIRECTORY を作成する
CREATE DIRECTORY dp_dir AS '/u01/backup/datapump';
-- ※ ディレクトリは OS 上に実際に存在する必要がある（Oracle は自動作成しない）

-- DIRECTORY 一覧を確認する
SELECT directory_name, directory_path
FROM DBA_DIRECTORIES
ORDER BY directory_name;

-- ユーザーに READ / WRITE 権限を付与する
GRANT READ, WRITE ON DIRECTORY dp_dir TO hr;
GRANT READ, WRITE ON DIRECTORY dp_dir TO scott;

-- Oracle にはデフォルトで DATA_PUMP_DIR が存在する（環境による）
-- パスは SELECT * FROM DBA_DIRECTORIES WHERE directory_name='DATA_PUMP_DIR'; で確認

# スキーマ単位でエクスポート（最も一般的な使い方）
expdp hr/hr_password@localhost:1521/orcl   SCHEMAS=hr   DIRECTORY=dp_dir   DUMPFILE=hr_schema_%date%.dmp   LOGFILE=hr_export.log

# 複数スキーマをまとめてエクスポート
expdp system/password@orcl   SCHEMAS=hr,scott,oe   DIRECTORY=dp_dir   DUMPFILE=multi_schema_%U.dmp   FILESIZE=2G   PARALLEL=4   LOGFILE=multi_schema_export.log

# 特定テーブルだけをエクスポート
expdp hr/hr_password@orcl   TABLES=hr.employees,hr.departments   DIRECTORY=dp_dir   DUMPFILE=emp_dept.dmp   LOGFILE=emp_dept_export.log

# データベース全体（フルエクスポート）
expdp system/password@orcl   FULL=y   DIRECTORY=dp_dir   DUMPFILE=full_%U.dmp   FILESIZE=5G   PARALLEL=8   LOGFILE=full_export.log

# PARFILE（パラメータファイル）を使う場合
expdp system/password@orcl PARFILE=/home/oracle/export.par
# /home/oracle/export.par の内容:
# SCHEMAS=hr
# DIRECTORY=dp_dir
# DUMPFILE=hr_%U.dmp
# LOGFILE=hr_export.log
# COMPRESSION=ALL
# PARALLEL=4

-- QUERY: 特定の条件でデータを絞り込んでエクスポートする
-- ※ テーブル単位で条件を指定する（スキーマエクスポート時は対象テーブルを指定）
-- コマンドライン: QUERY=hr.employees:"WHERE department_id=60"
-- PARFILE 内:
-- QUERY=hr.employees:"WHERE hire_date > DATE '2020-01-01'"

-- EXCLUDE: 特定のオブジェクト種類・オブジェクトをエクスポートから除外する
-- コマンドライン例（PARFILE 推奨）:
-- EXCLUDE=STATISTICS           -- オプティマイザ統計を除外（インポート後に収集する）
-- EXCLUDE=GRANT                -- 権限を除外
-- EXCLUDE=TABLE:"='TEMP_LOG'"  -- 特定テーブルを除外
-- EXCLUDE=INDEX                -- すべてのインデックスを除外（再作成するケース）

-- INCLUDE: 特定のオブジェクトだけをエクスポートする
-- INCLUDE=TABLE:"IN ('EMPLOYEES','DEPARTMENTS')"
-- INCLUDE=PROCEDURE
-- INCLUDE=TABLE,INDEX  -- テーブルとインデックスのみ

-- CONTENT: エクスポートする内容を選択する
-- CONTENT=ALL          -- データとメタデータ（デフォルト）
-- CONTENT=DATA_ONLY    -- データのみ（DDLなし）
-- CONTENT=METADATA_ONLY -- 定義のみ（データなし）

# 同じスキーマ名でインポート（最もシンプル）
impdp hr/hr_password@localhost:1521/orcl_dev   SCHEMAS=hr   DIRECTORY=dp_dir   DUMPFILE=hr_schema.dmp   LOGFILE=hr_import.log

# スキーマ名を変えてインポート（本番 hr → 開発 hr_dev）
impdp system/password@orcl_dev   REMAP_SCHEMA=hr:hr_dev   DIRECTORY=dp_dir   DUMPFILE=hr_schema.dmp   LOGFILE=hr_import_remap.log

# 表領域名も変えてインポート（本番 USERS → 開発 USERS_DEV）
impdp system/password@orcl_dev   REMAP_SCHEMA=hr:hr_dev   REMAP_TABLESPACE=USERS:USERS_DEV,INDX:INDX_DEV   DIRECTORY=dp_dir   DUMPFILE=hr_schema.dmp   LOGFILE=hr_import_remap.log

# テーブル単位でインポート
impdp hr/hr_password@orcl_dev   TABLES=hr.employees   DIRECTORY=dp_dir   DUMPFILE=emp_dept.dmp   TABLE_EXISTS_ACTION=REPLACE   LOGFILE=emp_import.log

# フルインポート（新規 DB へのリストア）
impdp system/password@new_orcl   FULL=y   DIRECTORY=dp_dir   DUMPFILE=full_%U.dmp   PARALLEL=8   LOGFILE=full_import.log

-- TABLE_EXISTS_ACTION: インポート先にテーブルが存在する場合の動作
-- SKIP    : 既存テーブルをスキップ（デフォルト。データを追加しない）
-- APPEND  : 既存テーブルにデータを追記する（制約チェックあり）
-- TRUNCATE: 既存テーブルを TRUNCATE してからインポート（注意: TRUNCATE は ROLLBACK 不可）
-- REPLACE : 既存テーブルを DROP して再作成してインポート

-- TRANSFORM: インポート時に DDL を変換する
-- TRANSFORM=SEGMENT_ATTRIBUTES:N    -- ストレージ句・表領域指定を除去（REMAP_TABLESPACE と競合する場合に使う）
-- TRANSFORM=OID:N                   -- Object ID を再生成する（オブジェクト型・XMLType 使用時）

-- SQLFILE: 実際にインポートせず、実行される DDL を SQL ファイルに出力する（ドライラン）
-- impdp system/password@orcl DIRECTORY=dp_dir DUMPFILE=hr.dmp SQLFILE=dp_dir:hr_ddl.sql

-- EXCLUDE=STATISTICS: インポート後に DBMS_STATS で統計を収集するためエクスポートデータの統計を無視する
-- （インポート完了後: EXEC DBMS_STATS.GATHER_SCHEMA_STATS('HR'); で最新統計を収集）

-- 転送先 DB（import を実行する DB）側で DB Link を作成する
CREATE DATABASE LINK prod_link
CONNECT TO hr IDENTIFIED BY hr_password
USING 'prod_db';  -- tnsnames.ora のエントリ名または Easy Connect 文字列

-- DB Link の接続テスト
SELECT * FROM dual@prod_link;

-- NETWORK_LINK を使ったインポート（転送先 DB で実行）
-- ※ expdp/impdp ではなく impdp に NETWORK_LINK を指定する
-- コマンドライン:
-- impdp hr/hr_password@dev_db --   SCHEMAS=hr --   NETWORK_LINK=prod_link --   REMAP_SCHEMA=hr:hr_dev --   DIRECTORY=dp_dir --   LOGFILE=network_import.log
-- ※ NETWORK_LINK 使用時は DUMPFILE が不要（直接転送）
-- ※ 転送元（prod_db）に DATAPUMP_EXP_FULL_DATABASE 権限またはスキーマ権限が必要

-- DBMS_DATAPUMP を使って PL/SQL からジョブを制御する場合の例
DECLARE
    h NUMBER;
BEGIN
    h := DBMS_DATAPUMP.OPEN(
        operation   => 'EXPORT',
        job_mode    => 'SCHEMA',
        job_name    => 'HR_EXPORT_JOB',
        remote_link => NULL,
        version     => 'COMPATIBLE'
    );
    DBMS_DATAPUMP.ADD_FILE(h, 'hr_export.dmp', 'DP_DIR');
    DBMS_DATAPUMP.ADD_FILE(h, 'hr_export.log', 'DP_DIR', filetype => DBMS_DATAPUMP.KU$_FILE_TYPE_LOG_FILE);
    DBMS_DATAPUMP.METADATA_FILTER(h, 'SCHEMA_EXPR', 'IN (''HR'')');
    DBMS_DATAPUMP.START_JOB(h);
    DBMS_DATAPUMP.DETACH(h);   -- バックグラウンドで実行してデタッチ
END;
/

-- 実行中の Data Pump ジョブを確認する
SELECT job_name, operation, job_mode, state, degree, attached_sessions
FROM DBA_DATAPUMP_JOBS
WHERE state = 'EXECUTING';

-- 進捗を確認する（V$SESSION_LONGOPS）
SELECT sid, serial#, opname, sofar, totalwork,
       ROUND(sofar / NULLIF(totalwork, 0) * 100, 1) AS pct_done,
       elapsed_seconds, time_remaining
FROM V$SESSION_LONGOPS
WHERE opname LIKE 'Data Pump%'
  AND totalwork > 0
ORDER BY start_time DESC;

-- 実行中ジョブに対話的に接続する（別ターミナルから）
-- expdp attach=<job_name>
-- 接続後の操作:
--   STATUS   : 現在の進捗を表示
--   PARALLEL=8 : 並列度を変更する（実行中に変更可能）
--   KILL_JOB : ジョブを強制終了してダンプファイルを削除する
--   STOP_JOB : ジョブを停止する（後で再開可能）
--   START_JOB: 停止したジョブを再開する
--   EXIT_CLIENT: Data Pump インターフェースを抜ける（ジョブはバックグラウンドで継続）

-- 残ったジョブメタデータをクリーンアップする（失敗後など）
DROP TABLE hr.SYS_EXPORT_SCHEMA_01 PURGE;  -- ジョブ制御テーブルの削除
-- ※ テーブル名は DBA_DATAPUMP_JOBS.job_name に対応する