RDS Data Pumpのエラー切り分けと対処法

目次
  1. 結論:原因の大半は「ダンプファイルの置き場所」と DIRECTORY オブジェクト
  2. 原因を切り分ける手順(確認しやすい順)
  3. エラーメッセージ別の対処
  4. 失敗を減らす実行方法とオプション設定
  5. よくある質問
  6. 再発防止:移行前チェックリストと運用ルール
このテーマのまとめOracle運用トラブル症状別ガイド|遅い・止まった・接続不可このテーマのまとめAurora・RDSが遅い・接続が切れる原因をどこから調べるか
本記事にはプロモーション(広告)が含まれています。

Amazon RDS for OracleでData Pumpを実行すると、オンプレのOracleでは見かけない形でエラーが出ます。典型はORA-39002: 操作が無効ですの一行だけが返り、何が悪いのか分からないまま止まるパターンです。原因の多くはData Pump本体にありません。OSにログインできない環境でダンプファイルをどこに置き、どう受け渡すかというRDS固有の制約に起因します。エラーコードから原因を特定する順序を、確認用のSQLとあわせて整理します。

結論:原因の大半は「ダンプファイルの置き場所」と DIRECTORY オブジェクト

RDS for Oracleには次の制約があります。通常のOracleとの差分であり、エラーの発生源です。

  • OSにログインできないため、/u01/app/...のような任意パスにDIRECTORYオブジェクトを作れません。ダンプファイルはDATA_PUMP_DIRおよびRDSのAPIで作成したディレクトリ配下にしか置けません
  • ファイルの出し入れはSQL経由です。S3連携(rdsadmin.rdsadmin_s3_tasks)か、DBMS_FILE_TRANSFERとDBリンクのどちらかを使います
  • ダンプファイルはDBインスタンスの割り当てストレージを消費します。データファイルと同じボリュームなので、エクスポート中にFreeStorageSpaceが減ります
  • マスターユーザーはSYSDBA権限を持ちません。SYS配下のオブジェクトや一部のディクショナリ操作は実行できません

もう一点、ORA-39002は単独では意味を持たないラッパーエラーです。実際の原因は2行目以降(ORA-39070、ORA-29283、ORA-39087など)に出ます。クライアントが1行目しか表示していないなら、まずスタック全体を取得してください。

原因を切り分ける手順(確認しやすい順)

切り分けは次の順で進めると手戻りが少なくなります。

  1. DIRECTORYオブジェクトの存在とファイルの実在を確認する(SQLだけで完結)
  2. S3連携を使っている場合は転送タスクのログを読み、ファイルが届いたか確定させる
  3. 実行ユーザーのロールと権限を確認する
  4. ストレージと表領域の空きを確認する

1と2で大半が決まります。3と4から調査に入ると、「権限を追加したのに直らない」という無駄な往復が発生します。

DATA_PUMP_DIR の中身と空き容量を SQL で確認する

まずDIRECTORYオブジェクトの一覧です。

SELECT owner, directory_name, directory_path
FROM   dba_directories
ORDER  BY directory_name;

DATA_PUMP_DIRが存在し、パスがRDS管理のディレクトリになっているか確認します。自分で作ったはずのディレクトリが無ければ、impdpのDIRECTORY=指定が違うか、作成そのものに失敗しています。

次にディレクトリの中身を一覧します。OSのlsが使えないので専用のファンクションを使います。

SELECT filename, type, filesize, mtime
FROM   TABLE(rdsadmin.rds_file_util.listdir(p_directory => 'DATA_PUMP_DIR'))
ORDER  BY mtime DESC;

確認するのは3点です。

  • 想定したダンプファイル名が一字一句一致しているか。.dmpの付け忘れ、大文字小文字、%U展開後の連番に注意します
  • filesizeが0でないか。0バイトならS3からの転送が途中で失敗しています
  • 古いダンプファイルが残っていないか。残骸がストレージを圧迫している例が多いです

合計使用量はこう出せます。

SELECT ROUND(SUM(filesize)/1024/1024/1024, 2) AS used_gb
FROM   TABLE(rdsadmin.rds_file_util.listdir(p_directory => 'DATA_PUMP_DIR'));

インスタンスの空き容量はSQLから見えないため、CloudWatchのFreeStorageSpaceメトリクスで確認します。エクスポート前に「ダンプファイルの推定サイズ < 空き容量」が成り立つか見ておけば、ORA-39171や領域系エラーを避けられます。推定サイズはESTIMATE_ONLY=YESで先に出せます。

S3 連携タスクのログを読んで転送の成否を確定させる

S3からダンプファイルを取り込むときは、download_from_s3が返すタスクIDを必ず保持します。

