【Oracle】Data Pump ジョブの一時停止・再開・強制停止｜attach・STOP_JOB・KILL_JOB・残存ジョブのクリーンアップまで解説

# ジョブ名を指定してエクスポート
expdp hr/password \
    directory=DP_DIR \
    dumpfile=hr_export_%U.dmp \
    logfile=hr_export.log \
    schemas=HR \
    parallel=4 \
    job_name=HR_DAILY_EXPORT

# ジョブ名を指定してインポート
impdp hr/password \
    directory=DP_DIR \
    dumpfile=hr_export_%U.dmp \
    logfile=hr_import.log \
    schemas=HR \
    job_name=HR_DAILY_IMPORT

# ジョブ名を指定して接続
expdp hr/password attach=HR_DAILY_EXPORT

# impdp ジョブの場合
impdp hr/password attach=HR_DAILY_IMPORT

# ジョブ名がわからない場合: DBA_DATAPUMP_JOBS で確認してから接続
expdp hr/password attach=SYS_EXPORT_SCHEMA_01

-- Data Pump ジョブの一覧
SELECT owner_name, job_name, operation, job_mode,
       state, degree, attached_sessions
FROM dba_datapump_jobs
WHERE state <> 'NOT RUNNING'
ORDER BY owner_name;

-- state の値:
-- EXECUTING:   実行中
-- NOT RUNNING: 停止中（STOP_JOB で停止 / 完了）
-- DEFINING:    定義中
-- IDLING:      アイドル

# (1) 実行中のジョブに接続
expdp hr/password attach=HR_DAILY_EXPORT

# (2) 対話モードで一時停止
Export> STOP_JOB
Are you sure you wish to stop this job ([yes]/no): yes
# ワーカーが安全に停止するまで少し時間がかかる

# (3) ターミナルを閉じても OK（ジョブは停止状態で保持される）

# (4) 後日、再接続して再開
expdp hr/password attach=HR_DAILY_EXPORT
Export> START_JOB
# ジョブが停止した位置から再開される

# 通常の STOP_JOB はワーカーが現在の処理を完了するまで待つ
# IMMEDIATE は現在のブロックで即座に中断
Export> STOP_JOB=IMMEDIATE

# STOP_JOB と STOP_JOB=IMMEDIATE の違い:
# STOP_JOB:           現在のテーブル/行の処理完了を待つ（安全）
# STOP_JOB=IMMEDIATE: 即座に停止（数秒以内に止まる）
# どちらも再開可能

# ジョブに接続
expdp hr/password attach=HR_DAILY_EXPORT

# 強制終了
Export> KILL_JOB
Are you sure you wish to stop this job ([yes]/no): yes
# ジョブが即座に終了し、ワーカープロセスが削除される

# ターミナルが切断された後...

# (1) ジョブが動いているか確認
sqlplus / as sysdba
SQL> SELECT job_name, state FROM dba_datapump_jobs;
-- HR_DAILY_EXPORT  EXECUTING  ← まだ動いている

# (2) attach で再接続
expdp hr/password attach=HR_DAILY_EXPORT

# (3) 進捗確認
Export> STATUS

# 接続後に進捗を 1 回表示
Export> STATUS

# 30 秒ごとに自動表示
Export> STATUS=30

# 出力例:
# Worker 1 Status:
#   Process Name:  DW00
#   State:         EXECUTING
#   Object Schema: HR
#   Object Name:   EMPLOYEES
#   Object Type:   TABLE_DATA
#   Completed Objects:  15
#   Total Objects:      42
#   Completed Rows:     1,234,567
#   Worker Parallelism: 4

# 接続後にパラレル度を変更
Export> PARALLEL=8
# ワーカー数が即座に 8 に増加

Export> PARALLEL=2
# ワーカー数を 2 に縮小（負荷を下げたい場合）

-- NOT RUNNING のジョブ（終了済み / 異常終了）を確認
SELECT owner_name, job_name, operation, job_mode, state
FROM dba_datapump_jobs
ORDER BY state, owner_name;

-- state = NOT RUNNING で attached_sessions = 0 のジョブがゴミ

-- 方法(1): attach して KILL_JOB
-- expdp hr/password attach=SYS_EXPORT_SCHEMA_01
-- Export> KILL_JOB

-- 方法(2): マスターテーブルを直接 DROP（attach できない場合）
-- マスターテーブル名 = ジョブ名と同じ
DROP TABLE hr.SYS_EXPORT_SCHEMA_01 PURGE;

-- 方法(3): DBMS_DATAPUMP で強制削除（11g+）
BEGIN
    DBMS_DATAPUMP.DETACH('SYS_EXPORT_SCHEMA_01');
    DBMS_DATAPUMP.STOP_JOB('SYS_EXPORT_SCHEMA_01', 1, 0);
EXCEPTION WHEN OTHERS THEN
    NULL;
END;
/
DROP TABLE hr.SYS_EXPORT_SCHEMA_01 PURGE;

# 夜間バッチで parallel=8 でエクスポート開始
expdp system/password \
    directory=DP_DIR \
    dumpfile=nightly_%U.dmp \
    full=y parallel=8 \
    job_name=NIGHTLY_EXPORT

# 朝になって業務開始 → 負荷を下げたい
# 別ターミナルで:
expdp system/password attach=NIGHTLY_EXPORT
Export> PARALLEL=2
# → ワーカーを 8 → 2 に縮小して負荷を軽減

# さらに負荷が厳しければ一時停止
Export> STOP_JOB
# → 昼休みに再開
Export> START_JOB

# SSH が切断された...

# 再接続後:
# (1) ジョブが動いているか確認
sqlplus / as sysdba <<EOF
SELECT job_name, state FROM dba_datapump_jobs;
EOF

# (2) attach で復帰
expdp system/password attach=NIGHTLY_EXPORT
Export> STATUS
# → 進捗を確認。問題なければそのまま EXIT_CLIENT

# ジョブがエラーで EXECUTING のまま止まらない
expdp system/password attach=STUCK_JOB

# まず STOP_JOB を試す
Export> STOP_JOB=IMMEDIATE

# 止まらない場合は KILL_JOB
Export> KILL_JOB

# それでも DBA_DATAPUMP_JOBS に残る場合
# マスターテーブルを直接 DROP
-- DROP TABLE hr.STUCK_JOB PURGE;