Amazon RDS for OracleでData Pumpのインポートが失敗すると、まず権限を疑いたくなります。IAMロールにポリシーを足し、実行ユーザーにロールを付与し、それでも同じエラーが出る。この往復に半日使ってしまうパターンは珍しくありません。実際には、ダンプファイルがDBインスタンス側に届いていない、あるいはファイル名が違うだけ、という場面が多くを占めます。OSにログインしてlsを打てない環境では、ファイルの実在をSQLで確かめる手順を先に固めておくと調査が速くなります。
この記事は「RDS Data Pumpのエラー切り分けと対処法」の一部を、話題を絞って書き直したものです。ORA番号ごとの対処や、失敗を減らすimpdpのオプション設定、移行前のチェックリストは、ブログの完全版にまとめています: RDS Data Pumpのエラー切り分けと対処法
確認しやすい順に並べ替える
切り分けは次の順で進めてください。最初にDIRECTORYオブジェクトの存在とファイルの実在を確認します。これはSQLだけで完結します。次にS3連携を使っているなら、転送タスクのログを読み、ファイルが届いたかどうかを確定させます。そのうえで実行ユーザーのロールと権限を見て、最後にストレージと表領域の空きを確認します。
この順番には理由があります。1番目と2番目で原因の大半が決まるためです。権限やストレージから調査に入ると、「権限を追加したのに直らない」という無駄な往復が発生します。
ファイルの実在と容量をSQLで確かめる
最初にdba_directoriesを参照し、DATA_PUMP_DIRが存在してパスがRDS管理のディレクトリになっているか見ます。自分で作ったはずのディレクトリが見当たらない場合は、impdpのDIRECTORY=指定が違うか、ディレクトリの作成そのものが失敗しています。
続いてディレクトリの中身を一覧します。OSのlsが使えないため、RDS専用のファンクションを使います。
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からの転送が途中で失敗しています。最後に古いダンプファイルの残骸を確認します。残骸がストレージを圧迫している例が多いです。
インスタンスの空き容量はSQLから参照できないため、CloudWatchのFreeStorageSpaceメトリクスで確認します。エクスポート前に「ダンプファイルの推定サイズ < 空き容量」が成り立つか見ておけば、ORA-39171や領域系のエラーを避けられます。推定サイズはESTIMATE_ONLY=YESで先に出せます。
S3連携タスクのログで転送の成否を確定させる
rdsadmin.rdsadmin_s3_tasks.download_from_s3は、ダウンロードの完了を待たずに即座に戻ります。戻り値はタスクIDなので、成否はログで確認してください。タスク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は、プレフィックスに一致するオブジェクトが1件もない状態を表します。
S3連携には、バケットとDBインスタンスのリージョンや、KMSで暗号化したオブジェクトの扱いといった条件があります。構成を決める前にAWSの公式ドキュメントで現行の要件を確認してください。
元記事で扱っている内容
-
ORA-39001やORA-39002、ORA-31640などエラーメッセージ別の読み方と対処 - 原因の大半を占める「ダンプファイルの置き場所」とDIRECTORYオブジェクトの関係
- 失敗を減らすためのimpdp実行方法とオプション設定
- 移行前チェックリストと、再発を防ぐための運用ルール
- RDS特有の制約についてのよくある質問