SELECT rdsadmin.rdsadmin_s3_tasks.download_from_s3(
         p_bucket_name    => 'my-migration-bucket',
         p_s3_prefix      => 'dumps/scott_schema.dmp',
         p_directory_name => 'DATA_PUMP_DIR') AS task_id
FROM   dual;

このファンクションはダウンロードの完了を待たずに即座に戻ります。戻り値はタスクIDなので、成否はログで確認します。

SELECT text
FROM   TABLE(rdsadmin.rds_file_util.read_text_file(
               p_directory => 'BDUMP',
               p_filename  => 'dbtask-1234567890123-456.log'))
ORDER  BY 1;

ファイル名はdbtask-<task_id>.logです。ログで見るべき箇所は次のとおりです。

  • TASK_COMPLETEDやSUCCESSで終わっているか。IN_PROGRESSのままならまだ転送中です。数十GBなら数分以上かかります
  • Access Denied系はIAMロールの権限不足、またはオプショングループへのS3_INTEGRATION追加漏れです。ロールには対象バケットへのs3:GetObjectとs3:ListBucket、アップロード時はs3:PutObjectが必要です
  • does not exist系はバケット名かp_s3_prefixの誤りです。p_s3_prefixは前方一致のキーで、ディレクトリ名ではありません。dumps/と指定すればその配下すべてが対象になります
  • downloaded 0 filesはプレフィックスに一致するオブジェクトが無い状態です

S3連携には、バケットとDBインスタンスのリージョン、KMS暗号化オブジェクトの扱いなどの条件があります。構成を決める前にAWSの公式ドキュメントで現行の要件を確認してください。

エラーメッセージ別の対処

ORA-39002 / ORA-39070 / LRM-00109:ディレクトリ指定とパスの誤り

エラー 読み替え 主な対処
ORA-39002: 操作が無効です 後続行に本当の原因がある スタック全体を取得する
ORA-39070: ログ・ファイルをオープンできません ディレクトリに書けない DIRECTORY= の名前、NOLOGFILE=YES で切り分け
ORA-39087: ディレクトリ名〜は無効です DIRECTORY オブジェクトが無い/権限が無い dba_directories 確認、GRANT READ, WRITE ON DIRECTORY
ORA-29283: ファイル操作が無効です ファイルが存在しない/パス不正 listdir でファイル名を実地確認
LRM-00109: パラメータ・ファイルをオープンできませんでした クライアント側の parfile パス誤り ローカルの parfile のパスを修正

LRM-00109はクライアントPCでPARFILE=に指定したファイルが見つからないという意味で、RDS側とは無関係です。ここを混同すると調査が迷走します。

ORA-39070が出たら、まずNOLOGFILE=YESを付けて再実行してください。これで通るならログファイルの書き込みだけの問題、依然失敗するならディレクトリへのアクセス権の問題だと切り分けられます。

RDSではDIRECTORY=にDATA_PUMP_DIR以外を指定する場合、そのディレクトリをRDSの管理APIで作成しておく必要があります。パスを直書きしたDIRECTORYは作れません。

ORA-31631 / ORA-01031 / ORA-39083:権限と SYS 配下オブジェクトの制約

ORA-31631: 権限が必要ですは、Data Pumpのモードに対してロールが足りていないときに出ます。まず実行ユーザーの保有ロールを確認します。

SELECT granted_role FROM user_role_privs;
SELECT * FROM session_roles WHERE role LIKE 'DATAPUMP%';
  • FULL=YES(フルエクスポート/インポート)にはDATAPUMP_EXP_FULL_DATABASEまたはDATAPUMP_IMP_FULL_DATABASEが必要
  • 自分以外のスキーマをSCHEMAS=で指定する場合、REMAP_SCHEMAでスキーマを付け替える場合も同じロールが必要

マスターユーザーにはDBA相当の権限がまとめて付与されますが、SYSDBAではなく一部の権限は意図的に除外されています。オンプレのSYSで動いていた手順をそのまま持ち込むと失敗します。RDSでは原則としてフルモードを避け、スキーマ単位(SCHEMAS=)またはテーブル単位に分解するのが安全です。

ORA-39083: オブジェクト・タイプ 〜 の作成が失敗しましたは、インポート処理の中で個別オブジェクトのDDLがエラーになったことを示します。見るべきは、後に続く本当の原因エラーです。

  • ORA-01917: ユーザーまたはロール〜は存在しません → 先にユーザーやロールを作る。EXCLUDE=USERを使う場合はターゲットでの事前作成が前提
  • ORA-01918: ユーザー〜は存在しません → REMAP_SCHEMAの指定ミス
  • ORA-00959: 表領域〜は存在しません → 後述のREMAP_TABLESPACE
  • ORA-01031: 権限が不足しています → SYS所有オブジェクトや、RDSで許可されていないDDL(一部のディレクトリ操作、OS依存機能など)

