0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

RDS for OracleのData Pumpでエラーが出たときの切り分け順序

0
Posted at

Amazon RDS for OracleでData Pumpを動かすと、ORA-39002: 操作が無効ですの一行だけが返って止まることがあります。オンプレのOracleで同じ手順が通っていたのに原因が見えない、という状況です。つまずきの多くはData Pump本体ではなく、OSにログインできない環境でダンプファイルをどこに置き、どう受け渡すかというRDS固有の制約から来ています。

この記事は要約版です。エラーコード別の読み替え表と対処手順、S3連携タスクのログ確認方法、DBMS_DATAPUMPでの実行例、移行前チェックリストは、ブログの完全版にまとめています: RDS Data Pumpのエラー切り分けと対処法

結論:疑うのはダンプファイルの置き場所とDIRECTORYオブジェクト

RDS for Oracleには、通常のOracleと異なる前提が4つあります。任意パスにDIRECTORYオブジェクトを作れないため、ダンプファイルはDATA_PUMP_DIRやRDSのAPIで作成したディレクトリ配下にしか置けません。ファイルの出し入れはS3連携(rdsadmin.rdsadmin_s3_tasks)かDBMS_FILE_TRANSFERとDBリンクを使います。ダンプファイルはデータファイルと同じ割り当てストレージを消費するので、エクスポート中にFreeStorageSpaceが減っていきます。さらにマスターユーザーはSYSDBA権限を持たず、SYS配下のオブジェクト操作は実行できません。

もうひとつ押さえておきたいのが、ORA-39002は単独では意味を持たないラッパーエラーだという点です。本当の原因は2行目以降のORA-39070やORA-29283、ORA-39087に出ます。クライアントが1行目しか表示していないなら、まずスタック全体を取得してください。

切り分けはDIRECTORYオブジェクトの存在とファイルの実在確認から始め、次にS3転送タスクのログを読みます。ここまでで大半の原因が確定します。実行ユーザーのロール確認とストレージ・表領域の空き確認は3番目と4番目です。権限から調査を始めると、権限を追加しても直らないという往復が発生します。

まず実行する1本

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からの転送が途中で失敗)、古いダンプファイルが残ってストレージを圧迫していないか。

完全版で扱っている内容

  • S3連携タスクのログ確認手順。download_from_s3が返すタスクIDからdbtask-<task_id>.logをread_text_fileで読み、TASK_COMPLETEDやAccess Denied、downloaded 0 filesをどう解釈するか
  • エラーメッセージ別の対処。ORA-39070 ORA-39087 ORA-29283 LRM-00109の読み替え表、NOLOGFILE=YESを使った切り分け、ORA-31631での権限確認SQL、ORA-39083の下に隠れる本当の原因エラーの読み方
  • 領域系エラーの解消。ORA-39095が出る2つのパターンと%U付きのexpdp実行例、REMAP_TABLESPACEとRDSでのCREATE BIGFILE TABLESPACEの書き方、ORA-01658の確認SQL
  • DBMS_DATAPUMPによるSQLだけのエクスポート例とdba_datapump_jobsでの進行確認。LOGTIME=ALL METRICS=YESやEXCLUDE=STATISTICS、VERSION=、REUSE_DUMPFILES=YESの使いどころ
  • よくある質問と再発防止。クライアントPCからのexpdp実行時の注意、UTL_FILE.FREMOVEでのダンプ削除、NETWORK_LINKとS3経由の使い分け、移行前チェックリスト8項目と運用ルール

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

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

0
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?