4 データ・ポンプのレガシー・モード
データ・ポンプのレガシー・モードでは、オリジナルのエクスポート・パラメータおよびインポート・パラメータを、データ・ポンプ・エクスポートおよびデータ・ポンプ・インポートのコマンドラインで使用できます。
オリジナルのエクスポート(exp)およびインポート(imp)を使用している場合は、長年使用してきたスクリプトが存在することがあります。データ・ポンプでは、データ・ポンプで既存のスクリプトを引き続き使用できるレガシー・モードが提供されるようになりました。
コマンドラインまたはスクリプトのいずれかにオリジナルのエクスポートまたはインポートに特有のパラメータが存在するとデータ・ポンプで判断されると、データ・ポンプはレガシー・モードに入ります。そのパラメータがデータ・ポンプで処理されると、データ・ポンプ・エクスポートまたはデータ・ポンプ・インポートと同等のパラメータが表示されます。新しい構文を確認し、時間があるときにスクリプトを変更することをお薦めします。
ノート:
データ・ポンプ・エクスポートおよびデータ・ポンプ・インポート・ユーティリティでは、データ・ポンプ形式のダンプ・ファイルとログ・ファイルのみ、作成および読取りが実行されます。オリジナルのエクスポートやインポートと互換性のあるダンプ・ファイルが作成されたり、読み込まれることはありません。オリジナルのエクスポートで作成されたダンプ・ファイルがある場合は、オリジナルのインポートを使用してデータベースにデータをインポートする必要があります。
- パラメータのマッピング
この項では、パラメータのマッピングについて説明します。 - データ・ポンプ・レガシー・モードでのファイルの場所の管理
オリジナルのバージョンはクライアントベース、データ・ポンプはサーバーベースであるため、オリジナルのエクスポートとインポート、およびデータ・ポンプ・エクスポートとデータ・ポンプ・インポートは、ダンプ・ファイルとログ・ファイルの書込み/読取りを行える場所によって異なります。 - データ・ポンプのログ・ファイルとエラーに対する既存のスクリプトの調整
この項では、データ・ポンプのログ・ファイルとエラーに対して既存のスクリプトを調整する方法について説明します。
親トピック: Oracle Data Pump
4.1 パラメータのマッピング
この項では、パラメータのマッピングについて説明します。
この項では、オリジナルのエクスポートおよびインポートのパラメータと、同様の機能を持つデータ・ポンプ・エクスポートおよびデータ・ポンプ・インポートのパラメータとのマッピング関係について説明します。
- データ・ポンプでのオリジナルのエクスポート・パラメータの使用
対応するデータ・ポンプ・パラメータにマップするオリジナルのエクスポート・パラメータがある場合は、そのエクスポート・パラメータをデータ・ポンプ・エクスポートで使用できます。 - データ・ポンプでのオリジナルのインポート・パラメータの使用
データ・ポンプ・パラメータにマップするオリジナルのインポート・パラメータがある場合は、そのインポート・パラメータをデータ・ポンプ・インポートで使用できます。
親トピック: データ・ポンプのレガシー・モード
4.1.1 データ・ポンプでのオリジナルのエクスポート・パラメータの使用
対応するデータ・ポンプ・パラメータにマップするオリジナルのエクスポート・パラメータがある場合は、そのエクスポート・パラメータをデータ・ポンプ・エクスポートで使用できます。
表4-1に、オリジナルのエクスポート・パラメータがデータ・ポンプ・エクスポートでどのように解釈されるかを示します。オリジナルのエクスポートとデータ・ポンプのエクスポートで名前と機能が同じパラメータは、この表に含まれていません。
表4-1 データ・ポンプ・エクスポートでのオリジナルのエクスポート・パラメータの扱い
オリジナルのエクスポート・パラメータ | データ・ポンプ・エクスポート・パラメータでの処理 |
---|---|
|
このパラメータは無視されます。 |
|
このパラメータは無視されます。オリジナルのエクスポートの場合、 データ・ポンプ・エクスポートの |
|
データ・ポンプ・エクスポートは現在の時刻を確認して、 |
|
オリジナルのエクスポートで デフォルトの動作では、制約がエクスポートに含まれます。 |
|
このパラメータは無視されます。データ・ポンプ・エクスポートでは、最適なエクスポート方法が自動的に選択されます。 |
|
データ・ポンプ・エクスポートの オリジナルのエクスポートでは、一定の行数( |
|
データ・ポンプ・エクスポートは、 データ・ポンプでのオリジナルのエクスポートの |
|
オリジナルのエクスポートで オリジナルのエクスポートで |
|
オリジナルのエクスポートで オリジナルのエクスポートで |
|
データ・ポンプ・エクスポートは、 データ・ポンプでのオリジナルのエクスポートの ログ・ファイルの内容は、データ・ポンプ・エクスポート操作の内容になります。ログ・ファイルの場所と内容については、「ログ・ファイル」を参照してください。 |
|
このパラメータは無視されます。データ・ポンプ・エクスポートの処理では、エクスポートされる各オブジェクトの状態に一貫性があることが保証されています。 |
|
データ・ポンプの |
|
このパラメータは無視されます。データ・ポンプ・エクスポートでは、バッファ・サイズは自動的に調整されます。 |
|
このパラメータは無視されます。データ・ポンプ・エクスポートの場合、この機能は |
|
このパラメータは無視されます。データ・ポンプ・エクスポートの場合、この機能は |
|
このパラメータは無視されます。データ・ポンプ・エクスポートの場合、この機能は |
|
オリジナルのエクスポートで オリジナルのエクスポートで |
|
このパラメータは無視されます。統計は、データ・ポンプ・エクスポート操作の一環として、表に対して常に保存されます。 |
|
オリジナルのエクスポートで オリジナルのエクスポートで |
|
オリジナルのエクスポートで オリジナルのエクスポートで |
|
オリジナルのエクスポートで オリジナルのエクスポートで |
|
オリジナルのエクスポートで オリジナルのエクスポートで |
|
オリジナルのエクスポートで |
親トピック: パラメータのマッピング
4.1.2 データ・ポンプでのオリジナルのインポート・パラメータの使用
データ・ポンプ・パラメータにマップするオリジナルのインポート・パラメータがある場合は、そのインポート・パラメータをデータ・ポンプ・インポートで使用できます。
表4-2に、オリジナルのインポート・パラメータがデータ・ポンプ・インポートでどのように解釈されるかを示します。オリジナルのインポートとデータ・ポンプのインポートで名前と機能が同じパラメータは、この表に含まれていません。
表4-2 データ・ポンプ・インポートでのオリジナルのインポート・パラメータの扱い
オリジナルのインポート・パラメータ | データ・ポンプ・インポート・パラメータでの処理 |
---|---|
|
このパラメータは無視されます。 |
|
このパラメータは、数リリース前からサポートされなくなりました。今後は使用しないでください。このパラメータは、データ・ポンプ・インポート操作が中断される原因になります。 |
|
このパラメータは無視されます。データ・ポンプ・インポートでは、表の処理が終了するたびにコミットが自動的に実行されます。 |
|
このパラメータは無視されます。データ・ポンプ・インポートでは、プロシージャの作成後にコンパイルが実行されます。依存性の理由で必要な場合は、再コンパイルを実行できます。 |
|
オリジナルのインポートで オリジナルのインポートで |
|
データ・ポンプ・インポートの |
|
オリジナルのインポートで オリジナルのインポートで |
|
データ・ポンプ・インポートの オリジナルのインポートでは、一定の行数( |
|
データ・ポンプ・インポートは、 データ・ポンプでのオリジナルのインポートの |
|
このパラメータは無視されます。この情報はデータ・ポンプのダンプ・ファイル・セットにすでに含まれています。 |
|
データ・ポンプ・インポートの |
|
オリジナルのインポートで オリジナルのインポートで |
|
オリジナルのインポートで オリジナルのインポートで |
|
オリジナルのインポートで オリジナルのインポートで |
|
データ・ポンプ・インポートの
オリジナルのインポートでディレクトリ・オブジェクトが指定されていなかった場合は、 |
|
データ・ポンプ・インポートは、 データ・ポンプでのオリジナルのインポートの ログ・ファイルの内容は、データ・ポンプ・インポート操作の内容になります。ログ・ファイルの場所と内容については、「ログ・ファイル」を参照してください。 |
|
このパラメータは無視されます。データ・ポンプの場合、レコード長に関する問題は内部で処理されます。 |
|
このパラメータは無視されます。この機能は |
|
このパラメータは無視されます。この機能は |
|
このパラメータは無視されます。この機能は |
|
オリジナルのインポートで オリジナルのインポートで |
|
|
|
このパラメータは無視されます。統計は、データ・ポンプ・インポート操作の一環として、表に対して常に保存されます。 |
|
このパラメータは無視されます。この値はデータ・ポンプ・インポートによって自動的に決定されるため、指定する必要はありません。 |
|
このパラメータは無視されます。この値はデータ・ポンプ・インポートによって自動的に決定されるため、指定する必要はありません。 |
|
オリジナルのインポートで オリジナルのインポートで |
|
このパラメータは無視されます。型比較に、OIDは使用されなくなりました。 |
|
データ・ポンプ・インポートの オリジナルのインポートで |
|
|
|
このパラメータは無視されます。この情報はデータ・ポンプのダンプ・ファイル・セットに自動的に保存されます。 |
|
オリジナルのインポートで |
親トピック: パラメータのマッピング
4.2 データ・ポンプ・レガシー・モードでのファイルの場所の管理
オリジナルのバージョンはクライアントベース、データ・ポンプはサーバーベースであるため、オリジナルのエクスポートとインポート、およびデータ・ポンプ・エクスポートとデータ・ポンプ・インポートは、ダンプ・ファイルとログ・ファイルの書込み/読取りを行える場所によって異なります。
オリジナルのエクスポートおよびインポートでは、FILE
パラメータとLOG
パラメータを使用して、それぞれダンプ・ファイル名とログ・ファイル名を指定します。これらのファイル名は常にクライアント・システムに対してローカルなファイルを参照し、パスの指定を含めることもできます。
データ・ポンプ・エクスポートおよびデータ・ポンプ・インポートでは、DUMPFILE
パラメータとLOGFILE
パラメータを使用して、それぞれダンプ・ファイル名とログ・ファイル名を指定します。これらのファイル名は常にサーバー・システムに対してローカルなファイルを参照し、パス情報を含めることはできません。かわりに、ディレクトリ・オブジェクトを使用して、パス情報を間接的に指定します。ディレクトリ・オブジェクトによって定義されるパス値は、サーバーからアクセスできる必要があります。ディレクトリ・オブジェクトは、データ・ポンプ・ジョブ用にDIRECTORY
パラメータを使用して指定されます。DUMPFILE
パラメータおよびLOGFILE
パラメータに渡されるファイル名にディレクトリ・オブジェクトを付加することもできます。データ・ポンプを使用する特権ユーザーは、ディレクトリ・オブジェクトがコマンドラインで指定されていない場合に、デフォルト・ディレクトリ・オブジェクトを使用できます。このデフォルトのディレクトリ・オブジェクトDATA_PUMP_DIR
は、インストール時に設定されます。
データ・ポンプのレガシー・モードを有効にし、オリジナルのエクスポートのFILE=
filespec
パラメータまたはLOG=
filespec
パラメータ(あるいはその両方)をコマンドラインに指定すると、次の優先順位ルールで、ファイルの場所が決まります。
ノート:
コマンドラインにFILE
パラメータとLOG
パラメータの両方を指定した場合は、優先順位ルールがそれぞれのパラメータに個別に適用されます。
また、オリジナルのエクスポートおよびインポートとデータ・ポンプ・エクスポート、データ・ポンプ・インポートのパラメータが混在する場合は、個別のルールがそれぞれ適用されます。たとえば、次のコマンドを指定したとします。
expdp system FILE=/user/disk/foo.dmp LOGFILE=foo.log DIRECTORY=dpump_dir
この項で説明したとおり、データ・ポンプのレガシー・モードによるファイル管理ルールが、FILE
パラメータに適用されます。通常の(レガシー・モードではない)データ・ポンプのファイル管理ルールは、「ダンプ・ファイル、ログ・ファイルおよびSQLファイルのデフォルトの位置」で説明されているとおりに、LOGFILE
パラメータに適用されます。
-
パスの位置がファイル指定の一部として指定されると、データ・ポンプはエクスポート・ジョブを実行するスキーマからアクセスでき、そのパスの位置がファイル指定でのパスの位置に一致するディレクトリ・オブジェクトの検索を試行します。そのようなディレクトリ・オブジェクトが見つからないと、エラーが返されます。たとえば、
USER_DUMP_FILES
という名前のサーバーベースのディレクトリ・オブジェクトが'/disk1/user1/dumpfiles/'
のパス値とともに定義されていて、このディレクトリ・オブジェクトへの読取り/書込みアクセス権限がhr
スキーマに付与されているとします。次のコマンドを実行すると、データ・ポンプはそのパス値に'/disk1/user1/dumpfiles/'
が含まれ、そのhr
スキーマに読取り/書込みアクセス権限が付与されているサーバーベースのディレクトリ・オブジェクトを探します。expdp hr FILE=/disk1/user1/dumpfiles/hrdata.dmp
その場合、データ・ポンプはディレクトリ・オブジェクト
USER_DUMP_FILES
を使用します。この例で使用されているパス値'/disk1/user1/dumpfiles/'
は、Oracle Databaseからアクセスできるサーバー・システム上のパスを参照している必要があります。パスの位置がファイル指定の一部として指定されている場合は、
DIRECTORY
パラメータで指定されたディレクトリ・オブジェクトが無視されます。たとえば、次のコマンドを実行すると、データ・ポンプはファイル・パラメータのDPUMP_DIR
ディレクトリ・オブジェクトを使用せず、かわりにそのパス値に'/disk1/user1/dumpfiles/'
が含まれ、そのhr
スキーマに読取り/書込みアクセス権限が付与されているサーバーベースのディレクトリ・オブジェクトを探します。expdp hr FILE=/disk1/user1/dumpfiles/hrdata.dmp DIRECTORY=dpump_dir
-
パスの位置がファイル指定の一部として指定されない場合は、
DIRECTORY
パラメータに指定されたディレクトリ・オブジェクトが使用されます。たとえば、次のコマンドを実行すると、データ・ポンプはDPUMP_DIR
ディレクトリ・オブジェクト用に定義されたパスの位置をhrdata.dmp
ファイルに適用します。expdp hr FILE=hrdata.dmp DIRECTORY=dpump_dir
-
パスの位置がファイル指定の一部として指定されず、
DIRECTORY
パラメータにディレクトリ・オブジェクトが指定されていない場合は、データ・ポンプによって次のように動作が順次実行されます。-
データ・ポンプは
DATA_PUMP_DIR_
schema_name
という形式のディレクトリ・オブジェクトを探します。ここでのschema_name
は、データ・ポンプ・ジョブを実行するスキーマです。たとえば、次のコマンドを実行すると、データ・ポンプはDATA_PUMP_DIR_HR
という名前のサーバーベースのディレクトリ・オブジェクトを探します。expdp hr FILE=hrdata.dmp
また、
hr
スキーマには、このディレクトリ・オブジェクトへの読取り/書込みアクセス権限が付与されている必要があります。そのようなディレクトリ・オブジェクトが存在しないとき、処理はステップbに進みます。 -
データ・ポンプは、クライアントベースの環境変数
DATA_PUMP_DIR
を探します。たとえば、DUMP_FILES1
という名前のサーバーベースのディレクトリ・オブジェクトが定義されていて、hr
スキーマにそのオブジェクトへの読取り/書込みアクセス権限が付与されているとします。その場合は、クライアント・システムで、次のようにDUMP_FILES1
を指すように環境変数DATA_PUMP_DIR
を設定します。setenv DATA_PUMP_DIR DUMP_FILES1 expdp hr FILE=hrdata.dmp
データ・ポンプは、次にサーバーベースのディレクトリ・オブジェクト
DUMP_FILES1
をhrdata.dmp
ファイルに対して使用します。クライアントベースの環境変数
DATA_PUMP_DIR
が存在しないとき、処理はステップcに進みます。 -
データ・ポンプ・ジョブを実行するスキーマにDBA権限があると、デフォルトのデータ・ポンプ・ディレクトリ・オブジェクト
DATA_PUMP_DIR
が使用されます。このデフォルトのディレクトリ・オブジェクトは、インストール時に設定されます。たとえば、次のコマンドを実行すると、データ・ポンプはシステムにDBA権限があるとみなし、デフォルトのDATA_PUMP_DIR
ディレクトリ・オブジェクトを使用しようとします。expdp system FILE=hrdata.dmp
-
関連項目:
通常モードのデータ・ポンプ(レガシー・モードではない)でのデータ・ポンプのファイル管理優先順位ルールの詳細は、「ダンプ・ファイル、ログ・ファイルおよびSQLファイルのデフォルトの位置」を参照してください
親トピック: データ・ポンプのレガシー・モード
4.3 データ・ポンプのログ・ファイルとエラーに対する既存のスクリプトの調整
この項では、データ・ポンプのログ・ファイルとエラーに対して既存のスクリプトを調整する方法について説明します。
データ・ポンプのレガシー・モードを使用する場合は、オリジナルのエクスポートおよびインポート用に作成された既存のスクリプトを確認して更新する必要があります。これは、ファイルの形式およびエラーのレポート処理が異なるためです。
- ログ・ファイル
データ・ポンプのエクスポートおよびインポートで作成されるログ・ファイルは、オリジナルのエクスポートおよびインポートとは形式が異なります。 - エラー
データ・ポンプのエクスポートおよびインポートと、オリジナルのエクスポートおよびインポートとでは、生成されるエラーが異なる場合があります。 - 終了ステータス
データ・ポンプ・エクスポートおよびデータ・ポンプ・インポートには、エクスポート・ジョブとインポート・ジョブの成功または失敗をスクリプトでより適切に判定できるようにするための、拡張された終了状態の値があります。
親トピック: データ・ポンプのレガシー・モード
4.3.1 ログ・ファイル
データ・ポンプのエクスポートおよびインポートで作成されるログ・ファイルは、オリジナルのエクスポートおよびインポートとは形式が異なります。
オリジナルのエクスポートおよびインポートの出力を解析するスクリプトがある場合は、データ・ポンプのエクスポートおよびインポートで使用されるログ・ファイル形式を扱えるように更新する必要があります。たとえば、「Successfully Terminated」
というメッセージは、データ・ポンプのログ・ファイルには表示されません。
4.3.2 エラー
データ・ポンプのエクスポートおよびインポートと、オリジナルのエクスポートおよびインポートとでは、生成されるエラーが異なる場合があります。
たとえば、データ・ポンプ・エクスポートで無視されるパラメータが、オリジナルのエクスポートで範囲外の値である場合、ログ・ファイルに書き込まれるのは、パラメータは無視されるという情報メッセージです。値のチェックは実行されないため、エラー・メッセージは生成されません。