SYSやRDSADMIN配下のオブジェクト、監査設定、OS依存のライブラリはRDSに持ち込めません。EXCLUDEで除外するか、移行対象から外して設計し直します。ORAエラーの読み方そのものに不安がある場合は、Oracle運用トラブル症状別ガイド|遅い・止まった・接続不可 の切り分けの考え方が参考になります。

ORA-39095 / ORA-00959 / ORA-01658:領域と表領域の不足

ORA-39095: ダンプ・ファイルの領域が不足していますは、ダンプファイルの書き込み先が足りないという意味で、原因は2パターンあります。

  1. FILESIZE=を小さく指定したのに、ダンプファイル名に%Uを付けていない(1ファイルしか作れない)
  2. PARALLEL=nに対してダンプファイルの枠がn個未満

%Uを使えばData Pumpがexp_01.dmp、exp_02.dmpと自動で増やします。

expdp admin@rds-endpoint:1521/ORCL \
  SCHEMAS=SCOTT \
  DIRECTORY=DATA_PUMP_DIR \
  DUMPFILE=scott_%U.dmp \
  FILESIZE=5G \
  PARALLEL=4 \
  LOGFILE=scott_exp.log

ORA-00959: 表領域〜は存在しませんは、ソース側の表領域名がターゲットのRDSに無いケースです。REMAP_TABLESPACEで寄せるか、先に表領域を作ります。RDSではデータファイルのパスを指定できないため、サイズだけを書きます。

CREATE BIGFILE TABLESPACE tbs_app
  DATAFILE SIZE 100G AUTOEXTEND ON NEXT 1G MAXSIZE UNLIMITED;
impdp ... REMAP_TABLESPACE=USERS_OLD:USERS,TBS_IDX:TBS_APP

ORA-01658: 表領域〜のセグメントにINITIALエクステントを作成できませんは、表領域の空きが無い、またはAUTOEXTEND OFFやMAXSIZE到達です。現状を確認します。

SELECT tablespace_name, file_name, bytes/1024/1024 AS mb,
       autoextensible, maxbytes/1024/1024 AS max_mb
FROM   dba_data_files
ORDER  BY tablespace_name;

見落としやすいのは、表領域に空きを足してもインスタンスのストレージが足りなければ拡張できないという二段構えの制約です。ダンプファイル、データファイル、一時表領域、アーカイブログがすべて同じ割り当てストレージを分け合います。インポート直前にFreeStorageSpaceを確認し、必要ならストレージを拡張するかストレージ自動スケーリングを有効化しておきます。インポート完了後にダンプファイルを削除すれば領域は戻りますが、RDSのストレージ自体は縮小できません。

この記事のテーマをさらに学べる本

Oracleの全体像や構成要素を図解で俯瞰できる第6版で、切り分けの前提知識の整理に使えます。

楽天ブックスで詳しく見る Yahoo!ショッピングで見る

失敗を減らす実行方法とオプション設定

クライアントのexpdpやimpdpが使えない環境では、SQLだけで完結するDBMS_DATAPUMPを使います。RDSでも問題なく動きます。

DECLARE
  h NUMBER;
BEGIN
  h := DBMS_DATAPUMP.OPEN(
         operation => 'EXPORT',
         job_mode  => 'SCHEMA',
         job_name  => 'EXP_SCOTT_01',
         version   => 'COMPATIBLE');

  DBMS_DATAPUMP.ADD_FILE(h, 'scott_%U.dmp', 'DATA_PUMP_DIR',
                         5368709120, DBMS_DATAPUMP.KU$_FILE_TYPE_DUMP_FILE);
  DBMS_DATAPUMP.ADD_FILE(h, 'scott_exp.log', 'DATA_PUMP_DIR',
                         NULL, DBMS_DATAPUMP.KU$_FILE_TYPE_LOG_FILE);

  DBMS_DATAPUMP.METADATA_FILTER(h, 'SCHEMA_EXPR', 'IN (''SCOTT'')');
  DBMS_DATAPUMP.SET_PARALLEL(h, 4);
  DBMS_DATAPUMP.START_JOB(h);
  DBMS_DATAPUMP.DETACH(h);
END;
/

ジョブの進行状況は以下で追えます。DETACH後も処理は継続します。

SELECT owner_name, job_name, operation, job_mode, state, degree
FROM   dba_datapump_jobs;

