オリジナルのエクスポート(exp)およびインポート(imp)を使用している場合は、長年使用してきたスクリプトが存在することがあります。データ・ポンプの新しいエクスポート・ユーティリティおよびインポート・ユーティリティにスムーズに移行できるように、データ・ポンプには、既存のスクリプトを引き続き使用できるようにするためのレガシー・モードが用意されています。
コマンドラインまたはスクリプトのいずれかにオリジナルのエクスポートまたはインポートに特有のパラメータが存在するとデータ・ポンプで判断されると、データ・ポンプはレガシー・モードに入ります。そのパラメータがデータ・ポンプで処理されると、データ・ポンプ・エクスポートまたはデータ・ポンプ・インポートと同等のパラメータが表示されます。新しい構文を確認し、時間があるときにスクリプトを変更することをお薦めします。
注意: データ・ポンプのエクスポートおよびインポートでは、データ・ポンプ形式のダンプ・ファイルおよびログ・ファイルのみが処理されます。オリジナルのエクスポートやインポートと互換性のあるダンプ・ファイルが作成されたり、読み込まれることはありません。オリジナルのエクスポートで作成されたダンプ・ファイルがある場合は、オリジナルのインポートを使用してデータベースにデータをインポートする必要があります。 |
この章の内容は、次のとおりです。
この項では、オリジナルのエクスポートおよびインポートのパラメータと、同様の機能を持つデータ・ポンプ・エクスポートおよびデータ・ポンプ・インポートのパラメータとのマッピング関係について説明します。
対応するデータ・ポンプ・パラメータにマップするオリジナルのエクスポート・パラメータがある場合は、そのエクスポート・パラメータをデータ・ポンプ・エクスポートで使用できます。表4-1に、オリジナルのエクスポート・パラメータがデータ・ポンプ・エクスポートでどのように解釈されるかを示します。オリジナルのエクスポートとデータ・ポンプのエクスポートで名前と機能が同じパラメータは、この表に含まれていません。
表4-1 データ・ポンプ・エクスポートでのオリジナルのエクスポート・パラメータの扱い
オリジナルのエクスポート・パラメータ | データ・ポンプ・エクスポート・パラメータでの処理 |
---|---|
BUFFER |
このパラメータは無視されます。 |
COMPRESS |
このパラメータは無視されます。オリジナルのエクスポートの場合、 データ・ポンプ・エクスポートの |
CONSISTENT |
データ・ポンプ・エクスポートは現在の時刻を確認して、 |
|
オリジナルのエクスポートで デフォルトの動作では、制約がエクスポートに含まれます。 |
DIRECT |
このパラメータは無視されます。データ・ポンプ・エクスポートでは、最適なエクスポート方法が自動的に選択されます。 |
FEEDBACK |
データ・ポンプ・エクスポートの オリジナルのエクスポートでは、一定の行数( |
FILE |
データ・ポンプ・エクスポートは、 データ・ポンプでのオリジナルのエクスポートの |
GRANTS |
オリジナルのエクスポートで オリジナルのエクスポートで |
INDEXES |
オリジナルのエクスポートで オリジナルのエクスポートで |
|
データ・ポンプ・エクスポートは、 データ・ポンプでのオリジナルのエクスポートの ログ・ファイルの内容は、データ・ポンプ・エクスポート操作の内容になります。ログ・ファイルの場所と内容については、「ログ・ファイル」を参照してください。 |
OBJECT_CONSISTENT |
このパラメータは無視されます。データ・ポンプ・エクスポートの処理では、エクスポートされる各オブジェクトの状態に一貫性があることが保証されています。 |
OWNER |
データ・ポンプの |
RECORDLENGTH |
このパラメータは無視されます。データ・ポンプ・エクスポートでは、バッファ・サイズは自動的に調整されます。 |
RESUMABLE |
このパラメータは無視されます。データ・ポンプ・エクスポートの場合、この機能は |
RESUMABLE_NAME |
このパラメータは無視されます。データ・ポンプ・エクスポートの場合、この機能は |
RESUMABLE_TIMEOUT |
このパラメータは無視されます。データ・ポンプ・エクスポートの場合、この機能は |
ROWS |
オリジナルのエクスポートで オリジナルのエクスポートで |
STATISTICS |
このパラメータは無視されます。統計は、データ・ポンプ・エクスポート操作の一環として、表に対して常に保存されます。 |
TABLESPACES |
オリジナルのエクスポートで オリジナルのエクスポートで |
|
オリジナルのエクスポートで オリジナルのエクスポートで |
TRIGGERS |
オリジナルのエクスポートで オリジナルのエクスポートで |
TTS_FULL_CHECK |
オリジナルのエクスポートで オリジナルのエクスポートで |
VOLSIZE |
オリジナルのエクスポートで |
データ・ポンプ・パラメータにマップするオリジナルのインポート・パラメータがある場合は、そのインポート・パラメータをデータ・ポンプ・インポートで使用できます。表4-2に、オリジナルのインポート・パラメータがデータ・ポンプ・インポートでどのように解釈されるかを示します。オリジナルのインポートとデータ・ポンプのインポートで名前と機能が同じパラメータは、この表に含まれていません。
表4-2 データ・ポンプ・インポートでのオリジナルのインポート・パラメータの扱い
オリジナルのインポート・パラメータ | データ・ポンプ・インポート・パラメータでの処理 |
---|---|
BUFFER |
このパラメータは無視されます。 |
CHARSET |
このパラメータは、数リリース前からサポートされなくなりました。今後は使用しないでください。このパラメータは、データ・ポンプ・インポート操作が中断される原因になります。 |
COMMIT |
このパラメータは無視されます。データ・ポンプ・インポートでは、表の処理が終了するたびにコミットが自動的に実行されます。 |
COMPILE |
このパラメータは無視されます。データ・ポンプ・インポートでは、プロシージャの作成後にコンパイルが実行されます。依存性の理由で必要な場合は、再コンパイルを実行できます。 |
CONSTRAINTS |
オリジナルのインポートで オリジナルのインポートで |
DATAFILES |
データ・ポンプ・インポートの |
DESTROY |
オリジナルのインポートで オリジナルのインポートで |
FEEDBACK |
データ・ポンプ・インポートの オリジナルのインポートでは、一定の行数( |
|
データ・ポンプ・インポートは、 データ・ポンプでのオリジナルのインポートの |
FILESIZE |
このパラメータは無視されます。この情報はデータ・ポンプのダンプ・ファイル・セットにすでに含まれています。 |
|
データ・ポンプ・インポートの |
GRANTS |
オリジナルのインポートで オリジナルのインポートで |
IGNORE |
オリジナルのインポートで オリジナルのインポートで |
INDEXES |
オリジナルのインポートで オリジナルのインポートで |
|
データ・ポンプ・インポートの
オリジナルのインポートでディレクトリ・オブジェクトが指定されていなかった場合は、 |
|
データ・ポンプ・インポートは、 データ・ポンプでのオリジナルのインポートの ログ・ファイルの内容は、データ・ポンプ・インポート操作の内容になります。ログ・ファイルの場所と内容については、「ログ・ファイル」を参照してください。 |
RECORDLENGTH |
このパラメータは無視されます。データ・ポンプの場合、レコード長に関する問題は内部で処理されます。 |
RESUMABLE |
このパラメータは無視されます。この機能は |
RESUMABLE_NAME |
このパラメータは無視されます。この機能は |
RESUMABLE_TIMEOUT |
このパラメータは無視されます。この機能は |
ROWS=N |
オリジナルのインポートで オリジナルのインポートで |
SHOW |
|
STATISTICS |
このパラメータは無視されます。統計は、データ・ポンプ・インポート操作の一環として、表に対して常に保存されます。 |
STREAMS_CONFIGURATION |
このパラメータは無視されます。この値はデータ・ポンプ・インポートによって自動的に決定されるため、指定する必要はありません。 |
STREAMS_INSTANTIATION |
このパラメータは無視されます。この値はデータ・ポンプ・インポートによって自動的に決定されるため、指定する必要はありません。 |
|
オリジナルのインポートで オリジナルのインポートで |
TOID_NOVALIDATE |
このパラメータは無視されます。型比較に、OIDは使用されなくなりました。 |
|
データ・ポンプ・インポートの オリジナルのインポートで |
|
|
TTS_OWNERS |
このパラメータは無視されます。この情報はデータ・ポンプのダンプ・ファイル・セットに自動的に保存されます。 |
VOLSIZE |
オリジナルのインポートで |
オリジナルのバージョンはクライアントベース、データ・ポンプはサーバーベースであるため、オリジナルのエクスポートとインポート、およびデータ・ポンプ・エクスポートとデータ・ポンプ・インポートは、ダンプ・ファイルとログ・ファイルの書込み/読取りを行える場所によって異なります。
オリジナルのエクスポートおよびインポートでは、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 この項で説明したとおり、データ・ポンプのレガシー・モードによるファイル管理ルールが、 |
パスの位置がファイル指定の一部として指定されると、データ・ポンプはエクスポート・ジョブを実行するスキーマからアクセスでき、そのパスの位置がファイル指定でのパスの位置に一致するディレクトリ・オブジェクトの検索を試行します。そのようなディレクトリ・オブジェクトが見つからないと、エラーが返されます。たとえば、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ファイルのデフォルトの位置」を参照してください。 |
データ・ポンプのレガシー・モードを使用する場合は、オリジナルのエクスポートおよびインポート用に作成された既存のスクリプトを確認して更新する必要があります。これは、ファイルの形式およびエラーのレポート処理が異なるためです。
データ・ポンプのエクスポートおよびインポートで作成されるログ・ファイルは、オリジナルのエクスポートおよびインポートとは形式が異なります。オリジナルのエクスポートおよびインポートの出力を解析するスクリプトがある場合は、データ・ポンプのエクスポートおよびインポートで使用されるログ・ファイル形式を扱えるように更新する必要があります。たとえば、「Successfully Terminated」
というメッセージは、データ・ポンプのログ・ファイルには表示されません。