設定のうち効果が大きいものを挙げます。LOGTIME=ALL METRICS=YESを付けると各フェーズの開始終了時刻と件数がログに出て、どこで止まったか一目で分かります。統計情報のエクスポートは重いのでEXCLUDE=STATISTICSで外し、移行後にDBMS_STATSで再収集した方が確実です。ターゲットが下位バージョンならVERSION=の指定が必須で、未指定だとORA-39142(ダンプファイルのバージョン不一致)になります。再実行時のORA-31641(既存ファイルがありダンプファイルを作成できない)はREUSE_DUMPFILES=YESで回避できます。PARALLELはインスタンスのvCPU数とストレージ性能に見合う値にしてください。むやみに上げるとI/O待ちで逆に遅くなります。COMPRESSIONはAdvanced Compression Optionのライセンスが絡むため、利用条件を確認してから使います。

スキーマ単位で分割し、1本ずつ流すと、失敗時の切り戻しとリトライが格段に楽になります。

よくある質問

クライアント PC から expdp / impdp を直接実行できる?

できます。Oracle Client(Instant ClientのToolsパッケージなど)を入れた端末から、RDSのエンドポイントに接続して実行可能です。注意点が2つあります。

  1. ダンプファイルはRDS側のストレージに書かれます。手元のPCには出力されないため、回収にはupload_to_s3でS3に上げる必要があります
  2. ネットワーク到達性が前提です。セキュリティグループ、サブネットのルーティング、DNS解決が通っていないとORA-12170(TNSタイムアウト)になります。接続自体が通らない場合の切り分けは Oracle Database@AWSに接続できない原因と対処 と同じ考え方で進められます

DATA_PUMP_DIR に残ったダンプファイルは削除できる?

UTL_FILE.FREMOVEで削除できます。

BEGIN
  UTL_FILE.FREMOVE('DATA_PUMP_DIR', 'scott_01.dmp');
END;
/

削除前にlistdirでファイル名を正確に確認してください。インポート成功後の放置が、次回の移行時の領域不足の主因になります。移行手順書に「ダンプ削除」を独立したステップとして入れておくと確実です。

ネットワーク経由のインポート(NETWORK_LINK)と S3 経由はどちらが速い?

一概には言えませんが、判断基準は次のとおりです。NETWORK_LINKはダンプファイルを一切作らないため、ストレージを追加で消費しません。小〜中規模で、ソースとターゲットの間に十分な帯域があれば有利です。ただしDBリンク経由のため、ネットワークが不安定だと長時間ジョブが途中で失敗するリスクがあります。LOBが多いデータでは遅くなりやすい点も注意してください。S3経由はダンプファイルという中間成果物が残るので、失敗しても再インポートからやり直せます。大規模データや、ソース側のメンテナンス窓が短いケースに向く一方、ストレージの空きが必要です。

やり直せることを重視するならS3経由、ストレージを増やしたくない規模や一発で終わる規模ならNETWORK_LINKという使い分けが現実的です。

再発防止:移行前チェックリストと運用ルール

実行前に以下を確認しておけば、ここで挙げたエラーのほとんどは事前に防げます。

  • ESTIMATE_ONLY=YESでダンプサイズを見積もり、CloudWatchのFreeStorageSpaceと比較した
  • DATA_PUMP_DIRに古いダンプファイルが残っていないかlistdirで確認した
  • ソース側の表領域名を一覧し、ターゲットに存在するか/REMAP_TABLESPACEが必要か確認した
  • 実行ユーザーのロール(DATAPUMP_*_FULL_DATABASE)をuser_role_privsで確認した
  • フルモードを使わずスキーマ単位に分割した
  • ソースとターゲットのバージョンを確認し、必要ならVERSION=を指定した
  • S3連携を使う場合、オプショングループのS3_INTEGRATIONとIAMロールの権限を確認した
  • LOGTIME=ALL METRICS=YESを付け、ログの保存先と回収方法を決めた

運用ルールは3点を手順書に明記しておきます。ダンプファイルは用が済んだら即削除する。タスクIDとログファイル名を作業記録に残す。本番前にステージング環境で同じ手順を通す。これだけで同じ調査の繰り返しを避けられます。異種DBへの移行まで視野に入れている場合は、Data Pumpでは移せない要素(PL/SQL、型の挙動差)が別の論点として出てきます。Oracle PostgreSQL移行の注意点|症状別の切り分けと対処 もあわせて確認すると、移行方式の検討段階で手戻りを減らせます。

なお、ここで触れたRDSのAPI名、オプション要件、サポートされる操作はバージョンやエンジン更新で変わることがあります。実行前に必ずAWSの公式ドキュメントで現行仕様を確認してください。