3 Oracleデータ・ポンプ・インポート
Oracleデータ・ポンプ・インポートを使用すると、エクスポート・ダンプ・ファイル・セットをターゲット・データベースにロードできます。また、中間ファイルを使用することなく、ソース・データベースからターゲット・データベースへの直接的なロードも可能です。
- Oracleデータ・ポンプ・インポートとは
Oracleデータ・ポンプ・インポートとは、ターゲット・システムにOracleエクスポート・ダンプ・ファイルをロードするためのユーティリティです。 - Oracle Data Pump Importの起動
Oracle Data Pump Importの起動には、impdp
コマンドを使用します。 - インポート操作中のフィルタ処理
Oracleデータ・ポンプ・インポートでは、データとメタデータのフィルタ処理機能を使用して、インポートする情報のタイプを効果的に制限できます。 - Oracle Data Pump Importコマンドライン・モードで使用可能なパラメータ
インポート(impdp
)用のOracle Data Pumpパラメータを使用して、データ・インポートを管理します。 - Oracle Data Pump Importの対話方式コマンド・モードで使用可能なコマンド
対話方式コマンド・モードでは、現行のジョブは継続して続行されますが、端末へのロギングは一時停止され、インポート・プロンプト(Import>
)が表示されます。 - Oracleデータ・ポンプ・インポートの使用例
次の一般的なシナリオ例を使用して、データの移動にOracleデータ・ポンプ・インポートを使用する方法について学習します。 - Oracle Data Pump Importの構文図
構文図を使用すると、Oracle Data Pump Importでの有効なSQL構文を理解できます。
親トピック: Oracle Data Pump
3.1 Oracleデータ・ポンプ・インポートとは
Oracleデータ・ポンプ・インポートとは、ターゲット・システムにOracleエクスポート・ダンプ・ファイルをロードするためのユーティリティです。
エクスポート・ダンプ・ファイル・セットは、表データ、データベース・オブジェクトのメタデータ、制御情報を含む1つ以上のディスク・ファイルで構成されています。これらのファイルは独自のバイナリ形式で書き込まれています。Oracleデータ・ポンプ・インポート・ユーティリティは、インポート操作中、これらのファイルを使用してダンプ・ファイル・セット内の各データベース・オブジェクトの位置を特定します。
また、ダンプ・ファイルを介さずにソース・データベースから直接ターゲット・データベースをロードするために、インポートを使用することもできます。このタイプのインポートをネットワーク・インポートと呼びます。
インポートでは、インポート・モードで設定されているとおりにジョブによって、データおよびメタデータのサブセットが、ダンプ・ファイル・セットまたはソース・データベース(ネットワーク・インポートの場合)から移動されるように指定できます。この指定は、インポート・ユーティリティのコマンドによって実装されるデータ・フィルタおよびメタデータ・フィルタを使用することで行います。
親トピック: Oracleデータ・ポンプ・インポート
3.2 Oracleデータ・ポンプ・インポートの開始
Oracle Data Pump Importの起動には、impdp
コマンドを使用します。
インポート操作の特性は、指定するインポート・パラメータによって決定されます。これらのパラメータは、コマンドラインまたはパラメータ・ファイルのいずれかで指定できます。
ノート:
- インポート・ユーティリティは、Oracleサポート・サービスから要求された場合以外、
SYSDBA
として起動しないでください。SYSDBA
は内部的に使用され、一般ユーザーとは異なる特別な機能を持ちます。 -
NOLOGGING
句を有効にして作成された表または表領域に対してデータ・ポンプ・インポートを実行する場合でも、REDOログ・ファイルが生成される場合があることに注意してください。このような場合に生成されるREDOは、通常、データ・ポンプ制御表のメンテナンスを目的としているか、または基礎となる再帰的領域トランザクション、データ・ディクショナリの変更、およびロギングを必要とする表の索引メンテナンスに関係しています。 - エクスポート・データベースで使用されているタイムゾーン・バージョンが、インポート・データベースで使用されているバージョンより古い場合は、データ型が
TIMESTAMP WITH TIMEZONE
の列をロードすると、それ以外の場合よりも時間がかかります。この追加時間は、新しいタイムゾーン・ルールによってロードされる値が変更されるかどうかを確認するために必要です。
- Oracle Data Pump Importのインタフェース
Oracle Data Pump Importは、コマンドライン、パラメータ・ファイルまたは対話方式コマンド・モードを使用して操作できます。 - Oracle Data Pump Importのモード
Oracle Data Pumpで使用するインポート・モードにより、何をインポートするかを決定します。 - Oracleデータ・ポンプ・インポートのネットワークに関する考慮事項
Oracleデータ・ポンプ・インポート・ユーティリティimpdp
がOracle*Netまたはネット・サービス名を使用して接続文字列に含まれた接続識別子でインスタンスを識別する方法と、NETWORK_LINKパラメータを使用したインポート操作との相違点について説明します。
親トピック: Oracleデータ・ポンプ・インポート
3.2.1 Oracle Data Pump Importのインタフェース
Oracle Data Pump Importは、コマンドライン、パラメータ・ファイルまたは対話方式コマンド・モードを使用して操作できます。
-
コマンドライン・インタフェース: 直接コマンドラインでインポートのパラメータを指定できます。コマンドライン・インタフェースで使用可能なパラメータの詳細。
-
パラメータ・ファイル・インタフェース: パラメータ・ファイルでコマンドラインのパラメータを指定できます。パラメータ・ファイルはネストできないため、
PARFILE
パラメータのみが例外となります。値の指定に引用符が必要なパラメータを指定する場合は、パラメータ・ファイルを使用することをお薦めします。 -
対話方式コマンド・インタフェース: 端末へのロギングを中止してインポート・ユーティリティのプロンプトを表示します。対話方式コマンド・モード固有のコマンドも含めて、様々なコマンドが入力できます。このモードは、コマンドライン・インタフェースまたはパラメータ・ファイル・インタフェースで開始されたインポート操作中に[Ctrl]キーを押しながら[C]キーを押すと使用可能になります。対話方式コマンド・モードは、実行中のジョブまたは停止されたジョブに接続した場合も使用可能になります。
3.2.2 Oracle Data Pump Importのモード
Oracle Data Pumpで使用するインポート・モードにより、何をインポートするかを決定します。
- Oracle Data Pump Importのモードについて
Oracle Data Pump Importの各モードの、インポート中の動作について学習します。 - 全体インポート・モード
Oracle Data Pumpで全体インポートを指定するには、FULL
パラメータを使用します。 - スキーマ・モード
Oracle Data Pumpでスキーマ・インポートを指定するには、SCHEMAS
パラメータを使用します。 - 表モード
Oracle Data Pumpで表モードでのインポートを指定するには、TABLES
パラメータを使用します。 - 表領域モード
Oracle Data Pumpで表領域モードでのインポートを指定するには、TABLESPACES
パラメータを使用します。 - トランスポータブル表領域モード
Oracle Data Pumpでトランスポータブル表領域モードでのインポートを指定するには、TRANSPORT_TABLESPACES
パラメータを使用します。
親トピック: Oracleデータ・ポンプ・インポートの開始
3.2.2.1 Oracle Data Pump Importのモードについて
Oracle Data Pump Importの各モードの、インポート中の動作について学習します。
インポートについて指定するOracle Data Pumpインポート・モードは、操作のソースに適用されます。NETWORK_LINK
パラメータを指定すると、そのソースはダンプ・ファイル・セットまたは別のデータベースのいずれかになります。
インポート操作のソースがダンプ・ファイル・セットの場合、モードの指定はオプションです。モードを指定しない場合、インポート・ユーティリティは、エクスポート操作実行時のモードでダンプ・ファイル・セット全体をロードしようとします。
モードは、適切なパラメータを使用してコマンドラインで指定します。
ノート:
全体モード・エクスポートによって作成されたダンプ・ファイルをインポートする場合、インポート操作はSYS
アカウントのパスワードをソース・データベースからコピーしようとします。このコピーは、失敗する場合があります(パスワードが共有パスワード・ファイル内にある場合など)。失敗した場合は、インポートの完了後に、ターゲット・データベース上のSYS
アカウントのパスワードを任意のパスワードに設定する必要があります。
親トピック: Oracle Data Pump Importのモード
3.2.2.2 全体インポート・モード
Oracle Data Pumpで全体インポートを指定するには、FULL
パラメータを使用します。
全体インポート・モードでは、ソース(ダンプ・ファイル・セットまたは別のデータベース)の全内容がターゲット・データベースにロードされます。このモードは、ファイル・ベース・インポートのデフォルトです。ソースが自分のスキーマ以外のスキーマを含む別のデータベースである場合、DATAPUMP_IMP_FULL_DATABASE
ロールが必要です。
権限のないユーザーの場合、相互スキーマ参照はインポートされません。たとえば、インポートを実行するユーザーのスキーマ内の表にトリガーが定義されていても、そのトリガーが別のユーザーのスキーマに存在している場合はインポートされません。
ターゲット・データベースでは、DATAPUMP_IMP_FULL_DATABASE
ロールが必要です。全体インポートにNETWORK_LINK
パラメータを使用する場合、ソース・データベースでは、DATAPUMP_EXP_FULL_DATABASE
ロールが必要です
全体モード・インポート時のトランスポータブル・オプションの使用
全体モード・インポート時にトランスポータブル・オプションを使用して、全体トランスポータブル・インポートを実行できます。
ネットワーク・ベースの全体トランスポータブル・インポートでは、FULL=YES
、TRANSPORTABLE=ALWAYS
およびTRANSPORT_DATAFILES=datafile_name
パラメータを使用する必要があります。
ファイル・ベースの全体トランスポータブル・インポートでは、TRANSPORT_DATAFILES=datafile_name
パラメータのみを使用する必要があります。データ・ポンプ・インポートでは、TRANSPORTABLE=ALWAYS
およびFULL=Y
パラメータの存在が推測されます。
全体トランスポータブル・インポートを実行する場合、次のようないくつかの要件があります。
-
同時に
NETWORK_LINK
パラメータを指定するか、エクスポート中にインポート対象のダンプ・ファイル・セットがトランスポータブル・オプションを使用して作成されている必要があります。 -
ネットワーク・リンクを使用する場合、
NETWORK_LINK
パラメータで指定されているデータベースがOracle Database 11gリリース2 (11.2.0.3)以上であり、Oracle Data PumpのVERSION
パラメータが12以上に設定されている必要があります。(ネットワーク・インポート以外では、ダンプ・ファイルから暗黙的にVERSION=12
が決定されます。) -
ソース・プラットフォームとターゲット・プラットフォームのエンディアンが異なる場合、転送するデータを変換してターゲット・プラットフォームの形式にする必要があります。データを変換するには、
DBMS_FILE_TRANSFER
パッケージまたはRMAN CONVERT
コマンドのどちらかを使用します。 -
ソース・プラットフォームとターゲット・プラットフォームでエンディアンが同じでない場合、暗号化された表領域の全体トランスポータブル・インポートは、ネットワーク・モードまたはダンプ・ファイル・モードではサポートされません
全体トランスポータブル・インポートの詳細な例は、Oracle Database管理者ガイドを参照してください。
3.2.2.3 スキーマ・モード
Oracle Data Pumpでスキーマ・インポートを指定するには、SCHEMAS
パラメータを使用します。
スキーマ・インポートでは、指定されたスキーマが所有しているオブジェクトのみがロードされます。ソースは、全体インポート・モード、表モード、表領域モードまたはスキーマ・モードのエクスポート・ダンプ・ファイル・セット、または別のデータベースです。ユーザーにDATAPUMP_IMP_FULL_DATABASE
ロールが付与されている場合は、スキーマ・リストを指定できます。これにより、スキーマ内のオブジェクトに加えてスキーマ自体(システム権限を含む)もデータベース内に作成されます。
相互スキーマ参照は、残りのスキーマが現行のスキーマに再マップされないかぎり、権限のないユーザーに対してインポートされません。たとえば、インポートを実行するユーザーのスキーマ内の表にトリガーが定義されていても、そのトリガーが別のユーザーのスキーマに存在している場合はインポートされません。
関連トピック
親トピック: Oracle Data Pump Importのモード
3.2.2.4 表モード
Oracle Data Pumpで表モードでのインポートを指定するには、TABLES
パラメータを使用します。
表モード・インポートは、TABLES
パラメータを使用して指定します。表モードでは、指定した表、パーティションおよびそれらの依存オブジェクトのみがロードされます。ソースは、全体インポート・モード、スキーマ・モード、表領域モードまたは表モードのエクスポート・ダンプ・ファイル・セット、または別のデータベースです。自分のスキーマに存在しない表を指定するには、DATAPUMP_IMP_FULL_DATABASE
ロールが必要です。
TRANPORTABLE=ALWAYS
パラメータをTABLES
パラメータと組み合せて指定することで、表モードのインポート中にトランスポータブル・オプションを使用できます。このオプションを使用する場合、NETWORK_LINK
パラメータも使用する必要があります。
表および表パーティションのリカバリには、RMAN
バックアップおよびRMAN
RECOVER TABLE
コマンドも使用できます。このプロセスの間に、RMAN
によって、リカバリされたオブジェクトを含むOracle Data Pumpエクスポート・ダンプ・ファイルが作成(およびオプションでインポート)されます。
3.2.2.5 表領域モード
Oracle Data Pumpで表領域モードでのインポートを指定するには、TABLESPACES
パラメータを使用します。
表領域モードのインポートは、TABLESPACES
パラメータを使用して指定します。表領域モードでは、指定した表領域内のすべてのオブジェクトが、依存オブジェクトとともにロードされます。ソースは、全体インポート・モード、スキーマ・モード、表領域モードまたは表モードのエクスポート・ダンプ・ファイル・セット、または別のデータベースです。権限のないユーザーの場合、現行のスキーマに再マッピングされていないオブジェクトは処理されません。
関連トピック
親トピック: Oracle Data Pump Importのモード
3.2.2.6 トランスポータブル表領域モード
Oracle Data Pumpでトランスポータブル表領域モードでのインポートを指定するには、TRANSPORT_TABLESPACES
パラメータを使用します。
トランスポータブル表領域モードでは、(NETWORK_LINK
パラメータで指定された)データベース・リンクを使用するか、メタデータを含むダンプ・ファイルを指定することで、別のデータベースからメタデータがロードされます。TRANSPORT_DATAFILES
パラメータで指定した実際のデータ・ファイルは、ターゲット・データベースで使用するために、通常は、データ・ファイルをターゲット・システムにコピーすることによって、ソース・システムで使用可能にする必要があります。
トランスポータブル・ジョブを実行する場合は、インポート・ジョブがターゲット・システムで正常に完了するまで、ソース・システムにデータ・ファイルのコピーを保持することをお薦めします。データ・ファイルのコピーがあると、インポート・ジョブがなんらかの理由で失敗しても、破損していないデータ・ファイルのコピーが残ることになります。
このモードの使用には、DATAPUMP_IMP_FULL_DATABASE
ロールが必要です。
ノート:
トランスポータブル表領域をエクスポートした後、それよりも古いリリース・レベルのデータベースにインポートすることはできません。ターゲット・データベースのリリース・レベルは、ソース・データベース以上である必要があります。
3.2.3 Oracleデータ・ポンプ・インポートのネットワークに関する考慮事項
Oracleデータ・ポンプ・インポート・ユーティリティimpdp
がOracle*Netまたはネット・サービス名を使用して接続文字列に含まれた接続識別子でインスタンスを識別する方法と、NETWORK_LINKパラメータを使用したインポート操作との相違点について学習します。
impdp
の起動時には、接続文字列で接続識別子を指定できます。この接続識別子は、現在のOracleシステムID (SID)で識別される現在のインスタンスとは別のものにすることができます。
接続識別子の指定には、Oracle*Net接続記述子を使用することも、接続記述子にマップされるネット・サービス名(通常はtnsnames.ora
ファイルで定義されているもの)を使用することもできます。接続識別子を使用するには、Oracle Net Listenerが実行中であることが必要です(デフォルト・リスナーを起動するには、lsnrctl start
と入力します)。次の例では、このタイプの接続を示します(inst1
が接続識別子です)。
impdp hr@inst1 DIRECTORY=dpump_dir1 DUMPFILE=hr.dmp TABLES=employees
インポートによってパスワードの入力を要求されます。
Password: password
ローカル・インポート・クライアントは接続識別子inst1
(ネット・サービス名)によって識別されるデータベース・インスタンスに接続し、ダンプ・ファイルhr.dmp
からinst1
にデータをインポートします。
インポート・ユーティリティの起動時に接続識別子を指定することと、NETWORK_LINK
パラメータを使用してインポート操作を実行することは異なります。インポート操作を開始して接続識別子を指定すると、接続識別子によって識別されるデータベース・インスタンスにローカルのインポート・クライアントが接続され、コマンドラインで指定されるダンプ・ファイルからそのデータベース・インスタンスにデータがインポートされます。
その一方、NETWORK_LINK
パラメータを使用してインポートを実行すると、インポートはデータベース・リンクを使用して実行されます。ダンプ・ファイルは介在しません。(データベース・リンクとは2つの物理データベース・サーバー間の接続で、データベース・リンクによってクライアントは2つの物理データベース・サーバーに1つの論理データベースとしてアクセスできます。)
関連トピック
関連項目:
-
データベース・リンクの詳細は、Oracle Database管理者ガイドを参照してください。
-
接続識別子およびOracle Net Listenerの詳細は、『Oracle Database Net Services管理者ガイド』を参照してください。
親トピック: Oracleデータ・ポンプ・インポートの開始
3.3 インポート操作中のフィルタ処理
Oracleデータ・ポンプ・インポートでは、データとメタデータのフィルタ処理機能を使用して、インポートする情報のタイプを効果的に制限できます。
- データ・フィルタ
データ固有のフィルタ処理は、QUERY
およびSAMPLE
パラメータによって実装されます。このパラメータは、表のインポートされる行に対する制限を指定します。 - メタデータ・フィルタ
メタデータのフィルタ処理は、EXCLUDE
およびINCLUDE
パラメータによって実装されます。
親トピック: Oracleデータ・ポンプ・インポート
3.3.1 データ・フィルタ
データ固有のフィルタ処理は、QUERY
およびSAMPLE
パラメータによって実装されます。このパラメータは、表のインポートされる行に対する制限を指定します。
メタデータのフィルタ処理のため、間接的にデータのフィルタ処理が実行される場合もあります。この処理では、表オブジェクトおよび関連付けられた行データを含めたり、除外することができます。
各データ・フィルタは、表およびジョブごとにそれぞれ1回指定できます。同じ名前を使用する異なるフィルタが特定の表とジョブ全体の両方に適用された場合は、特定の表に対して提供されたフィルタ・パラメータが優先されます。
親トピック: インポート操作中のフィルタ処理
3.3.2 メタデータ・フィルタ
メタデータのフィルタ処理は、EXCLUDE
およびINCLUDE
パラメータによって実装されます。
データ・ポンプ・インポート・ユーティリティで提供されるメタデータのフィルタ処理機能は、オリジナルのインポート・ユーティリティと比較すると大幅に拡張されています。EXCLUDE
およびINCLUDE
は、相互に排他的なパラメータです。
メタデータ・フィルタは、データ・ポンプ操作に含めるか、データ・ポンプ操作から除外するオブジェクトの集合を特定します。たとえば、パッケージ仕様またはパッケージ本体を含まない全体インポートを要求できます。
フィルタを正しく使用して必要な結果を得た場合は、識別されたオブジェクトの依存オブジェクトも、識別されたオブジェクトとともに処理されます。たとえば、パッケージを操作に含めるようにフィルタで指定すると、そのパッケージに対する権限も含まれます。同様に、フィルタで表を除外すると、その表に対する索引、制約、権限およびトリガーも除外されます。
1つのオブジェクト型に対して複数のフィルタが指定されている場合は、それらのフィルタに対して暗黙的なAND
処理が適用されます。つまり、ジョブに関連するオブジェクトは、オブジェクト型に適用されるすべてのフィルタで処理される必要があります。
1つのジョブ内には、同じフィルタ名を複数回指定できます。
DATABASE_EXPORT_OBJECTS
(全体モードの場合)、SCHEMA_EXPORT_OBJECTS
(スキーマ・モードの場合)、TABLE_EXPORT_OBJECTS
(表および表領域モードの場合)ビューを問い合せて、有効なオブジェクト・タイプ値の一覧を表示できます。OBJECT_PATH
列にリストされる値が有効なオブジェクト・タイプです。完全なオブジェクト・パス名は、インポート・モードでなくエクスポート・モードによって決定されます。
関連トピック
親トピック: インポート操作中のフィルタ処理
3.4 Oracle Data Pump Importコマンドライン・モードで使用可能なパラメータ
データ・インポートを管理するには、インポート(impdp
)用のOracle Data Pumpパラメータを使用します。
- インポート・コマンドライン・モードについて
大/小文字の区別、引用符、エスケープ文字、例の使用方法に関する情報など、コマンドライン・モードでOracle Data Pump Importパラメータを使用する方法について学習します。 - ABORT_STEP
Oracle Data Pumpインポートのコマンドライン・モードのABORT_STEP
パラメータでは、ジョブの初期化後に、そのジョブを停止します。ジョブを停止すると、データがインポートされる前にデータ・ポンプ制御ジョブ表を問い合せることができます。 - ACCESS_METHOD
Orale Data Pump Importのコマンドライン・モードのACCESS_METHOD
パラメータでは、インポートでデータのロードに特定の方法を使用することを指定します - ATTACH
Oracle Data Pumpインポートのコマンドライン・モードのATTACH
パラメータでは、クライアント・セッションを既存のインポート・ジョブに接続し、自動的に対話方式コマンド・モードにします。 - CLUSTER
Oracle Data Pump Importのコマンドライン・モードのCLUSTER
パラメータでは、データ・ポンプでOracle Real Application Clusters (Oracle RAC)リソースを使用できるかどうかと、ワーカーを他のOracle RACインスタンス上で開始できるかどうかを指定します。 - CONTENT
Oracle Data Pump Importのコマンドライン・モードのCONTENT
パラメータを使用すると、インポート操作中にロード対象をフィルタ処理できます。 - CREDENTIAL
Oracle Data Pumpインポートのコマンドライン・モードのCREDENTIAL
パラメータでは、データベース・ユーザーが所有する資格証明オブジェクトの名前を指定します。インポート・ユーティリティは、このオブジェクト名を使用してクラウド・ストレージにインポートされるダンプ・ファイルセットのファイルを処理します。 - DATA_OPTIONS
Oracle Data Pump Importのコマンドライン・モードのDATA_OPTIONS
パラメータでは、インポート操作中に特定のタイプのデータをどのように処理するかを指定します。 - DIRECTORY
Oracle Data Pump Importのコマンドライン・モードのDIRECTORY
パラメータでは、インポート・ジョブでのダンプ・ファイル・セットの検索先およびログ・ファイルとSQLファイルの作成先となるデフォルトの場所を指定します。 - DUMPFILE
Oracle Data Pump Importのコマンドライン・モードのDUMPFILE
パラメータでは、エクスポート・ユーティリティによって作成されたダンプ・ファイル・セットの名前を指定し、オプションで、これらのディレクトリ・オブジェクトを指定します。 - ENABLE_SECURE_ROLES
Oracle Data Pumpインポートのコマンドライン・ユーティリティのENABLE_SECURE_ROLES
パラメータは、エクスポート時に保護されたロールを誤って使用しないようにします。 - ENCRYPTION_PASSWORD
Oracle Data Pump Importのコマンドライン・モードのENCRYPTION_PASSWORD
パラメータでは、ダンプ・ファイル・セット内の暗号化列のデータにアクセスするためのパスワードを指定します。これにより、暗号化されたダンプ・ファイル・セットへの不正なアクセスを防ぎます。 - ENCRYPTION_PWD_PROMPT
Oracle Data Pumpインポートのコマンドライン・モードのENCRYPTION_PWD_PROMPT
パラメータでは、データ・ポンプによって暗号化パスワードの入力を要求するかどうかを指定します。 - ESTIMATE
Oracle Data Pumpインポートのコマンドライン・モードのESTIMATE
パラメータでは、ネットワーク・インポート操作のソース・システムに対して、インポート中に生成されるデータ量を見積もるように指定します。 - EXCLUDE
Oracle Data Pumpインポートのコマンドライン・モードのEXCLUDE
パラメータを使用すると、インポート・ジョブから除外するオブジェクトとオブジェクト型を指定して、インポート対象のメタデータをフィルタ処理できます。 - FLASHBACK_SCN
Oracle Data Pump Importのコマンドライン・モードのFLASHBACK_SCN
では、インポート・ユーティリティで使用されるシステム変更番号(SCN)を指定して、フラッシュバック・ユーティリティを使用可能にします。 - FLASHBACK_TIME
Oracle Data Pump Importのコマンドライン・モードのFLASHBACK_TIME
パラメータでは、インポート・ユーティリティで使用されるシステム変更番号(SCN)を指定して、フラッシュバック・ユーティリティを使用可能にします。 - FULL
Oracle Data Pump Importのコマンドライン・モードのFULL
パラメータにより、全データベース・インポートを実行することを指定します。 - HELP
Oracle Data Pump Importのコマンドライン・モードのHELP
パラメータにより、インポート・ユーティリティのオンライン・ヘルプを表示します。 - INCLUDE
Oracle Data Pumpインポートのコマンドライン・モードのINCLUDE
パラメータを使用すると、現行のインポート・モードにオブジェクトとオブジェクト型を指定して、インポート対象のメタデータをフィルタ処理できます。 - JOB_NAME
Oracle Data Pumpインポートのコマンドライン・モードのJOB_NAME
パラメータを使用して、後続処理でインポート・ジョブを指定します。 - KEEP_MASTER
Oracle Data Pumpインポートのコマンドライン・モードのKEEP_MASTER
パラメータは、正常に完了したOracle Data Pumpジョブの最後にデータ・ポンプ制御ジョブ表を削除するか保持するかを指定します。 - LOGFILE
Oracle Data Pump Importのコマンドライン・モードのLOGFILE
パラメータでは、インポート・ジョブのログ・ファイルの名前を指定し、オプションでディレクトリ・オブジェクトを指定します。 - LOGTIME
Oracle Data Pump Importのコマンドライン・モードのLOGTIME
パラメータにより、インポート中にメッセージをタイムスタンプとともに表示することを指定します。 - MASTER_ONLY
Oracle Data Pumpインポートのコマンドライン・モードのMASTER_ONLY
パラメータは、データ・ポンプ制御ジョブ表の内容を確認できるように、データ・ポンプ制御ジョブ表のみをインポートしてジョブを停止するかどうかを示します。 - METRICS
Oracle Data Pump Importのコマンドライン・モードのMETRICS
パラメータにより、ジョブに関する詳細情報をログ・ファイルに記録するかどうかを指定します。 - NETWORK_LINK
Oracleデータ・ポンプ・インポートのコマンドライン・モードでNETWORK_LINK
パラメータを使用すると、有効なデータベース・リンクで識別されるソース・データベースからのインポートが可能になります。 - NOLOGFILE
Oracle Data Pump Importのコマンドライン・モードのNOLOGFILE
パラメータにより、デフォルトでログ・ファイルを作成するかどうかを指定します。 - PARALLEL
Oracleデータ・ポンプ・インポートのコマンドライン・モードのPARALLEL
パラメータでは、パラレルにロードできるワーカー・プロセスの最大数を設定します。 - PARALLEL_THRESHOLD
Oracle Data Pump Importコマンドライン・ユーティリティのPARALLEL_THRESHOLD
パラメータでは、表サイズに基づいてデータ・ポンプが潜在的なパラレルDMLを計算するために使用する除数のサイズを指定します。 - PARFILE
Oracle Data Pump Importのコマンドライン・モードのPARFILE
パラメータでは、インポート・パラメータ・ファイルの名前を指定します。 - PARTITION_OPTIONS
Oracle Data Pump Importのコマンドライン・モードのPARTITION_OPTIONS
パラメータでは、インポート操作中に表パーティションを作成する方法を指定します。 - QUERY
Oracle Data Pump Importのコマンドライン・モードのQUERY
パラメータを使用すると、インポート対象のデータをフィルタ処理する問合せ句を指定できます。 - REMAP_DATA
Oracle Data Pump Importのコマンドライン・モードのREMAP_DATA
パラメータを使用すると、新規データベースへの挿入時に、データを再マップできます。 - REMAP_DATAFILE
Oracle Data Pump Importのコマンドライン・モードのREMAP_DATAFILE
パラメータにより、ソース・データ・ファイルを参照するすべてのSQL文において、ソース・データファイル名がターゲット・データファイル名に変更されます。 - REMAP_DIRECTORY
Oracle Data Pump Importのコマンドライン・モードのREMAP_DIRECTORY
パラメータを使用すると、プラットフォーム間でデータベースを移動するときにディレクトリを再マップできます。 - REMAP_SCHEMA
Oracle Data Pump Importのコマンドライン・モードのREMAP_SCHEMA
パラメータにより、すべてのオブジェクトをソース・スキーマからターゲット・スキーマにロードします。 - REMAP_TABLE
Oracle Data Pump Importのコマンドライン・モードのREMAP_TABLE
パラメータを使用すると、インポート操作中に表の名前を変更できます。 - REMAP_TABLESPACE
Oracle Data Pump Importのコマンドライン・モードのREMAP_TABLESPACE
パラメータにより、インポート用に選択されたすべてのオブジェクトを再マップし、ソース表領域内の永続データがターゲット表領域内に作成されるようにします。 - SCHEMAS
Oracle Data Pump Importのコマンドライン・モードのSCHEMAS
パラメータにより、スキーマ・モード・インポートを実行することを指定します。 - SERVICE_NAME
Oracle Data Pump Importのコマンドライン・モードのSERVICE_NAME
パラメータでは、CLUSTER
パラメータとともに使用するサービス名を指定します。 - SKIP_UNUSABLE_INDEXES
Oracle Data Pump Importのコマンドライン・モードのSKIP_UNUSABLE_INDEXES
パラメータにより、(システムまたはユーザーのどちらかによって)索引使用禁止状態に設定されている索引を持つ表のロードをインポート・ユーティリティでスキップするかどうかを指定します。 - SOURCE_EDITION
Oracle Data Pump Importのコマンドライン・モードのSOURCE_EDITION
パラメータでは、オブジェクトのフェッチ元となるリモート・ノード上のデータベース・エディションを指定します。 - SQLFILE
Oracle Data Pump Importのコマンドライン・モードのSQLFILE
パラメータでは、選択した他のインポート・パラメータに基づいて、インポート・ユーティリティによって実行準備が整えられたすべてのSQL DDLの書込み先となるファイルを指定します。 - STATUS
Oracle Data Pump Importのコマンドライン・モードのSTATUS
パラメータでは、ジョブの状態を表示する頻度を指定します。 - STREAMS_CONFIGURATION
Oracle Data Pump Importのコマンドライン・モードのSTREAMS_CONFIGURATION
パラメータでは、エクスポート・ダンプ・ファイル内に存在する可能性のあるすべてのGoldenGateレプリケーション・メタデータをインポートするかどうかを指定します。 - TABLE_EXISTS_ACTION
Oracle Data Pump Importのコマンドライン・モードのTABLE_EXISTS_ACTION
パラメータでは、インポート・ユーティリティで作成しようとしている表がすでに存在する場合の動作を指定します。 - REUSE_DATAFILES
Oracle Data Pump Importのコマンドライン・モードのREUSE_DATAFILES
パラメータでは、インポート・ジョブで表領域の作成に既存のデータ・ファイルを再利用するかどうかを指定します。 - TABLES
Oracle Data Pump Importのコマンドライン・モードのTABLES
パラメータにより、表モード・インポートを実行することを指定します。 - TABLESPACES
Oracle Data Pump Importのコマンドライン・モードのTABLESPACES
パラメータにより、表領域モード・インポートを実行することを指定します。 - TARGET_EDITION
Oracle Data Pump Importのコマンドライン・モードのTARGET_EDITION
パラメータにより、オブジェクトをインポートするデータベース・エディションを指定します。 - TRANSFORM
Oracle Data Pump Importのコマンドライン・モードのTRANSFORM
パラメータを使用すると、インポート中のオブジェクトに対するオブジェクト作成DDLを変更できます。 - TRANSPORT_DATAFILES
Oracle Data Pump Importのコマンドライン・モードのTRANSPORT_DATAFILES
パラメータでは、エクスポート中にTRANSPORTABLE=ALWAYS
が設定された場合にターゲット・データベースにインポートするデータ・ファイルのリストを指定します。 - TRANSPORT_FULL_CHECK
Oracle Data Pump Importのコマンドライン・モードのTRANSPORT_FULL_CHECK
パラメータでは、指定したトランスポータブル表領域セットが他の表領域内のオブジェクトによって参照されていることを確認するかどうかを指定します。 - TRANSPORT_TABLESPACES
Oracle Data Pump Importのコマンドライン・モードのTRANSPORT_TABLESPACES
パラメータにより、データベース・リンク経由でトランスポータブル表領域モードでのインポートを実行することを指定します。 - TRANSPORTABLE
Oracle Data Pump Importのコマンドライン・モードのTRANSPORTABLE
パラメータにより、表モード・インポートまたは全体モード・インポートの際にトランスポータブル・オプションを使用するかどうかを指定します。 - VERSION
Oracle Data Pump Importのコマンドライン・モードのVERSION
パラメータでは、インポートするデータベース・オブジェクトのバージョンを指定します。 - VIEWS_AS_TABLES (ネットワーク・インポート)
Oracle Data Pump Importのコマンドライン・モードのVIEWS_AS_TABLES
(ネットワーク・インポート)パラメータでは、1つ以上のビューを表としてインポートすることを指定します。
関連トピック
親トピック: Oracleデータ・ポンプ・インポート
3.4.1 インポート・コマンドライン・モードについて
大/小文字の区別、引用符、エスケープ文字、例の使用方法に関する情報など、コマンドライン・モードでOracle Data Pump Importパラメータを使用する方法について学習します。
Oracle Data Pumpインポート・パラメータを使用する前に、次の項を参照してください。
-
インポート・パラメータの指定
-
データ・ポンプ・コマンドラインでの引用符の使用
ここで説明する内容の多くは、パラメータの使用例を含みます。使用例を実行するために必要な環境の設定の詳細は、次の項を参照してください。
-
インポート・パラメータの使用例
インポート・パラメータの指定
値を複数個指定できるパラメータでは、カンマまたは空白で値を区切ることができます。たとえば、TABLES=employees,jobs
またはTABLES=employees jobs
のように指定できます。
入力するパラメータごとに、等号(=)と値を入力する必要があります。それ以外の方法では、1つ前のパラメータ指定がどこで完了し、新しいパラメータ指定がどこから始まるかをデータ・ポンプに伝えることができません。たとえば、次のコマンドラインの場合、NOLOGFILE
は有効なパラメータですが、DUMPFILE
パラメータに対するダンプ・ファイル名がもう1つあると解釈されます。
impdp DIRECTORY=dpumpdir DUMPFILE=test.dmp NOLOGFILE TABLES=employees
その結果、test.dmp
およびnologfile.dmp
という2つのダンプ・ファイルが作成されることになります。
これを回避するには、NOLOGFILE=YES
またはNOLOGFILE=NO
のいずれかを指定します。
パラメータ値を指定する場合の大/小文字の区別
パラメータ値として入力される表領域名、スキーマ名、表名などについて、Oracle Data Pumpは、小文字または大/小文字混在で入力された値をデフォルトで大文字に変更します。たとえば、TABLE=hr.employees
と入力すると、それはTABLE=HR.EMPLOYEES
に変更されます。大/小文字を維持するには、引用符で値を囲む必要があります。たとえば、TABLE="hr.employees"
とすると、表名がすべて小文字のまま維持されます。入力する名前は、データベースに格納されている名前と完全に一致する必要があります。
データ・ポンプ・コマンドラインでの引用符の使用
一部のオペレーティング・システムでは引用符が特殊文字として処理されるため、バックスラッシュ(\)などのエスケープ文字を前に付けないと、アプリケーションに正しく渡されません。これは、コマンドラインとパラメータ・ファイル内の両方に当てはまります。また、オペレーティング・システムによっては、コマンドラインで、特殊文字を含むパラメータ値全体を一重引用符または二重引用符で囲む必要があります。
次の例では、これらの概念を説明します。特定のオペレーティング・システムに該当しない場合があること、および各ユーザーに固有の運用環境は想定していないことに注意してください。
次のように、パラメータ・ファイルでTABLES
パラメータを指定するとします。
TABLES = \"MixedCaseTableName\"
これをコマンドラインで指定するとき、一部のオペレーティング・システムでは、次のように一重引用符で囲む必要があります。
TABLES = '\"MixedCaseTableName\"'
コマンドラインで追加の引用符を指定せずに手順を続行するには、パラメータ・ファイルを使用することをお薦めします。また、パラメータ・ファイルを使用し、指定するパラメータ値の文字列の最初の文字に引用符を使用しない場合(たとえば、TABLES=scott."EmP"
)は、エスケープ文字の使用が不要になるシステムがあることに注意してください。
インポート・パラメータの使用例
各項に示す例を試行する場合は、次の内容に注意してください。
-
例に示すようにユーザー名およびパラメータを入力した後、インポート・ユーティリティが起動され、パスワードの入力が要求されます。データベース接続が行われる前に、パスワードを入力する必要があります。
-
ここに示す例の多くは、Oracle Databaseのインストール時にデフォルトでインストールされるシード・データベースのサンプル・スキーマを使用しています。特に、人事管理(
hr
)スキーマを頻繁に使用します。 -
インポートするダンプ・ファイルを指定する例では、そのダンプ・ファイルが存在するものとします。可能なかぎり、Exportの例を実行して生成されるダンプ・ファイルを使用します。
-
この例では、ディレクトリ・オブジェクト
dpump_dir1
およびdpump_dir2
がすでに存在し、これらのディレクトリ・オブジェクトについてのREAD
権限およびWRITE
権限が、hr
ユーザーに付与されているものとします。 -
一部の例では、
DATAPUMP_EXP_FULL_DATABASE
ロールおよびDATAPUMP_IMP_FULL_DATABASE
ロールが必要です。その例では、hr
ユーザーにこれらのロールが付与されているものとします。
必要に応じて、これらのディレクトリ・オブジェクトの作成と、必要な権限やロールの割当てをDBAに依頼します。
特に指定がないかぎり、これらのパラメータはパラメータ・ファイルでも指定できます。
3.4.2 ABORT_STEP
Oracle Data Pumpインポートのコマンドライン・モードのABORT_STEP
パラメータでは、ジョブの初期化後に、そのジョブを停止します。ジョブを停止すると、データがインポートされる前にデータ・ポンプ制御ジョブ表を問い合せることができます。
デフォルト
Null
用途
ジョブの初期化後に、そのジョブを停止します。ジョブを停止すると、データがインポートされる前にデータ・ポンプ制御ジョブ表を問い合せることができます。
構文および説明
ABORT_STEP=[n | -1]
可能な値は、データ・ポンプ制御ジョブ表のプロセス順序番号に対応します。各番号の使用結果は次のとおりです。
-
n
: 値がゼロ以上の場合、インポート操作が開始されます。ジョブは、対応するプロセス順序番号とともにデータ・ポンプ制御ジョブ表に格納されているオブジェクトで停止されます。 -
-1
インポート・ジョブでNETWORK_LINK
を使用する場合: ジョブは、その設定後、いずれかのオブジェクトがインポートされる前に中断されます。 -
-1
インポート・ジョブがNETWORK_LINK
を使用しないインポートの場合: ジョブは、マスター表をロードしてフィルタを適用した後に中断されます。
制限事項
-
なし
例
> impdp hr SCHEMAS=hr DIRECTORY=dpump_dir1 LOGFILE=schemas.log
DUMPFILE=expdat.dmp ABORT_STEP=-1
3.4.3 ACCESS_METHOD
Orale Data Pump Importのコマンドライン・モードのACCESS_METHOD
パラメータでは、インポートでデータのロードに特定の方法を使用することを指定します
デフォルト
AUTOMATIC
用途
インポート・ユーティリティで特定のメソッドを使用してデータをロードするように指定します。
構文および説明
ACCESS_METHOD=[AUTOMATIC | DIRECT_PATH | EXTERNAL_TABLE | CONVENTIONAL_PATH | INSERT_AS_SELECT]
デフォルトのメソッドがなんらかの理由で動作しない場合に別のネイティブ・メソッドを試行できるように、ACCESS_METHOD
パラメータが提供されます。指定したアクセス方法で表のデータをロードできない場合は、データに表のエラーが表示され、次の作業項目に進みます。
使用可能なオプションは次のとおりです。
-
AUTOMATIC
: このアクセス方法はデフォルトです。それぞれの表について、データをロードする最適な方法がデータ・ポンプによって判断されます。できるだけAUTOMATIC
を使用することをお薦めします。これは、データ・ポンプが最も効果的な方法を自動的に選択できるようになるためです。 -
DIRECT_PATH
: データ・ポンプによって、すべての表に対して、ダイレクト・パス・ロードが使用されます。 -
EXTERNAL_TABLE
: データ・ポンプによって、ダンプ・ファイルに格納されているデータに対する外部表が作成され、SQL文INSERT AS SELECT
を使用してデータが表にロードされます。データ・ポンプによって、APPEND
ヒントがINSERT
文に適用されます。 -
CONVENTIONAL_PATH
: データ・ポンプによって、ダンプ・ファイルに格納されているデータに対する外部表が作成され、外部表から1つずつ行が読み取られます。データ・ポンプでは、行を読み取るたびにinsert文を実行して、その行をターゲット表にロードします。この方法は、データのロードに時間がかかるものの、ダイレクト・パスおよび外部表によってロードできないデータをロードする唯一の方法となります。 -
INSERT_AS_SELECT
: データ・ポンプによって、リモート・データベースからデータを選択するSQL文INSERT AS SELECT
を実行することによって表がロードされ、ターゲット表に挿入されます。このオプションは、ネットワーク・モード・インポートでのみ使用できます。ネットワーク経由でデータを移動するときにDIRECT_PATH
の使用を無効にする場合は、これを使用します。
制限事項
-
ネットワーク・モード・インポートで有効なオプションは、
AUTOMATIC
、DIRECT_PATH
およびINSERT_AS_SELECT
です。 -
ダンプ・ファイルからインポートするときに有効なオプションは、
AUTOMATIC
、DIRECT_PATH
、EXTERNAL_TABLE
およびCONVENTIONAL_PATH
のみです。 -
ネットワーク・インポートで
ACCESS_METHOD
パラメータを使用するには、Oracle Database 12c リリース2 (12.2.0.1)以上を使用している必要があります。 -
Oracle Data Pump Importの
ACCESS_METHOD
パラメータは、トランスポータブル表領域のジョブに対して有効ではありません。
例
次の例では、Oracle Data Pumpで既存の表SALES
の複数のパーティションのデータを同時にロードできます。
impdp hr SCHEMAS=hr DIRECTORY=dpump_dir1 LOGFILE=schemas.log
DUMPFILE=expdat.dmp ACCESS_METHOD=CONVENTIONAL
3.4.4 ATTACH
Oracle Data Pump Importインポートのコマンドライン・モードのATTACH
パラメータでは、クライアント・セッションを既存のインポート・ジョブに接続し、自動的に対話方式コマンド・モードにします。
デフォルト
実行中のジョブが1つのみの場合は、ユーザーのスキーマの現在のジョブ。
用途
このコマンドは、クライアント・セッションを既存のインポート・ジョブに接続し、自動的に対話方式コマンド・モードにします。
構文および説明
ATTACH [=[schema_name.]job_name]
schema_name
は、接続しているスキーマが、自分のスキーマにない場合に指定します。これを行うには、DATAPUMP_IMP_FULL_DATABASE
ロールが必要となります。
job_name
は、スキーマに対応する実行中ジョブが1つのみで、そのジョブがアクティブな場合、指定する必要はありません。停止しているジョブに接続する場合は、このジョブ名を指定する必要があります。DBA_DATAPUMP_JOBS
ビューまたはUSER_DATAPUMP_JOBS
ビューを問い合せて、Oracle Data Pumpジョブ名の一覧を表示できます。
ジョブに接続している場合、インポート・ユーティリティでは、ジョブの説明が表示され、次にインポート・プロンプトが表示されます。
制限事項
ATTACH
パラメータを指定する場合、コマンドラインで他に指定できるデータ・ポンプ・パラメータは、ENCRYPTION_PASSWORD
のみです。- 接続するジョブが最初に暗号化パスワードを使用して起動している場合、そのジョブへの接続時に、コマンドライン上の
ENCRYPTION_PASSWORD
パラメータを再入力してそのパスワードを再指定する必要があります。 - そのジョブが実行中でなければ、別のスキーマのジョブに接続することはできません。
- ジョブのダンプ・ファイル・セットまたはマスター表が削除されている場合、接続操作は失敗します。
- マスター表を変更すると、それがどのような変更であっても、予期しない結果になる場合があります。
例
次に、ATTACH
パラメータの使用例を示します。
> impdp hr ATTACH=import_job
この例では、import_job
というジョブが、hr
スキーマに存在するとします。
3.4.5 CLUSTER
Oracle Data Pump Importのコマンドライン・モードのCLUSTER
パラメータでは、データ・ポンプでOracle Real Application Clusters (Oracle RAC)リソースを使用できるかどうかと、ワーカーを他のOracle RACインスタンス上で開始できるかどうかを指定します。
デフォルト
YES
用途
Oracle Data PumpでOracle Real Application Clusters (Oracle RAC)リソースを使用できるかどうかと、ワーカーを他のOracle RACインスタンス上で開始できるかどうかを指定します。
構文および説明
CLUSTER=[YES | NO]
データ・ポンプ・インポートで、ジョブが開始されたインスタンスのみを使用し、Oracle Database 11g リリース2 (11.2)より前の動作と同じにするには、CLUSTER=NO
を指定します。
特定の既存サービスを指定し、そのサービスに定義されたインスタンスでのみ実行されるようにワーカー・プロセスを制限するには、SERVICE_NAME
パラメータをCLUSTER=YES
パラメータとともに使用します。
CLUSTER
パラメータを使用すると、インポート・ジョブをOracle RACインスタンス間で分散するための追加のオーバーヘッドが発生するため、パフォーマンスに影響する場合があります。ジョブが小さいときは、CLUSTER=NO
を指定して、ジョブが開始されたインスタンス上のみでジョブを実行した方がよい場合もあります。CLUSTER
パラメータを使用してジョブのパフォーマンスが最もよくなるのは、ジョブのデータ量が多い場合です。
例
> impdp hr DIRECTORY=dpump_dir1 SCHEMAS=hr CLUSTER=NO PARALLEL=3 NETWORK_LINK=dbs1
この例では、hr
スキーマのスキーマ・モード・インポートを実行します。CLUSTER=NO
が使用されているため、ジョブでは起動時のインスタンスのみが使用されます。最大3つまでのパラレル処理を使用できます。dbs1
のNETWORK_LINK
値は、データのインポート元であるソース・データベース名に置き換えます。(これはネットワーク・インポートであるため、ダンプ・ファイルは生成されません。)
この例では、NETWORK_LINK
パラメータは例の一部としてのみ使用されます。CLUSTER
パラメータの使用時は必須ではありません。
3.4.6 CONTENT
Oracle Data Pump Importのコマンドライン・モードのCONTENT
パラメータを使用すると、インポート操作中にロード対象をフィルタ処理できます。
デフォルト
ALL
用途
インポート操作でロードする内容をフィルタ処理できます。
構文および説明
CONTENT=[ALL | DATA_ONLY | METADATA_ONLY]
-
ALL
:を指定すると、ソースに含まれているすべてのデータおよびメタデータがロードされます。これはデフォルトです。 -
DATA_ONLY
: 表の行データのみが既存の表にロードされます。データベース・オブジェクトは作成されません。 -
METADATA_ONLY
: データベース・オブジェクト定義のみがロードされます。表の行データはロードされません。CONTENT=METADATA_ONLY
を指定した場合、ダンプ・ファイルからインポートされる任意の索引または表の統計は、インポート操作の完了後にロックされることに注意してください。
制限事項
-
CONTENT=METADATA_ONLY
パラメータおよび値は、TRANSPORT_TABLESPACES
(トランスポータブル表領域モード)パラメータまたはQUERY
パラメータと組み合せて使用することはできません。 -
CONTENT=ALL
およびCONTENT=DATA_ONLY
パラメータおよび値は、SQLFILE
パラメータと組み合せて使用することはできません。
例
次に、CONTENT
パラメータの使用例を示します。この例では、ExportのFULL
パラメータで示した例を実行して、expfull.dmp
ダンプ・ファイルを作成できます。
> impdp hr DIRECTORY=dpump_dir1 DUMPFILE=expfull.dmp CONTENT=METADATA_ONLY
このコマンドにより、expfull.dmp
ダンプ・ファイル内のメタデータのみをロードする全体インポートが実行されます。全体インポートが実行されるのは、インポート・モードを指定しないファイル・ベースのインポートでは、全体インポートがデフォルトであるためです。
関連トピック
3.4.7 CREDENTIAL
Oracle Data Pumpインポートのコマンドライン・モードのCREDENTIAL
パラメータでは、データベース・ユーザーが所有する資格証明オブジェクトの名前を指定します。インポート・ユーティリティは、このオブジェクト名を使用してクラウド・ストレージにインポートされるダンプ・ファイルセットのファイルを処理します。
デフォルト
none
用途
Oracle Cloud Infrastructureのクラウド・ストレージにインポートされたダンプ・ファイル・セット内のファイルを処理するためにインポート・ユーティリティによって使用される、データベース・ユーザーが所有する資格証明オブジェクト名を指定します。
構文および説明
CREDENTIAL=credential_object_name
インポート操作では、クラウドに格納されているダンプ・ファイル・セット内のファイルを、ローカル・ファイル・システムに格納されているファイルと同じように読み取り、処理します。
CREDENTIAL
パラメータを指定した場合は、DUMPFILE
パラメータの値をカンマ区切りの文字列のリストにします。インポート・ユーティリティでは、このリストがURI
の値として処理されます。Oracle Database 19c以降では、ダンプ・ファイル・セット内のURI
ファイルにデータ・ポンプ置換変数(%U
や%L
など)が含まれているテンプレートを含めることができます。たとえば、urlpathexp%U.dmp
です。
ノート:
置換変数は、ファイル名のURI
部分にのみ使用できます。
DUMPFILE
パラメータを使用すると、ユーザーはオプションのディレクトリ・オブジェクトを指定できます。このオブジェクトの指定には、directory_object _name:file_name
の形式を使用します。ただし、CREDENTIAL
パラメータを指定すると、インポート・ユーティリティはDUMPFILE
で渡される文字列内のディレクトリ・オブジェクト名を検索しなくなります。そのかわりに、文字列はURI
文字列として処理されます。
DIRECTORY
パラメータは、ログ・ファイルとSQL
ファイルの場所として引き続き使用されます。また、LOGFILE
とSQLFILE
のファイル名の一部として引き続きディレクトリ・オブジェクト名を指定することもできます。
Oracleデータ・ポンプ・インポートでは、Oracle Autonomous Databaseのdefault_credential
値の使用に対する制約がなくなりました。インポート・ユーティリティのCREDENTIAL
パラメータには、Oracle Autonomous Databaseで作成されたOracle Cloud Infrastructure (OCI)オブジェクト・ストレージの資格証明を指定できるようになりました。この資格証明は、DBMS_CLOUD.CREATE_CREDENTIAL()
プロシージャを使用してデータベースに追加します。Oracleデータ・ポンプは、資格証明が存在しているかどうかと、ユーザーに資格証明の読取りアクセス権が付与されているかどうかを検証します。エラーはimpdp
クライアントに返されます。
制限事項
資格証明パラメータは、OCIリソース・プリンシパル、Azureサービス・プリンシパル、Amazonリソース名(ARN)またはGoogleサービス・アカウントにはできません。
例: インポート・ユーティリティのCREDENTIALパラメータの使用
次に、インポート・ユーティリティのCREDENTIAL
パラメータの使用例を示します。この例で使用されているダンプ・ファイルを作成するには、エクスポート・ユーティリティのDUMPFILE
パラメータに示した例を実行します。そのダンプ・ファイルをクラウド・ストレージにアップロードしておきます。
> impdp hr/your_password DIRECTORY=dpump_dir1 CREDENTIAL=user_accessible_credential
DUMPFILE=’https://objectstorage.example.com/exp1.dmp’,
’https://objectstorage.example.com/exp201.dmp’,
’https://objectstorage.example.com/exp202.dmp’
インポート・ジョブでは、そのダンプ・ファイルに指定されたクラウド・ストレージが検索されます。ログ・ファイルは、DIRECTORY
パラメータで指定されたディレクトリ・オブジェクトdpump_dir1
,に関連付けられたパスに書き込まれます。
例: ユーザー定義資格証明の指定
次の例では、Oracle Autonomous Database内に新しいユーザー定義資格証明を作成して、それと同じ資格証明をimpdp
コマンドで使用しています。
BEGIN
DBMS_CLOUD.CREATE_CREDENTIAL(
credential_name => ‘MY_CRED_NAME’,
username => 'adwc_user@example.com’,
password => ‘Auth token' ); END;
> impdp admin/password@ADWC1_high
directory=data_pump_dir
credential=MY_cred_name …
3.4.8 DATA_OPTIONS
Oracle Data Pump Importのコマンドライン・モードのDATA_OPTIONS
パラメータでは、インポート操作中に特定のタイプのデータをどのように処理するかを指定します。
デフォルト
デフォルトはありませんこのパラメータが使用されていない場合、このパラメータが提供する特別なデータ処理オプションは無効になります。
用途
DATA_OPTIONS
パラメータでは、インポート操作中に特定のタイプのデータをどのように処理するかを指定します。
構文および説明
DATA_OPTIONS = [DISABLE_APPEND_HINT | SKIP_CONSTRAINT_ERRORS | REJECT_ROWS_WITH_REPL_CHAR | GROUP_PARTITION_TABLE_DATA | TRUST_EXISTING_TABLE_PARTITIONS | VALIDATE_TABLE_DATA | ENABLE_NETWORK_COMPRESSION | CONTINUE_LOAD_ON_FORMAT_ERROR]
-
DISABLE_APPEND_HINT
: インポート操作で、データ・オブジェクトのロード時にAPPEND
ヒントを使用しないことを指定します。APPEND
ヒントを無効化すると、重複データへの対処に役立ちます。たとえば、ロード対象のデータ・オブジェクトの小規模なセットがデータベースにすでに存在し、他の一部のアプリケーションから1つ以上のデータ・オブジェクトに同時にアクセス可能な場合は、DISABLE_APPEND_HINT
を使用できます。DISABLE_APPEND_HINT
: デフォルトの動作を変更して、データ・オブジェクトのロードにAPPEND
ヒントが使用されないようにします。設定しない場合、デフォルトでは、データ・オブジェクトのロードにAPPEND
ヒントが使用されます。 -
GROUP_PARTITION_TABLE_DATA
: 表のすべてのパーティションに1回の操作として表データをインポートするようにOracleデータポンプに指示します。デフォルトの動作では、各表パーティションが個別の操作としてインポートされます。インポート・ユーティリティでは、このデフォルトが選択されます。たとえば、このパーティションが設定されているときに、インポートの一環として表をロードする際に表が別のパーティションに移動される可能性があると、Oracleデータ・ポンプは表データを1つのパーティションにグループ化します。さらに、Oracleデータ・ポンプはインポート操作で作成された表に対する1つの操作として表のすべてのパーティションをグループ化します。 -
REJECT_ROWS_WITH_REPL_CHAR
: 文字セットの変換中にデフォルトの置換文字が使用されていたためにデータ損失が発生したすべての行をインポート操作で拒否するように指定します。REJECT_ROWS_WITH_REPL_CHAR
が設定されていない場合、デフォルトの動作では、置換文字で変換された行がロードされます。 -
SKIP_CONSTRAINT_ERRORS
: データ・オブジェクト(表、パーティションまたはサブパーティション)をロードする際の、非遅延制約違反の処理方法に適用されます。遅延制約違反が発生しても、
SKIP_CONSTRAINT_ERRORS
によるロードへの影響はありません。遅延制約違反は常に、ロード全体のロール・バックの原因となります。SKIP_CONSTRAINT_ERRORS
オプションでは、非遅延の制約違反が発生した場合もインポート操作を続行することを指定します。非遅延の制約違反の原因となっているすべての行はログに記録されますが、違反が発生しているデータ・オブジェクトのロードは停止されません。SKIP_CONSTRAINT_ERRORS
: 非遅延の制約違反が発生した場合に、データ・オブジェクト全体のロールバックを防ぎます。SKIP_CONSTRAINT_ERRORS
が設定されていない場合のデフォルトの動作では、非遅延の制約違反が発生しているデータ・オブジェクトのロード全体がロール・バックされます。 -
TRUST_EXISTING_TABLE_PARTITIONS
: パーティション・データをパラレルで既存の表にロードするようにOracle Data Pumpに指示します。Oracle Data Pumpを使用してエクスポート・データベース内の定義から表を作成した後で表データ・インポートを開始する場合は、このオプションを使用します。通常、このパラメータは、メタデータが静的で、データを移行するためにデータベースをオフラインにする前に移動可能な場合に、移行の一環として使用します。メタデータを別々に移動すると、停止時間が最小限になります。このオプションを使用した場合、データベースの他の属性(文字セットなど)が同じであれば、エクスポート・データベースからのデータはインポート・データベース内の同じパーティションに移動します。
表はデータ・ポンプの外部で作成できます。ただし、Oracle Data Pumpを使用する以外の方法で表を作成する場合は、パーティション属性およびパーティション名をエクスポート・データベースと同じにする必要があります。
-
VALIDATE_TABLE_DATA
: 表のデータ列内の数値および日付データ型を検査するようにOracle Data Pumpに指示します。インポートで無効なデータが検出された場合、
ORA-39376
エラーが.log
ファイルに書き込まれます。エラー・テキストには列名が含まれます。デフォルトでは妥当性チェックは行われません。Oracle Data Pumpのダンプ・ファイルのソースを信頼できない場合は、このオプションを使用します。 -
ENABLE_NETWORK_COMPRESSION
: リモート表データをロードするためのOracle Data PumpのACCESS_METHOD
パラメータがDIRECT_PATH
に設定されている場合に、ネットワーク・インポートで使用されます。ENABLE_NETWORK_COMPRESSION
を指定すると、Oracle Data Pumpによってリモート・ノード上のデータが圧縮され、ネットワーク経由でターゲット・データベースに送信された後、そこで解凍されます。リモート・データベースとローカル・データベースの間のネットワーク接続の速度が低い場合は、ネットワークを経由して送信されるデータの量が減少するため、このオプションが役立ちます。ACCESS_METHOD=AUTOMATIC
に設定すると、Oracle Data Pumpで、ネットワーク・インポートにDIRECT_PATH
が使用されている場合に、インポート中にENABLE_NETWORK_COMPRESSION
を自動的に設定できます。データ・ポンプがダンプ・ファイルからデータをインポートする場合、リモート・データベースがOracle Database 12c リリース2 (12.2)より前の場合、または
INSERT_AS_SELECT
文を使用してリモート・データベースからデータをロードする場合、ENABLE_NETWORK_COMPRESSION
オプションは無視されます。 -
CONTINUE_LOAD_ON_FORMAT_ERROR
: 表のデータをロード中にストリーム書式エラーが発生した場合に次のグラニュルの開始点にスキップするように、Oracle Data Pumpに指示します。通常、ストリーム書式エラーは、ダンプ・ファイルの破損によって発生します。Oracle Data Pumpでストリーム書式エラーが発生したときに、元のエクスポート・データベースを使用して表データを再度エクスポートできない場合は、
CONTINUE_LOAD_ON_FORMAT_ERROR
を使用します。Oracle Data Pumpでデータがスキップされた場合、ソース・データベースからデータの一部がインポートされず、数百または数千の行がスキップされる可能性があります。
制限事項
-
DISABLE_APPEND_HINT
を使用すると、データ・オブジェクトのロードにかかる時間が長くなる場合があります。 -
SKIP_CONSTRAINT_ERRORS
を使用し、データ・オブジェクトにロード時に定義された一意の索引または制約が含まれる場合、そのデータ・オブジェクトをロードする際にAPPEND
ヒントは使用されません。したがって、SKIP_CONSTRAINT_ERRORS
オプションを使用した場合、このようなデータ・オブジェクトのロードにはさらに時間がかかる可能性があります。 -
データ・オブジェクトが外部表によるアクセス方法を使用せずにロードされている場合、
SKIP_CONSTRAINT_ERRORS
は、たとえ指定されていても使用されません。
例
この例では、SKIP_CONSTRAINT_ERRORS
が有効化されているデータのみの表モード・インポートを示します。
> impdp hr TABLES=employees CONTENT=DATA_ONLY
DUMPFILE=dpump_dir1:table.dmp DATA_OPTIONS=skip_constraint_errors
このインポート操作中に非遅延の制約違反が発生した場合、これらの違反はログに記録されます。インポートは完了するまで続行します。
3.4.9 DIRECTORY
Oracle Data Pump Importのコマンドライン・モードのDIRECTORY
パラメータでは、インポート・ジョブでのダンプ・ファイル・セットの検索先およびログ・ファイルとSQLファイルの作成先となるデフォルトの場所を指定します。
デフォルト
DATA_PUMP_DIR
用途
インポート・ジョブがダンプ・ファイル・セットを検出し、ログ・ファイルおよびSQLファイルが作成されるデフォルトの位置を指定します。
構文および説明
DIRECTORY=directory_object
directory_object
は、データベース・ディレクトリ・オブジェクトの名前です。実際のディレクトリのファイル・パスではありません。特権ユーザーにDATA_PUMP_DIR
という名前のデフォルトのディレクトリ・オブジェクトへのアクセス権が付与されます。DATA_PUMP_DIR
ディレクトリの定義は、アップグレード時またはパッチの適用時にOracleによって変更される可能性があります。
デフォルトのDATA_PUMP_DIR
ディレクトリ・オブジェクトにアクセス可能なユーザーは、DIRECTORY
パラメータを使用する必要はありません。
DUMPFILE
パラメータ、LOGFILE
パラメータまたはSQLFILE
パラメータで指定したディレクトリ・オブジェクトは、DIRECTORY
パラメータに指定したディレクトリ・オブジェクトよりも優先されます。ダンプ・ファイル・セットに使用されるディレクトリへの読取りアクセス権が必要です。ログ・ファイルおよびSQLファイルの作成に使用するディレクトリへの書込みアクセス権が必要です。
例
次に、DIRECTORY
パラメータの使用例を示します。この例では、ExportのFULL
パラメータで示した例を実行して、expfull.dmp
ダンプ・ファイルを作成できます。
> impdp hr DIRECTORY=dpump_dir1 DUMPFILE=expfull.dmp
LOGFILE=dpump_dir2:expfull.log
このコマンドによって、インポート・ジョブが、dpump_dir1
ディレクトリ・オブジェクトに示されたディレクトリのexpfull.dmp
ダンプ・ファイルを検索します。LOGFILE
パラメータに指定したdpump_dir2
ディレクトリ・オブジェクトは、DIRECTORY
パラメータよりも優先されるため、ログ・ファイルは、dpump_dir2
に書き込まれます。CREATE DIRECTORYコマンドの詳細は、Oracle Database SQL言語リファレンスを参照してください。
関連トピック
- ダンプ・ファイル、ログ・ファイルおよびSQLファイルのデフォルトの位置の理解
- Oracle RACでのOracle Data Pumpの使用方法の理解
- 『Oracle Database SQL言語リファレンス』のCREATE DIRECTORYに関する項
3.4.10 DUMPFILE
Oracle Data Pump Importのコマンドライン・モードのDUMPFILE
パラメータでは、エクスポート・ユーティリティによって作成されたダンプ・ファイル・セットの名前を指定し、オプションで、これらのディレクトリ・オブジェクトを指定します。
デフォルト
expdat.dmp
用途
エクスポート・ユーティリティによって作成されたダンプ・ファイル・セットの名前を指定します。そのセットのディレクトリ・オブジェクトまたはデフォルトの資格証明も指定できます。
構文および説明
DUMPFILE=[directory_object:]file_name [, ...]
または
DUMPFILE=[DEFAULT_CREDENTIAL:]URI_file [, ...]
DIRECTORY
パラメータですでに指定されている場合、directory_object
はオプションです。値を指定する場合は、すでに存在し、かつ自分にアクセス権があるディレクトリ・オブジェクトにする必要があります。DUMPFILE
パラメータの一部に指定されるデータベース・ディレクトリ・オブジェクトは、DIRECTORY
パラメータで指定された値よりも優先されます。
file_name
には、ダンプ・ファイル・セット内のファイルの名前を指定します。ファイル名には、置換変数%U
を含むテンプレートを指定することもできます。インポート・プロセスでは、各ファイルがテンプレートと一致するかどうかがチェックされます。ダンプ・ファイル・セットに含まれるすべてのファイルは、一致するファイルがなくなるまで検索されます。DUMPFILE
パラメータで定義されたファイルの指定にセット全体が含まれている場合は、インポート・ユーティリティでセット全体を見つけるために十分な情報がファイルに含まれます。ファイルの名前、位置または順序は、エクスポート時に使用されたものと同じである必要はありません。
次の表に、使用可能な置換変数を示します。
置換変数 | 説明 |
---|---|
|
%U を使用すると、%U が01 から増加する2桁の整数に変換されます。
|
|
システムによって生成される一意のファイル名を指定します。
ファイル名には、複数のファイルを生成できることを示す置換変数( たとえば、現在の整数が1の場合、
exp%Laa%L.dmp は次の順序に解決されます
2桁の増加が99まで続きます。その後、次のファイル名は3桁の増加に置換されます。
3桁の増加が999まで続きます。その後のファイル名は4桁の増加に置換されます。最大許容置換数(2147483646)まで、置換が続きます。 |
制限事項
-
Oracle Data Pumpのパラメータ
VERSION=12
を使用してOracle Database 11gリリースで作成したダンプ・ファイルは、Oracle Database 12cリリース1 (12.1)以降でのみインポートできます。
インポート・ユーティリティのDUMPFILEパラメータの使用例
この例では、ExportのDUMPFILE
パラメータで示した例を実行して、ダンプ・ファイルを作成できます。
> impdp hr DIRECTORY=dpump_dir1 DUMPFILE=dpump_dir2:exp1.dmp, exp2%U.dmp
exp1.dmp
ダンプ・ファイルにディレクトリ・オブジェクト(dpump_dir2
)が指定されているため、インポート・ジョブは、そのファイルを検索します。また、dpump_dir1
にある、exp2nn.dmp
の形式のダンプ・ファイルも検索します。ログ・ファイルはdpump_dir1
に書き込まれます。
インポート・ユーティリティのDUMPFILE
パラメータに代替のDEFAULT_CREDENTIAL
キーワード構文を使用する場合は、ユーザー・アクセス権を持つデフォルトの資格証明が事前に存在している必要があります。インポート操作では、デフォルトの資格証明を使用して、指定したURI_file
の場所のクラウドに格納されたダンプ・ファイル・セット内のファイルを読み取って処理します。
変数URI_file
は、ダンプ・ファイルセット内のURIファイルの名前を表します。このファイル名は、データ・ポンプ置換変数(%U
や%L
など)が含まれているテンプレートと同じ名前にはできません。
DUMPFILE
パラメータのDEFAULT_CREDENTIAL
キーワード構文は、directory_object
構文と相互に排他的です。同じコマンドラインで使用できるフォームは1つのみです。
ユーザー定義資格証明を指定したインポート・ユーティリティのDUMPFILEの使用例
この例では、インポート・ジョブがダンプ・ファイル・セットを検索してログ・ファイルとSQLファイルを作成できるデフォルトの場所を指定しています。また、以前にクラウド・ストレージにインポートしたダンプ・ファイル・セット内のファイルを処理するために、インポート・ユーティリティで使用するデータベース・ユーザーが所有する資格証明オブジェクトの名前も指定しています。
> impdp admin/password@ADWC1_high
directory=data_pump_dir
credential=MY_cred_name …
DEFAULT_CREDENTIALキーワードを指定したインポート・ユーティリティのDUMPFILEパラメータの使用例。
この例では、ExportのDUMPFILE
パラメータで示した例を実行して、ダンプ・ファイルを作成できます。
> impdp hr/your_password DIRECTORY=dpump_dir1
DUMPFILE=’DEFAULT_CREDENTIAL:https://objectstorage.example.com/exp1.dmp’,
’DEFAULT_CREDENTIAL:https://objectstorage.example.com/exp201.dmp’,
’DEFAULT_CREDENTIAL:https://objectstorage.example.com/exp202.dmp’
インポート・ジョブでは、ユーザーにすでに設定されているデフォルトの資格証明を使用して、指定されたURI_file
の場所でダンプ・ファイルが検索されます。ログ・ファイルは、DIRECTORY
パラメータで指定されたディレクトリ・オブジェクトdpump_dir1
に関連付けられたパスに書き込まれます。
ユーザー定義資格証明を指定したインポート・ユーティリティのDUMPFILEパラメータの使用例
この例では、インポート・ジョブがダンプ・ファイル・セットを検索してログ・ファイルとSQLファイルを作成できるデフォルトの場所を指定しています。また、以前にクラウド・ストレージにインポートしたダンプ・ファイル・セット内のファイルを処理するために、インポート・ユーティリティで使用するデータベース・ユーザーが所有する資格証明オブジェクトの名前も指定しています。
> impdp impdp admin/password@ADWC1_high DIRECTORY=data_pump_dir
DUMPFILE=’MY_cred_name:https://objectstorage.example.com/exp1.dmp’,
’MY_cred_name:https://objectstorage.example.com/exp201.dmp’,
’MY_cred_name:https://objectstorage.example.com/exp202.dmp’
3.4.11 ENABLE_SECURE_ROLES
Oracle Data Pumpインポートのコマンドライン・ユーティリティのENABLE_SECURE_ROLES
パラメータでは、エクスポート時の保護されているロールの誤用を防止します。
デフォルト
Oracle Database 19c以降のリリースでは、デフォルト値はNO
です。
用途
Oracleロールには、認証が必要なものがあります。そのようなロールをOracleデータ・ポンプ・インポートで使用する必要がある場合は、ENABLE_SECURE_ROLES
パラメータをYES
に設定することで明示的に使用可能にする必要があります。
構文
ENABLE_SECURE_ROLES=[NO|YES]
-
NO
: 認証が必要なOracleロールを使用できないようにします。 -
YES
: 認証が必要なOracleロールを使用可能にします。
例
impdp hr SCHEMAS=hr DIRECTORY=dpump_dir1 DUMPFILE=dpump_dir2:imp1.dmp,
imp2%U.dmp ENABLE_SECURE_ROLES=YES
3.4.12 ENCRYPTION_PASSWORD
Oracle Data Pump Importのコマンドライン・モードのENCRYPTION_PASSWORD
パラメータでは、ダンプ・ファイル・セット内の暗号化列のデータにアクセスするためのパスワードを指定します。これにより、暗号化されたダンプ・ファイル・セットへの不正なアクセスを防ぎます。
デフォルト
デフォルト値は設定されていません。ユーザーが値を指定します。
用途
ダンプ・ファイル・セット内の暗号化列のデータにアクセスするためのパスワードを指定します。これにより、暗号化されたダンプ・ファイル・セットへの不正なアクセスを防ぎます。
このパラメータは、全体トランスポータブル・エクスポートまたはインポート操作中に、暗号化された表領域および暗号化された列を含む表に関連するキーを転送する場合にも必要です。
入力したパスワードは画面に表示されます。パスワードを入力時に画面に表示しない場合、ENCRYPTION_PWD_PROMPT
パラメータを使用します。
構文および説明
ENCRYPTION_PASSWORD = password
このパラメータは、エクスポート操作で暗号化パスワードが指定された場合に、インポート操作で必要になります。このパスワードは、エクスポート操作で指定されたものと同じものを指定する必要があります。
制限事項
-
このパラメータを使用したエクスポート操作には、Oracle Database 11g以降のEnterprise Editionリリースが必要です。Standard Editionからのエクスポートに
ENCRYPTION_PASSWORD
を使用できないため、このパラメータをStandard EditionからEnterprise Editionへの移行に使用することはできません。このパラメータは、Enterprise EditionからStandard Editionへの移行に使用できます。 -
データ・ポンプの暗号化機能を使用するには、Oracle Advanced Securityオプションが有効である必要があります。Oracle Advanced Securityオプションのライセンス要件の詳細は、Oracle Databaseライセンス情報を参照してください。
-
ダンプ・ファイル・セットが暗号化の透過モードを使用して作成されている場合、
ENCRYPTION_PASSWORD
パラメータは無効です。 -
ENCRYPTION_PASSWORD
パラメータは、暗号化された表領域または暗号化された列を含む表がソース・データベースに存在するネットワーク・ベースの全体トランスポータブル・インポートでは必須です。 -
すべての列に対する暗号化属性は、エクスポートされた表の定義とターゲット表で一致している必要があります。たとえば、
EMP
表にEMPNO
という列があるとします。次のいずれの場合も、ソース表のEMP
列の暗号化属性が、ターゲット表のEMP
列の暗号化属性と一致していないためエラーになります。-
EMPNO
列を暗号化してEMP
表をエクスポートし、表をインポートする前にEMPNO
列から暗号化属性を削除する。 -
EMPNO
列を暗号化せずにEMP
表をエクスポートし、表をインポートする前にEMPNO
列の暗号化を有効にする。
-
例
次の例では、暗号化パスワード123456
を指定する必要があります。これは、ダンプ・ファイルdpcd2be1.dmp
の作成時に、そのパスワードが指定されたためです。
> impdp hr TABLES=employee_s_encrypt DIRECTORY=dpump_dir
DUMPFILE=dpcd2be1.dmp ENCRYPTION_PASSWORD=123456
インポート操作中、エクスポート操作時に暗号化されたemployee_s_encrypt
表のすべての列は、復号化されてからインポートされます。
3.4.13 ENCRYPTION_PWD_PROMPT
Oracle Data Pumpインポートのコマンドライン・モードのENCRYPTION_PWD_PROMPT
パラメータでは、データ・ポンプによって暗号化パスワードの入力を要求するかどうかを指定します。
デフォルト
NO
用途
Oracle Data Pumpによって暗号化パスワードの入力を要求するかどうかを指定します。
構文および説明
ENCRYPTION_PWD_PROMPT=[YES | NO]
コマンドラインでENCRYPTION_PWD_PROMPT=YES
を指定すると、暗号化パスワードの入力を求めるプロンプトがOracle Data Pumpに表示されます。値をYES
に指定しない場合は、コマンドラインでENCRYPTION_PASSWORD
パラメータを使用して暗号化パスワードを入力する必要があります。パラメータをYES
に設定する利点は、プロンプトが表示されたときに暗号化パスワードが画面に表示されないことです。対照的に、コマンドラインでENCRYPTION_PASSWORD
パラメータを使用してパスワードを入力すると、パスワードはプレーン・テキストで表示されます。
プロンプトで入力する暗号化パスワードは、ENCRYPTION_PASSWORD
パラメータで説明されているものと同じ基準に従います。
エクスポート操作で暗号化パスワードを指定した場合、インポート操作でもそれを指定する必要があります。
制限事項
ENCRYPTION_PWD_PROMPT
パラメータとENCRYPTION_PASSWORD
パラメータの同時使用は禁止されています。
例
次の例では、Oracle Data Pumpによって最初にユーザー・パスワードが要求され、次に暗号化パスワードが要求されます。
> impdp hr DIRECTORY=dpump_dir1 DUMPFILE=hr.dmp ENCRYPTION_PWD_PROMPT=YES
.
.
.
Copyright (c) 1982, 2017, Oracle and/or its affiliates. All rights reserved.
Password:
Connected to: Oracle Database 18c Enterprise Edition Release 18.0.0.0.0 - Development
Version 18.1.0.0.0
Encryption Password:
Master table "HR"."SYS_IMPORT_FULL_01" successfully loaded/unloaded
Starting "HR"."SYS_IMPORT_FULL_01": hr/******** directory=dpump_dir1 dumpfile=hr.dmp encryption_pwd_prompt=Y
.
.
.
3.4.14 ESTIMATE
Oracle Data Pumpインポートのコマンドライン・モードのESTIMATE
パラメータでは、ネットワーク・インポート操作のソース・システムに対して、インポート中に生成されるデータ量を見積もるように指定します。
デフォルト
STATISTICS
用途
ネットワーク・インポート操作のソース・システムに対して、インポート中に生成されるデータ量を見積もるように指定します。
構文および説明
ESTIMATE=[BLOCKS | STATISTICS]
ESTIMATE
パラメータでは、次の値を選択できます。
-
BLOCKS
: 見積りは、ソース・オブジェクトで使用されるデータベース・ブロックの数に、適切なブロック・サイズを掛けて計算されます。 -
STATISTICS
: 見積りは、表別の統計を使用して計算されます。この方法による見積りをできるかぎり正確にするには、すべての表を新しく分析しておく必要があります。(表の分析は、SQLANALYZE
文またはDBMS_STATS
PL/SQLパッケージのいずれかで実行可能です。)
生成された見積りを使用して、インポート全体で完了したインポート・ジョブの割合を判断できます。
制限事項
-
インポートの
ESTIMATE
パラメータは、NETWORK_LINK
パラメータも指定されている場合のみ有効です。 -
インポート・ソースがダンプ・ファイル・セットの場合、ロードされるデータの量がすでにわかっているため、完了率は自動的に計算されます。
-
QUERY
またはREMAP_DATA
パラメータのいずれかを使用している場合は、見積りが不正確になることがあります。
例
次の構文例では、変数source_database_link
をソース・データベースへの有効なリンク名で置き換えます。
> impdp hr TABLES=job_history NETWORK_LINK=source_database_link
DIRECTORY=dpump_dir1 ESTIMATE=STATISTICS
hr
スキーマのjob_history
表が、ソース・データベースからインポートされます。デフォルトでログ・ファイルが作成され、dpump_dir1
ディレクトリ・オブジェクトで示されたディレクトリに書き込まれます。ジョブが開始すると、表の統計に基づいて、そのジョブの見積りが計算されます。
3.4.15 EXCLUDE
Oracle Data Pump Importのコマンドライン・モードのEXCLUDE
パラメータを使用すると、インポート・ジョブから除外するオブジェクトとオブジェクト型を指定して、インポート対象のメタデータをフィルタ処理できます。
デフォルト
デフォルトはありません
用途
インポート・ジョブから除外するオブジェクトおよびオブジェクト型を指定して、インポートの対象となるメタデータをフィルタ処理できます。
構文および説明
EXCLUDE=object_type[:name_clause] [, ...]
object_type
は除外するオブジェクトのタイプを指定します。DATABASE_EXPORT_OBJECTS
(全体モードの場合)、SCHEMA_EXPORT_OBJECTS
(スキーマ・モードの場合)、TABLE_EXPORT_OBJECTS
(表および表領域モードの場合)ビューを問い合せて、object_type
の有効な値の一覧を表示できます。OBJECT_PATH
列にリストされる値が有効なオブジェクト・タイプです。
指定したインポート・モードでは、EXCLUDE
文に指定されたオブジェクト型を除き、ソースに含まれるすべてのオブジェクト型およびその依存オブジェクトが含まれます。オブジェクトが除外されると、そのオブジェクトのすべての依存オブジェクトも除外されます。たとえば、表を除外すると、その表のすべての索引およびトリガーも除外されます。
name_clause
は、オプションです。これを使用すると、あるオブジェクト型のうち、特定のオブジェクトをファイングレイン選択できます。その型のオブジェクト名に対するフィルタとして使用されるSQL式です。SQL演算子および指定した型のオブジェクト名の比較対象となる値で構成されています。name_clause
は、名前付きのインスタンスを持つオブジェクト型にのみ適用されます(たとえば、TABLE
およびVIEW
には適用されますが、GRANT
には適用されません)。それは、コロンでオブジェクト型と区切り、二重引用符(一重引用符は名前文字列を区切るために必要なため)で囲む必要があります。たとえば、EXCLUDE=INDEX:"LIKE
'DEPT%'"
と設定した場合、dept
で始まる名前を持つすべての索引を除外できます。
name_clause
に指定する名前は、データベース内の既存のオブジェクトに、大文字と小文字も含めて完全に一致させる必要があります。たとえば、指定するname_clause
がEMPLOYEES
という表に対するものだった場合は、すべてが大文字のEMPLOYEES
という表が存在する必要があります。name_clause
に対してEmployees
、employees
などを指定した場合、表は検出されません。
2つ以上のEXCLUDE
文を指定できます。
オペレーティング・システムによっては、このパラメータの値を指定するときに引用符とともにエスケープ文字を使用する必要があります。このパラメータはパラメータ・ファイルで指定することをお薦めします。パラメータ・ファイルを使用すると、コマンドラインでは必要なエスケープ文字の数を減らすことができます。
次の項で説明するとおり、特定のオブジェクト(特にCONSTRAINT
、GRANT
およびUSER
)を除外対象として指定した場合の効果を認識しておく必要があります。
制約の除外
次の制約は除外できません。
-
表の作成とロードを正常に行うために必要な制約。たとえば、索引構成表の主キー制約、
REF
列を持つ表のREF
SCOPE
およびWITH
ROWID
制約など。
次に、EXCLUDE
文の例およびその解釈を示します。
-
EXCLUDE=CONSTRAINT
では、表の正常な作成およびロードに必要な制約を除く、すべての制約を除外します。 -
EXCLUDE=REF_CONSTRAINT
は、参照整合性(外部キー)制約を除外します。
権限とユーザーの除外
EXCLUDE=GRANT
を指定すると、すべてのオブジェクト型に対するオブジェクト権限およびシステム権限が除外されます。
EXCLUDE=USER
を指定すると、ユーザーの定義のみが除外され、そのユーザーのスキーマ内のオブジェクトは除外されません。
特定のユーザーとそのユーザーのすべてのオブジェクトを除外するには、次のコマンドを指定します(hr
は除外するユーザーのスキーマ名です)。
impdp FULL=YES DUMPFILE=expfull.dmp EXCLUDE=SCHEMA:"='HR'"
この例では、FULL
インポート・モードが指定されていることに注意してください。モードが指定されていない場合は、デフォルト・モードであるSCHEMAS
が使用されます。ただし、この例で、FULL
を指定しないで、かわりにSCHEMAS
を使用し、続いてEXCLUDE=SCHEMA
引数を指定した場合、スキーマのインポートと除外を同時に指定することになるため、エラーが発生します。
EXCLUDE=USER:"= 'HR'"
などの文を使用してユーザーを除外しようとすると、CREATE USER hr
DDL文のみが除外され、予期しない結果が返される可能性があります。
制限事項
-
EXCLUDE
およびINCLUDE
は、相互に排他的なパラメータです。
例
DBAまたはDATAPUMP_IMP_FULL_DATABASE
ロールを持つ他のユーザーが、パラメータ・ファイルexclude.par
で次のように実行するとします。(例を実行するには、まずこのファイルを作成する必要があります。)
EXCLUDE=FUNCTION
EXCLUDE=PROCEDURE
EXCLUDE=PACKAGE
EXCLUDE=INDEX:"LIKE 'EMP%' "
次に、次のコマンドを発行します。
> impdp system DIRECTORY=dpump_dir1 DUMPFILE=expfull.dmp PARFILE=exclude.par
このコマンドでは、FULLリファレンス・トピックでエクスポートのFULL
パラメータについて示した例を実行し、expfull.dmp
ダンプ・ファイルを作成できます。expfull.dmp
ダンプ・ファイルから、emp
で始まる名前を持つファンクション、プロシージャ、パッケージおよび索引を除くすべてのデータがロードされます。
3.4.16 FLASHBACK_SCN
Oracle Data Pump Importのコマンドライン・モードのFLASHBACK_SCN
では、インポート・ユーティリティで使用されるシステム変更番号(SCN)を指定して、フラッシュバック・ユーティリティを使用可能にします。
デフォルト
デフォルトはありません
用途
インポートで使用されるシステム変更番号(SCN)を指定して、フラッシュバック・ユーティリティを使用可能にします。
構文および説明
FLASHBACK_SCN=scn_number
インポート操作は、指定したscn_number
までの一貫性のあるデータを使用して実行されます。
Oracle Database 12c リリース2 (12.2)以降では、SCN値をビッグSCN (8バイト)にすることができます。ビッグSCNの使用の詳細は、次の制限事項を参照してください。
制限事項
-
FLASHBACK_SCN
パラメータは、NETWORK_LINK
パラメータも指定されている場合のみ有効です。 -
FLASHBACK_SCN
パラメータは、Oracle Databaseのフラッシュバック問合せ機能にのみ関係します。フラッシュバック・データベース、フラッシュバック削除およびフラッシュバック・データ・アーカイブには適用できません。 -
FLASHBACK_SCN
およびFLASHBACK_TIME
は、相互に排他的なパラメータです。 -
ビッグSCNをサポートしていないバージョンからのネットワーク・エクスポートまたはネットワーク・インポートに対して、ビッグSCNを指定することはできません。
例
次に、FLASHBACK_SCN
パラメータを使用した構文例を示します。
> impdp hr DIRECTORY=dpump_dir1 FLASHBACK_SCN=123456 NETWORK_LINK=source_database_link
このコマンドを使用する場合、変数123456
およびsource_database_link
を、データのインポート元となるソース・データベースのSCNと名前に置き換えます。
ノート:
ロジカル・スタンバイ・システムでは、ロジカル・スタンバイによってSCNが選択されるため、FLASHBACK_SCN
パラメータは無視されます。ロジカル・スタンバイ・データベースの詳細は、『Oracle Data Guard概要および管理』を参照してください。
3.4.17 FLASHBACK_TIME
Oracle Data Pump Importのコマンドライン・モードのFLASHBACK_TIME
パラメータでは、インポート・ユーティリティで使用されるシステム変更番号(SCN)を指定して、フラッシュバック・ユーティリティを使用可能にします。
デフォルト
デフォルトはありません
用途
インポートで使用されるシステム変更番号(SCN)を指定して、フラッシュバック・ユーティリティを使用可能にします。
構文および説明
FLASHBACK_TIME="TO_TIMESTAMP()"
指定された時刻に最も近いSCNを検出し、このSCNを使用してフラッシュバック・ユーティリティを使用可能にします。インポート操作は、このSCNまでの一貫性のあるデータを使用して実行されます。TO_TIMESTAMP
の値は引用符で囲まれるため、パラメータ・ファイルに記述することをお薦めします。
ノート:
ロジカル・スタンバイ・システムでは、ロジカル・スタンバイによってSCNが選択されるため、FLASHBACK_TIME
パラメータは無視されます。ロジカル・スタンバイ・データベースの詳細は、 『Oracle Data Guard概要および管理』 を参照してください。
制限事項
-
このパラメータは、
NETWORK_LINK
パラメータも指定されている場合にのみ有効です。 -
FLASHBACK_TIME
パラメータは、Oracle Databaseのフラッシュバック問合せ機能にのみ関係します。フラッシュバック・データベース、フラッシュバック削除およびフラッシュバック・データ・アーカイブには適用できません。 -
FLASHBACK_TIME
およびFLASHBACK_SCN
は、相互に排他的なパラメータです。
例
DBMS_FLASHBACK.ENABLE_AT_TIME
プロシージャで使用可能な形式で時刻を指定できます。たとえば、次の内容のパラメータ・ファイルflashback_imp.par
を作成したとします。
FLASHBACK_TIME="TO_TIMESTAMP('27-10-2012 13:40:00', 'DD-MM-YYYY HH24:MI:SS')"
次のコマンドを発行します。
> impdp hr DIRECTORY=dpump_dir1 PARFILE=flashback_imp.par NETWORK_LINK=source_database_link
インポート操作は、指定した時間に最も近いSCNと整合性のあるデータで実行されます。
ノート:
フラッシュバックの使用方法の詳細は、Oracle Database開発ガイドを参照してください
3.4.18 FULL
Oracle Data Pump Importのコマンドライン・モードのFULL
パラメータにより、全データベース・インポートを実行することを指定します。
デフォルト
YES
用途
全データベース・インポートの実行を指定します。
構文および説明
FULL=YES
FULL=YES
の値は、ソースからのすべてのデータおよびメタデータがインポートされることを示します。ソースは、ダンプ・ファイル・セットにするか(ファイル・ベース・インポートの場合)、NETWORK_LINK
パラメータで指定された別のデータベースにすることができます(ネットワーク・インポートの場合)。
ファイルからインポートする際に、DATAPUMP_IMP_FULL_DATABASE
ロールを持っていない場合、自分のスキーマにマップするスキーマのみインポートされます。
NETWORK_LINK
パラメータが使用され、インポート・ジョブを実行するユーザーがターゲット・データベースのDATAPUMP_IMP_FULL_DATABASE
ロールを持っている場合、そのユーザーは、ソース・データベースのDATAPUMP_EXP_FULL_DATABASE
ロールも持っている必要があります。
このインポート・モードを使用したインポート対象を、フィルタ処理によって制限できます。
FULL
はデフォルトのモードで、ファイル・ベースのインポートを実行している場合、コマンドラインで指定する必要はありませんが、ネットワーク・ベースの全体インポートを実行している場合は、コマンドラインでFULL=Y
を指定する必要があります。
全体モード・インポート時にトランスポータブル・オプションを使用して、全体トランスポータブル・インポートを実行できます。
制限事項
-
自動ワークロード・リポジトリ(AWR)は、全データベースのエクスポートおよびインポート操作では移動されません。(データ・ポンプを使用してAWRスナップショットを移動する方法の詳細は、『Oracle Databaseパフォーマンス・チューニング・ガイド』を参照してください。)
-
XDBリポジトリは、全データベースのエクスポートおよびインポート操作では移動されません。ユーザーが作成したXMLスキーマは移動されます。
-
ターゲットがOracle Database12cリリース1 (12.1.0.1)以降で、ソースがOracle Database11gリリース2 (11.2.0.3)以降である場合、ネットワーク・リンクで実行される全体インポートでは、
VERSION=12
を設定する必要があります
例
次に、FULL
パラメータの使用例を示します。この例では、ExportのFULL
パラメータで示した例を実行して、expfull.dmp
ダンプ・ファイルを作成できます。
> impdp hr DUMPFILE=dpump_dir1:expfull.dmp FULL=YES
LOGFILE=dpump_dir2:full_imp.log
この例では、expfull.dmp
ダンプ・ファイルのすべての内容をインポートします。ここでは、DIRECTORY
パラメータは指定されていません。そのため、DUMPFILE
パラメータおよびLOGFILE
パラメータの両方にディレクトリ・オブジェクトを指定する必要があります。例に示すとおり、ディレクトリ・オブジェクトは、別のものを指定することができます。
3.4.19 HELP
Oracle Data Pump Importのコマンドライン・モードのHELP
パラメータにより、インポート・ユーティリティのオンライン・ヘルプを表示します。
デフォルト
NO
用途
インポート・ユーティリティのオンライン・ヘルプを表示します。
構文および説明
HELP=YES
HELP
=YES
が指定されている場合は、インポート・ユーティリティのすべてのコマンドライン・パラメータと対話方式コマンドの要約が表示されます。
例
この例では、すべてのインポート・パラメータおよびコマンドの簡単な説明が表示されます。
> impdp HELP = YES
3.4.20 INCLUDE
Oracle Data Pump Importのコマンドライン・モードのINCLUDE
パラメータを使用すると、現行のインポート・モードにオブジェクトおよびオブジェクト型を指定して、インポート対象のメタデータをフィルタ処理できます。
デフォルト
デフォルトはありません
用途
現行のインポート・モードにオブジェクトとオブジェクト型を指定して、インポート対象のメタデータをフィルタ処理できます。
構文および説明
INCLUDE = object_type[:name_clause] [, ...]
構文の変数object_type
では、含めるオブジェクトの型を指定します。object_type
の有効な値のリストを表示するには、次のビューを問い合せます。
-
全体モード:
DATABASE_EXPORT_OBJECTS
-
スキーマ・モード:
SCHEMA_EXPORT_OBJECTS
-
表および表領域モード:
TABLE_EXPORT_OBJECTS
問合せ結果で、OBJECT_PATH
列にリストされる値が有効なオブジェクト型です。(このような問合せの実行方法の例は、「メタデータのフィルタ」を参照してください。)
INCLUDE
文に明示的に指定した、ソース内のオブジェクト型とその依存オブジェクトのみがインポートされます。
構文の変数name_clause
はオプションです。これを使用すると、あるオブジェクト型のうち、特定のオブジェクトのファイングレイン選択を実行できます。その型のオブジェクト名に対するフィルタとして使用されるSQL式です。SQL演算子および指定した型のオブジェクト名の比較対象となる値で構成されています。このname_clause
は、名前付きのインスタンスを持つオブジェクト型にのみ適用されます(たとえば、TABLE
には適用されますが、GRANT
には適用されません)。それは、コロンでオブジェクト型と区切り、二重引用符で囲む必要があります。一重引用符は名前文字列を区切るために必要となるため、二重引用符を使用する必要があります。
name_clause
に指定する名前文字列は、データベース内の既存のオブジェクトに、大文字と小文字も含めて完全に一致する必要があります。たとえば、指定するname_clause
がEMPLOYEES
という表に対するものだった場合は、すべてが大文字のEMPLOYEES
という表が存在する必要があります。name_clause
にEmployees
またはemployees
を指定したり、既存の表の名前文字列からのその他のバリエーションを使用する場合、表は検出されません。
複数のINCLUDE
文を指定できます。
オペレーティング・システムによっては、このパラメータに引用符を使用する値を指定する場合、エスケープ文字を使用することも必要になる可能性があります。このパラメータはパラメータ・ファイルで指定することをお薦めします。パラメータ・ファイルを使用すると、コマンドラインでは使用する必要があるエスケープ文字の数を減らすことができます。
INCLUDE
パラメータで使用する有効なパスのリストを表示するには、次のビューを問い合せます。
-
全体モード:
DATABASE_EXPORT_OBJECTS
-
スキーマ・モード:
SCHEMA_EXPORT_OBJECTS
-
表および表領域モード:
TABLE_EXPORT_OBJECTS
制限事項
-
INCLUDE
およびEXCLUDE
は、相互に排他的なパラメータです。
例
imp_include.par
という名前のパラメータ・ファイルに、次が含まれているとします。このパラメータ・ファイルは、DBAまたはロールDATAPUMP_IMP_FULL_DATABASE
が付与されているその他のユーザーによって使用されています。
INCLUDE=FUNCTION
INCLUDE=PROCEDURE
INCLUDE=PACKAGE
INCLUDE=INDEX:"LIKE 'EMP%' "
このパラメータ・ファイルを使用すると、次のコマンドを発行できます。
> impdp system SCHEMAS=hr DIRECTORY=dpump_dir1 DUMPFILE=expfull.dmp
PARFILE=imp_include.par
この例では、ExportのFULL
パラメータで示した例を実行して、expfull.dmp
ダンプ・ファイルを作成できます。
このインポートでは、hr
スキーマのファンクション、プロシージャ、パッケージ、および名前がEMP
で始まる索引のみロードされます。これは特権モードのインポート(ユーザーにDATAPUMP_IMP_FULL_DATABASE
ロールがある)ですが、USER
オブジェクト型がINCLUDE
文に指定されていないため、スキーマ定義はインポートされません。
3.4.21 JOB_NAME
Oracle Data Pumpインポートのコマンドライン・モードのJOB_NAME
パラメータを使用して、後続処理でインポート・ジョブを指定します。
デフォルト
SYS_IMPORTまたはSQLFILE_mode_NN
という書式のシステム生成による名前
用途
後続処理でインポート・ジョブを指定する場合は、JOB_NAME
パラメータを使用します。たとえば、ATTACH
パラメータを使用してジョブに接続する場合、JOB_NAME
パラメータを使用して、接続するジョブを指定します。ビューDBA_DATAPUMP_JOBS
またはUSER_DATAPUMP_JOBS
を使用することにより、JOB_NAME
を使用してジョブを指定することもできます。
構文および説明
JOB_NAME=jobname_string
変数jobname_string
では、インポート・ジョブに128バイト以内の名前を指定します。これらのバイトは印字可能文字と空白を表します。文字列に空白が含まれる場合は、名前を一重引用符で囲む必要があります('Thursday Import'
など)。ジョブ名は、インポート操作を実行しているユーザーのスキーマによって暗黙的に修飾されます。ジョブ名は、エクスポート・ジョブを制御するデータ・ポンプ制御インポート・ジョブ表の名前として使用されます。
デフォルトのジョブ名はSYS_IMPORT_mode_NN
またはSYS_SQLFILE_mode_NN
という形式で、システムによって生成されます。NN
は、01
から開始して増加する2桁の整数です。たとえば、SYS_IMPORT_TABLESPACE_02
'はデフォルトのジョブ名です。
例
次に、JOB_NAME
パラメータの使用例を示します。この例では、エクスポートのFULL
パラメータで示した例を実行して、expfull.dmp
ダンプ・ファイルを作成できます。
> impdp hr DIRECTORY=dpump_dir1 DUMPFILE=expfull.dmp JOB_NAME=impjob01
関連トピック
3.4.22 KEEP_MASTER
Oracle Data Pumpインポートのコマンドライン・モードのKEEP_MASTER
パラメータは、正常に完了したOracle Data Pumpジョブの最後に、データ・ポンプ制御ジョブ表を削除するか保持するかを指定します。
デフォルト
NO
用途
正常に完了したOracle Data Pumpジョブの最後に、データ・ポンプ制御ジョブ表を削除するか保持するかを示します。データ・ポンプ制御ジョブ表は、正常に完了しなかったジョブに対して自動的に保持されます。
構文および説明
KEEP_MASTER=[YES | NO]
制限事項
-
なし
例
> impdp hr SCHEMAS=hr DIRECTORY=dpump_dir1 LOGFILE=schemas.log
DUMPFILE=expdat.dmp KEEP_MASTER=YES
3.4.23 LOGFILE
Oracle Data Pump Importのコマンドライン・モードのLOGFILE
パラメータでは、インポート・ジョブのログ・ファイルの名前を指定し、オプションでディレクトリ・オブジェクトを指定します。
デフォルト
import.log
用途
インポート・ジョブのログ・ファイルの名前を指定します。オプションで、そのログ・ファイルのディレクトリ・オブジェクトを指定します。
構文および説明
LOGFILE=[directory_object:]file_name
directory_object
を指定する場合、これはDBAによって作成済で、自分にアクセス権があるものにする必要があります。このパラメータは、DIRECTORY
パラメータに指定されたディレクトリ・オブジェクトよりも優先されます。デフォルトでは、DIRECTORY
パラメータに指定されているディレクトリ・オブジェクトによって参照されるディレクトリ内に、import.log
が作成されます。
指定したfile_name
がすでに存在する場合は、上書きされます。
処理中の作業、完了した作業および発生したエラーに関するすべてのメッセージがログ・ファイルに書き込まれます。(ジョブのリアルタイムの状態を把握するには、対話方式モードでSTATUS
コマンドを使用します。)
NOLOGFILE
パラメータを指定しないかぎり、ログ・ファイルは常に作成されます。ダンプ・ファイル・セットと同様に、ログ・ファイルの基準となるのは、クライアントではなく、サーバーです。
ノート:
Oracle Data Pump Importは、データベース文字セットを使用してログ・ファイルに書き込みます。クライアントのNLS_LANG
環境にデータベースの文字セットと異なる文字セットを設定した場合は、ログ・ファイル内の表の名前が、クライアントの出力画面に表示される名前と異なる可能性があります。
制限事項
-
Oracle Automatic Storage Management (Oracle ASM)を使用してOracle Data Pump Importを実行する場合は、
LOGFILE
パラメータで、Oracle ASMの+表記法を使用せずにディレクトリ・オブジェクトを指定する必要があります。つまり、ログ・ファイルはディスク・ファイルに書き込まれ、Oracle ASMの記憶域には書き込まれません。かわりに、NOLOGFILE=YES
を指定することもできます。ただし、この場合はログ・ファイルの書込みは行われません。
例
次に、LOGFILE
パラメータの使用例を示します。この例では、ExportのFULL
パラメータで示した例を実行して、expfull.dmp
ダンプ・ファイルを作成できます。
> impdp hr SCHEMAS=HR DIRECTORY=dpump_dir2 LOGFILE=imp.log
DUMPFILE=dpump_dir1:expfull.dmp
LOGFILE
パラメータにはディレクトリ・オブジェクトが指定されていないため、ログ・ファイルは、DIRECTORY
パラメータに指定したディレクトリ・オブジェクトに書き込まれます。
3.4.24 LOGTIME
Oracle Data Pump Importのコマンドライン・モードのLOGTIME
パラメータにより、インポート中にメッセージをタイムスタンプとともに表示することを指定します。
デフォルト
タイムスタンプは記録されません
用途
インポート中にメッセージをタイムスタンプとともに表示することを指定します。タイムスタンプを使用して、データ・ポンプ操作の異なるフェーズ間の経過時間を計算できます。この情報は、パフォーマンス問題を診断する場合や、将来の同じような操作の時間を見積もる場合に役立ちます。
構文および説明
LOGTIME=[NONE | STATUS | LOGFILE | ALL]
使用可能なオプションの定義は次のとおりです。
-
NONE
: ステータス・メッセージまたはログ・ファイル・メッセージにタイムスタンプを付けません(デフォルトと同じ)。 -
STATUS
: ステータス・メッセージにのみタイムスタンプを付けます。 -
LOGFILE
: ログ・ファイル・メッセージにのみタイムスタンプを付けます。 -
ALL
: ステータス・メッセージとログ・ファイル・メッセージの両方にタイムスタンプを付けます。
制限事項
-
なし
例
次の例では、インポート操作中に表示されるすべてのステータス・メッセージとログ・ファイル・メッセージにタイムスタンプを記録します。
> impdp hr DIRECTORY=dpump_dir1 DUMPFILE=expdat.dmp SCHEMAS=hr LOGTIME=ALL TABLE_EXISTS_ACTION=REPLACE
LOGTIME
の出力例は、エクスポートの「LOGTIME」
パラメータを参照してください。
関連トピック
3.4.25 MASTER_ONLY
Oracle Data Pumpインポートのコマンドライン・モードのMASTER_ONLY
パラメータは、データ・ポンプ制御ジョブ表の内容を確認できるように、データ・ポンプ制御ジョブ表のみをインポートしてジョブを停止するかどうかを示します。
デフォルト
NO
用途
データ・ポンプ制御ジョブ表の内容を確認できるように、データ・ポンプ制御ジョブ表のみをインポートしてジョブを停止するかどうかを示します。
構文および説明
MASTER_ONLY=[YES | NO]
制限事項
-
NETWORK_LINK
パラメータも指定する場合、MASTER_ONLY=YES
はサポートされません。
例
> impdp hr SCHEMAS=hr DIRECTORY=dpump_dir1 LOGFILE=schemas.log
DUMPFILE=expdat.dmp MASTER_ONLY=YES
3.4.26 METRICS
Oracle Data Pump Importのコマンドライン・モードのMETRICS
パラメータにより、ジョブに関する詳細情報をログ・ファイルに記録するかどうかを指定します。
デフォルト
NO
用途
ジョブに関する詳細情報をOracle Data Pumpログ・ファイルに記録するかどうかを示します。
構文および説明
METRICS=[YES | NO]
METRICS=YES
を使用すると、オブジェクト数および経過時間がOracle Data Pumpログ・ファイルに記録されます。
制限事項
-
なし
例
> impdp hr SCHEMAS=hr DIRECTORY=dpump_dir1 LOGFILE=schemas.log
DUMPFILE=expdat.dmp METRICS=YES
3.4.27 NETWORK_LINK
Oracleデータ・ポンプ・インポートのコマンドライン・モードでNETWORK_LINK
パラメータを使用すると、有効なデータベース・リンクで識別されるソース・データベースからのインポートが可能になります。
デフォルト:
デフォルトはありません
用途
有効なデータベース・リンクによって指定されるソース・データベースからのインポートを可能にします。ソース・データベース・インスタンスのデータは、接続されたデータベース・インスタンスに直接書き込まれます。
構文および説明
NETWORK_LINK=source_database_link
NETWORK_LINK
パラメータは、データベース・リンクを使用してインポートを開始します。つまり、impdp
クライアントの接続先となるシステムから、source_database_link
で指定されたソース・データベースに接続し、そこからデータを取り出して、接続されたインスタンスのデータベースに直接書き込みます。ダンプ・ファイルは含まれません。
source_database_link
には、使用可能なデータベースへのデータベース・リンク名を指定する必要があります。対象インスタンスのデータベースにデータベース・リンクが指定されていない場合、ユーザーまたはDBAが、SQL CREATE DATABASE LINK
文を使用してデータベース・リンクを作成する必要があります。
トランスポータブル・メソッドを使用してネットワーク・インポートを実行する場合は、インポートを開始する前に、ソース・データ・ファイルをターゲット・データベースにコピーする必要があります。
ソース・データベースが読取り専用の場合、接続されたユーザーは、デフォルト一時表領域として割り当てられたローカル管理一時表領域をソース・データベース上に持つ必要があります。それ以外の場合、ジョブは失敗します。
このパラメータは、FLASHBACK_SCN
、FLASHBACK_TIME
、ESTIMATE
、TRANSPORT_TABLESPACES
またはTRANSPORTABLE
のいずれかのパラメータを指定する場合に必要です。
Oracleデータ・ポンプ・インポートでは、次のタイプのデータベース・リンクの使用がサポートされています。
-
パブリック固定ユーザー
-
パブリック接続ユーザー
-
パブリック共有ユーザー(リンク所有者により使用される場合のみ)
-
プライベート共有ユーザー(リンク所有者により使用される場合のみ)
-
プライベート固定ユーザー(リンク所有者により使用される場合のみ)
注意:
暗号化されていないネットワーク・リンクを介してインポート操作が行われる場合、すべてのデータはクリア・テキストとしてインポートされます。これは、データがデータベースで暗号化されている場合でも同様です。ネットワーク・セキュリティの詳細は、Oracle Databaseセキュリティ・ガイドを参照してください。
制限事項
-
Oracleデータ・ポンプ・インポートでは、次のタイプのデータベース・リンクの使用はサポートされていません。
-
プライベート接続ユーザー
-
現在のユーザー
-
-
ContentTypeセットがあるSecureFiles、または現在Oracle Database File System Linksを介してSecureFilesセグメントの外に格納されているSecureFilesが表に含まれている場合、インポートの
NETWORK_LINK
パラメータはサポートされません。 -
ネットワーク・インポートは進化した型の使用をサポートしません。
-
データ・ポンプ操作がネットワーク・リンクを介して行われる場合、ソース・データベースとターゲット・データベースのバージョンの差違が2バージョン以下である必要があります。たとえば、一方のデータベースがOracle Database 12cの場合、他方のデータベースは12c、11gまたは10gである必要があります。Oracle Data Pumpはメジャー・バージョン番号(10g、11g、12cなど)のみをチェックします。具体的なリリース番号(12.1、12.2、11.1、11.2、10.1、10.2など)はチェックしません。
-
インポート・ジョブを実行する
USERID
がターゲット・データベースのDATAPUMP_IMP_FULL_DATABASE
ロールを持っている場合、そのユーザーは、ソース・データベースのDATAPUMP_EXP_FULL_DATABASE
ロールも持っている必要があります。 -
ネットワーク・モードのインポートでは、パラレル問合せ(PQ)子プロセスは使用されません。
-
NETWORK_LINK
パラメータも使用されていると、メタデータはパラレルでインポートできなくなります -
全体トランスポータブル・インポートを使用してネットワークを介してデータベースを転送する場合、監査証跡情報自体がユーザー定義の表領域に格納されていると、管理表領域(
SYSTEM
やSYSAUX
など)に格納された表に対して監査を有効にすることはできません。
例
次の構文例では、source_database_link
を有効なデータベース・リンクの名前に置き換えます。
> impdp hr TABLES=employees DIRECTORY=dpump_dir1
NETWORK_LINK=source_database_link EXCLUDE=CONSTRAINT
この例では、ソース・データベースからemployees
表(制約を除く)がインポートされます。ログ・ファイルは、DIRECTORY
パラメータに指定したdpump_dir1
に書き込まれます。
関連トピック
関連項目:
-
データベース・リンクの詳細は、Oracle Database管理者ガイドを参照
-
CREATE DATABASE LINK
文の詳細は、Oracle Database SQL言語リファレンスを参照してください -
ローカル管理表領域の詳細は、Oracle Database管理者ガイドを参照してください
3.4.28 NOLOGFILE
Oracle Data Pump Importのコマンドライン・モードのNOLOGFILE
パラメータにより、デフォルトでログ・ファイルを作成するかどうかを指定します。
デフォルト
NO
用途
デフォルトでログ・ファイルを作成するかどうかを指定します。
構文および説明
NOLOGFILE=[YES | NO]
NOLOGFILE=YES
を指定すると、ログ・ファイルは作成されません。ただし、進捗とエラーに関する情報が、接続されているいずれかのクライアント(オリジナルのエクスポート操作を開始したクライアントを含む)の標準出力デバイスに書き込まれます。実行中のジョブに接続されているクライアントが存在しないときにNOLOGFILE=YES
を指定すると、重要な進捗情報およびエラー情報が失われる危険性があります。
例
次に、NOLOGFILE
パラメータの使用例を示します。
> impdp hr DIRECTORY=dpump_dir1 DUMPFILE=expfull.dmp NOLOGFILE=YES
このコマンドを実行すると、expfull.dmp
ダンプ・ファイルの全体インポート・モード(ファイル・ベース・インポートのデフォルト)が実行されます。NOLOGFILE
にYES
が設定されているため、ログ・ファイルは書き込まれません。
3.4.29 PARALLEL
Oracleデータ・ポンプ・インポートのコマンドライン・モードのPARALLEL
パラメータでは、パラレルにロードできるワーカー・プロセスの最大数を設定します。
デフォルト
1
用途
データ・ポンプ制御インポート・ジョブのかわりに動作するアクティブな実行のワーカー・プロセスの最大数を指定します。
構文および説明
PARALLEL=integer
integer
に指定する値によって、インポート・ジョブのために動作するアクティブな実行プロセスの最大数が指定されます。この実行セットは、ワーカー・プロセスとパラレル入出力(I/O)サーバー・プロセスの組合せで構成されます。パラレルI/O操作でパラレル実行コーディネータとして機能するデータ・ポンプ制御プロセス、アイドル・ワーカー・プロセスおよびワーカー・プロセスは、この合計にカウントされません。このパラメータを使用して、リソース消費と経過時間のバランスをとることができます。
インポートのソースがファイルで構成されるダンプ・ファイル・セットの場合、同じファイルから複数のプロセスが読取り可能ですが、パフォーマンスは、I/O競合によって制限される可能性があります。
ジョブの実行中にPARALLEL
の値を増減するには、対話方式コマンド・モードを使用します。
ネットワーク・モード・インポートにおけるPARALLELの使用
ネットワーク・モード・インポート中、PARALLEL
パラメータによって、ジョブに割り当てることができるワーカー・プロセスの最大数が定義されます。ネットワーク・インポート・モード中のPARALLEL
パラメータの影響を理解するには、Oracle Data Pumpによって定義されるtable_data
オブジェクトの概念を理解することが重要です。Oracle Data Pumpでは、データを移動するとき、次の項目を個々のtable_data
オブジェクトとみなします。
-
完全な表(パーティションまたはサブパーティションされていないもの)
-
パーティション(表がパーティション化されているがサブパーティション化されていない場合)
-
サブパーティション(表がサブパーティション化されている場合)
たとえば:
-
非パーティション表
scott.non_part_table
には、次の1つのtable_data
オブジェクトがあります。scott.non_part_table
-
パーティション表
scott.part_table
(パーティションp1
とパーティションp2
を持つ)には、次の2つのtable_data
オブジェクトがあります。scott.part_table:p1
scott.part_table:p2
-
サブパーティション表
scott.sub_part_table
(パーティションp1
とp2
、およびサブパーティションp1s1
、p1s2
、p2s1
およびp2s2
を持つ)には、次の4つのtable_data
オブジェクトがあります。scott.sub_part_table:p1s1
scott.sub_part_table:p1s2
scott.sub_part_table:p2s1
scott.sub_part_table:p2s2
ネットワーク・モード・インポート中、各table_data
オブジェクトには、PARALLEL
パラメータに指定された値までの独自のワーカー・プロセスが割り当てられます。ネットワーク・モードのインポートではパラレル問合せ(PQ)ワーカー・プロセスが使用されないため、パラレル問合せ(PQ)ワーカー・プロセスは割り当てられません。複数のtable_data
オブジェクトを同時にアンロードできます。ただし、各table_data
オブジェクトは、1つのプロセスを使用してアンロードされます。
Oracle RAC環境でのインポートにおけるPARALLELの使用
Oracle Real Application Clusters(Oracle RAC)環境でPARALLEL=1
としてインポート操作を実行すると、すべてのOracle Data Pumpプロセスは、ジョブが開始されたインスタンス上に配置されます。そのため、ディレクトリ・オブジェクトは、そのインスタンスのローカル記憶域を示すことができます。
PARALLEL
を1より大きな値に設定してインポート操作を実行する場合は、ジョブが開始されたインスタンス以外のインスタンスにもOracle Data Pumpプロセスを置くことができます。したがって、ディレクトリ・オブジェクトは、すべてのOracle RACクラスタ・メンバー・ノードからアクセス可能な共有記憶域を指す必要があります。
制限事項
-
このパラメータは、Oracle Database 11g以上のEnterprise Editionでのみ有効です。
-
トランスポータブル表領域のメタデータは、パラレルでインポートできません。
-
パラレルで(パラレル問合せワーカー・プロセスを使用して)表または表パーティションをインポートするには、
DATAPUMP_IMP_FULL_DATABASE
ロールが必要です。 -
また、次のオブジェクトもパラレルでインポートできません。
TRIGGER
VIEW
OBJECT_GRANT
SEQUENCE
CONSTRAINT
REF_CONSTRAINT
例
次に、PARALLEL
パラメータの使用例を示します。
> impdp hr DIRECTORY=dpump_dir1 LOGFILE=parallel_import.log
JOB_NAME=imp_par3 DUMPFILE=par_exp%U.dmp PARALLEL=3
このコマンドにより、エクスポートのPARALLEL
パラメータの例を実行した場合に作成されるダンプ・ファイル・セットがインポートされます。ダンプ・ファイルの名前は、par_exp01.dmp
、par_exp02.dmp
およびpar_exp03.dmp
です。
関連トピック
3.4.30 PARALLEL_THRESHOLD
Oracle Data Pump Importコマンドライン・ユーティリティのPARALLEL_THRESHOLD
パラメータでは、表サイズに基づいてデータ・ポンプが潜在的なパラレルDMLを計算するために使用する除数のサイズを指定します。
デフォルト
250MB
用途
PARALLEL_THRESHOLD
は、単一の非パーティション表のエクスポート・ジョブまたはインポート・ジョブ、あるいはパーティション表の1つのパーティションでのみ使用する必要があります。ジョブでPARALLEL
を指定する場合、PARALLEL_THRESHOLD
を指定して、インポートおよびエクスポート時にパラレル・データ操作文(PDML)を使用して表をエクスポートまたはインポートする必要があるかどうかをOracle Data Pumpが判断するために使用する除数のサイズを変更できます。デフォルトより小さい値を指定すると、より小さい表サイズでOracle Data Pumpのパラレル・アルゴリズムを使用できます。たとえば、100MBの表があり、PDML 5を使用して5単位に分割する場合は、
を指定します。PARALLEL_THRESHOLD=20M
構文および説明
パラメータ値は、しきい値サイズをバイト単位で指定します。
PARALLEL_THRESHOLD=size-in-bytes
単一の表のエクスポートまたはインポートで、より高い並列度が必要な場合は、小さい表または表パーティションの並列度を利用するために、PARALLEL_THRESHOLD
を小さい値に設定できます。ただし、このリソース割当ての利点は、ロードまたはアンロード先となるファイル・システムのI/Oのパフォーマンスによって制限される可能性があります。また、表とメタデータ・オブジェクトの両方について、ジョブに複数のオブジェクトが含まれている場合、PARALLEL
およびPARALLEL_THRESHOLD
で指定されたPQ割当て要求の値は制限されます。表に割り当てられるPQプロセスの実際の量は、Oracle Data Pumpが同時に実行している操作の数の影響を受けており、並列度が共有される必要があります。オプティマイザによってSQLに対して生成されるデータベース、オプティマイザおよび実行計画は、ジョブで指定されたオブジェクトのロードまたはアンロードに使用される実際の並列度を決定します。
このパラメータのユースケースの1つ: Oracle Data Pumpを使用して、あるデータベースの大きな表を別のデータベースのより大きな表にロードします。例: OLTPデータベースからレポートまたはビジネス分析のデータ・ウェアハウス・データベースに週次売上データをアップロードします。
制限事項
PARALLEL_THRESHOLD
は、PARALLEL
パラメータに1より大きい値が指定されている場合にのみ、組み合せて使用されます。
例
次に、PARALLEL_THRESHOLD
パラメータを使用して表table_to_use_PDML
をエクスポートする例を示します。ここでは、PQプロセスの除数のサイズは1 KBに設定され、変数user
およびuser-password
はインポートを実行しているユーザーのユーザーおよびパスワード(impdp
)であり、ジョブ名はparathresh_example
です。
impdp user/user-password \
directory=dpump_dir \
dumpfile=parathresh_example.dmp
tables=table_to_use_PDML \
parallel=8 \
parallel_threshold=1K \
job_name=parathresh_example
3.4.31 PARFILE
Oracle Data Pump Importのコマンドライン・モードのPARFILE
パラメータでは、インポート・パラメータ・ファイルの名前を指定します。
デフォルト
デフォルトはありません
用途
インポート・パラメータ・ファイルの名前を指定します。
構文および説明
PARFILE=[directory_path]file_name
パラメータ・ファイルでは、ファイル内にデータ・ポンプ・パラメータを指定して、すべてのコマンドを個別に入力するかわりにそのファイルをコマンドラインに指定できます。これは、同じパラメータの組合せを何度も使用する場合に便利です。値の指定に引用符が必要なパラメータを使用する場合も、パラメータ・ファイルを使用することをお薦めします。
サーバーによって作成されて書き込まれるダンプ・ファイル、ログ・ファイルおよびSQLファイルとは異なり、パラメータ・ファイルはimpdp
クライアントによって開かれて読み取られるため、パラメータ・ファイルにディレクトリ・オブジェクトは指定されません。パラメータ・ファイルのデフォルトの場所は、ユーザーのカレント・ディレクトリです。
パラメータ・ファイル内では、カンマはすべての改行文字に暗黙的に含まれるため、各行の最後にカンマを入力する必要はありません。長い表名など、折返しを含む長い行がある場合、現在の行の最後にバックスラッシュ継続文字(\)を入力して次の行に継続します。
パラメータ・ファイルの内容がOracle Data Pumpログ・ファイルに書き込まれます。
制限事項
-
PARFILE
パラメータは、パラメータ・ファイル内には指定できません。
例
サンプルのパラメータ・ファイルhr_imp.par
の内容が次のとおりであるとします。
TABLES= countries, locations, regions
DUMPFILE=dpump_dir2:exp1.dmp,exp2%U.dmp
DIRECTORY=dpump_dir1
PARALLEL=3
このパラメータ・ファイルを指定するには、次のコマンドを発行できます。
> impdp hr PARFILE=hr_imp.par
コマンドの結果として、表countries
、locations
およびregions
は、エクスポートのDUMPFILE
パラメータの例を実行した場合に作成されるダンプ・ファイル・セットからインポートされます。(エクスポートのDUMPFILE
パラメータを参照してください。)インポート・ジョブは、dpump_dir2
で示される位置にあるexp1.dmp
ファイルを検索します。また、dpump_dir1
によって示される位置にあるexp2nn.dmp
の形式のすべてのダンプ・ファイルも検索します。そのジョブのログ・ファイルも、dpump_dir1
に書き込まれます。
3.4.32 PARTITION_OPTIONS
Oracle Data Pump Importのコマンドライン・モードのPARTITION_OPTIONS
パラメータでは、インポート操作中に表パーティションを作成する方法を指定します。
デフォルト
パーティション名がTABLES
パラメータで指定され、TRANPORTABLE=ALWAYS
が(インポート操作時またはエクスポート中に)設定されている場合、デフォルトはdepartition
です。それ以外の場合、デフォルトはnone
となります。
用途
インポート操作中に表パーティションを作成する方法を指定します。
構文および説明
PARTITION_OPTIONS=[NONE | DEPARTITION | MERGE]
NONE
の値を指定すると、エクスポート操作が実行されたときにシステム上に存在していたものと同じように表が作成されます。エクスポートがトランスポータブル・メソッドで実行されていて、パーティションまたはサブパーティションのフィルタが指定されていた場合は、NONE
オプションやMERGE
オプションは使用できません。そのような場合は、DEPARTITION
オプションを使用する必要があります。
DEPARTITION
の値を指定すると、パーティションまたはサブパーティションは、それぞれが新しい個別の表に昇格します。新規表のデフォルト名は、表とパーティションの名前、または表とサブパーティションの名前を適切に組み合せたものとなります。
MERGE
の値を設定すると、すべてのパーティションとサブパーティションが1つの表に統合されます。
パーティション表のインポート中の並列処理では次のような影響があります。
-
パーティション表が既存のパーティション表にインポートされた場合、データ・ポンプは
PARALLEL
パラメータで指定される値にかかわらず、一度に1つのパーティションまたはサブパーティションのみを処理します。 -
インポート先の表がまだ存在しておらず、データ・ポンプでそれを作成する必要がある場合、インポートは、インポートが開始されたときに
PARALLEL
パラメータで指定された並列度までパラレルに実行されます。
制限事項
-
ソース表のパーティションに基づいた表を作成して移入する場合は、非パーティション化を使用します。
名前の競合を回避するために、
PARTITION_OPTIONS
の値がDEPARTITION
に設定されているときには、依存オブジェクト(制約や索引など)が該当する表と同時には作成されなくなります。このエラーメッセージ「ORA-39427: パーティション表の依存オブジェクトはインポートされません。
」は、この制限による影響を受ける表がある場合に、ログ・ファイルに含まれます。このメッセージを抑止する場合は、EXCLUDE
パラメータを使用して、インポートから依存オブジェクトを除外してください。 -
PARTITION_OPTIONS
の値をMERGE
に設定していると、これらの表にドメイン索引は作成されません。このイベントが発生すると、エラー「ORA-39426: パーティション表のドメイン索引はインポートされません。
」がログ・ファイルに報告されます。このメッセージを抑止する場合は、EXCLUDE
パラメータを使用して索引を除外してください(EXCLUDE=DOMAIN_INDEX
)。 -
ダンプ・ファイルを作成したエクスポート操作がトランスポータブル・メソッドによって実行されていたときに、パーティションまたはサブパーティションを指定していた場合は、インポート操作で
DEPARTITION
オプションを使用する必要があります。 -
ダンプ・ファイルを作成したエクスポート操作がトランスポータブル・メソッドにより実行されている場合、インポート操作で
PARTITION_OPTIONS=MERGE
は使用できません。 -
非パーティション化されるオブジェクトに対する権限付与がある場合は、エラー・メッセージが生成され、オブジェクトはロードされません。
例
次の例は、sh.sales
表がsales.dmp
という名前のダンプ・ファイルにエクスポートされていることを前提としています。ここでは、merge
オプションを使用して、sh.sales
内のすべてのパーティションをscott
スキーマ内の非パーティション表にマージします。
> impdp system TABLES=sh.sales PARTITION_OPTIONS=MERGE
DIRECTORY=dpump_dir1 DUMPFILE=sales.dmp REMAP_SCHEMA=sh:scott
関連トピック
関連項目:
PARTITION_OPTIONS=DEPARTITION
を使用してインポート操作を実行する例は、エクスポートのTRANSPORTABLE
パラメータを参照してください
3.4.33 QUERY
Oracle Data Pump Importコマンドライン・モードのQUERY
パラメータを使用すると、インポート対象のデータをフィルタ処理する問合せ句を指定できます。
デフォルト
デフォルトはありません
用途
インポート対象のデータをフィルタ処理する問合せ句を指定できます。
構文および説明
QUERY=[[schema_name.]table_name:]query_clause
通常、query_clause
では、ファイングレイン行選択のためのSQL WHERE
句を使用します。ただし、任意のSQL句を使用できます。たとえば、ORDER BY
句を使用すると、ヒープ構成表から索引構成表への移行を高速化できます。スキーマおよび表名を指定しなかった場合は、ソース・ダンプ・ファイル・セットまたはデータベース内のすべての表に問合せが適用されます(この場合、問合せは、これらのすべての表に対して有効である必要があります)。表固有の問合せは、すべての表に適用される問合せより優先されます。
特定の表に問合せを適用する場合は、表名と問合せ句をコロン(:)で区切る必要があります。表固有の問合せは複数指定できますが、1つの表に指定できるのは1つの問合せのみです。
QUERY
パラメータと一緒にNETWORK_LINK
パラメータを指定する場合、リモート(ソース)ノード上にあるquery_clause
で指定されるすべてのオブジェクトは、NETWORK_LINK
値で明示的に修飾する必要があります。それ以外の場合、データ・ポンプではオブジェクトがローカル(ターゲット)ノード上に存在することを前提とし、存在しない場合はエラーが返され、リモート(ソース)システムからの表のインポートは失敗します。
たとえば、NETWORK_LINK=dblink1
と指定した場合、QUERY
パラメータのquery_clause
は、次の例に示すようにそのリンクを指定する必要があります。
QUERY=(hr.employees:"WHERE last_name IN(SELECT last_name
FROM hr.employees@dblink1)")
オペレーティング・システムによっては、このパラメータの値を指定するときに引用符とともにエスケープ文字を使用する必要があります。このパラメータはパラメータ・ファイルで指定することをお薦めします。パラメータ・ファイルを使用すると、コマンドラインでは必要なエスケープ文字の数を減らすことができます。「インポート・コマンドライン・モードについて」を参照してください。
QUERY
パラメータを使用すると、外部表による方法(ダイレクト・パスによる方法ではなく)でデータベース・アクセスが実行されます。
表固有の問合せで自分のスキーマ以外のスキーマを指定するには、その特定の表に対するアクセス権限が付与されている必要があります。
制限事項
-
QUERY
パラメータを次のパラメータとともに使用することはできません。-
CONTENT=METADATA_ONLY
-
SQLFILE
-
TRANSPORT_DATAFILES
-
-
表に
QUERY
パラメータが指定されている場合、データ・ポンプは外部表を使用してターゲット表をロードします。外部表は、SQLのINSERT
文をSELECT
句とともに使用します。QUERY
パラメータの値は、INSERT
文のSELECT
部分にあるWHERE
句に含まれています。QUERY
パラメータにロードする表と一致する名前の列がある他の表への参照が含まれていて、これらの列が問合せで使用される場合は、表別名を使用して、ロードする表内の列と、SELECT
文内の同じ名前を持つ列を区別する必要があります。たとえば、
sh.customers
表にある顧客のクレジットの上限に基づいてsh.sales
表のサブセットをインポートするとします。次の例で、ロードされる表のデータ・ポンプで使用される表別名はKU$
です。KU$
を使用して、sh.sales
をロードするためにQUERY
パラメータ内のcust_id
フィールドを修飾します。この結果、データ・ポンプによって、クレジットの上限が$10,000を超える顧客の行のみがインポートされます。QUERY='sales:"WHERE EXISTS (SELECT cust_id FROM customers c WHERE cust_credit_limit > 10000 AND ku$.cust_id = c.cust_id)"'
表別名として
KU$
を使用しないと、すべての行がロードされます。QUERY='sales:"WHERE EXISTS (SELECT cust_id FROM customers c WHERE cust_credit_limit > 10000 AND cust_id = c.cust_id)"'
-
QUERY
に使用できる文字列の最大長は、引用符を含めて4000バイトです。つまり、許容される実際の最大長は3998バイトです。
例
次に、QUERY
パラメータの使用例を示します。この例では、ExportのFULL
パラメータで示した例を実行して、expfull.dmp
ダンプ・ファイルを作成できます。詳細は、エクスポートのFULL
パラメータを参照してください。QUERY
値には引用符を使用するため、パラメータ・ファイルを使用することをお薦めします。
次の内容のパラメータ・ファイルquery_imp.par
を作成したとします。
QUERY=departments:"WHERE department_id < 120"
次のコマンドを入力します。
> impdp hr DIRECTORY=dpump_dir1 DUMPFILE=expfull.dmp
PARFILE=query_imp.par NOLOGFILE=YES
expfull.dmp
内のすべての表はインポートされますが、departments
表については、QUERY
パラメータに指定した基準を満たすデータのみがインポートされます。
3.4.34 REMAP_DATA
Oracle Data Pump Importのコマンドライン・モードのREMAP_DATA
パラメータを使用すると、新規データベースへの挿入時に、データを再マップできます。
デフォルト
デフォルトはありません
用途
REMAP_DATA
パラメータを使用すると、新規データベースへの挿入時に、データを再マップできます。一般的には、プライマリ・キーを再生成して、ターゲット・データベース上の既存の表に表をインポートする場合の競合を回避するために使用されます。
ダンプ・ファイルまたはリモート・データベースのいずれかから、指定した列の値をソースとして取得するには、再マップ・ファンクションを指定します。再マップ・ファンクションを指定すると、ターゲット・データベースの元の値を置き換える再マップした値が返されます。
同じファンクションを、ダンプされる複数の列に適用できます。このファンクションは、参照制約で子と親両方の列を再マップするときに整合性を保つ必要がある場合に役立ちます。
構文および説明
REMAP_DATA=[schema.]tablename.column_name:[schema.]pkg.function
次のリストは、各構文要素を構文で出現する順に示したものです。
schema
: 再マップする表を含むスキーマ。デフォルトでは、このスキーマはインポートを実行するユーザーのスキーマです。
tablename
: 列の再マップが行われる表。
column_name
: データの再マップが行われる列。
schema
: 再マップ・ファンクションを含むユーザー作成のPL/SQLパッケージを含むスキーマ。デフォルトでは、これはインポートを実行するユーザーのスキーマです。
pkg
: 再マップ・ファンクションを含むユーザー作成のPL/SQLパッケージの名前。
function
: 指定した表の各行で、列表を再マップする場合にコールされるPL/SQL内のファンクションの名前。
制限事項
-
ソース引数および戻り値のデータ型とサイズはともに、表内の指定した列のデータ型とサイズ一致している必要があります。
-
再マップ・ファンクションでは、自律型トランザクション以外のコミットまたはロール・バックを実行できません。
-
REMAP_DATA
パラメータの値としてのシノニムの使用はサポートされていません。たとえば、hr
スキーマ内のregions
表にregn
のシノニムがある場合は、regn
をREMPA_DATA
仕様の一部として指定した場合にエラーが返されます。 -
リモート表のLOB列データの再マップはサポートされていません。
-
REMAP_DATA
では、ユーザー定義の型、ユーザー定義の型の属性、LONG
、REF
、VARRAY
、ネストされた表、BFILE
およびXMLtype
の型の列はサポートされません。
例
次の例では、plusx
という名前のファンクションを格納するremap
という名前のパッケージが作成されており、このファンクションはemployees
表内のfirst_name
の値を変更すると想定しています。
> impdp hr DIRECTORY=dpump_dir1 DUMPFILE=expschema.dmp
TABLES=hr.employees REMAP_DATA=hr.employees.first_name:hr.remap.plusx
3.4.35 REMAP_DATAFILE
Oracle Data Pump Importのコマンドライン・モードのREMAP_DATAFILE
パラメータにより、ソース・データ・ファイルを参照するすべてのSQL文において、ソース・データファイル名がターゲット・データファイル名に変更されます。
デフォルト
デフォルトはありません
用途
ソース・データ・ファイルが参照されるすべてのSQL文(CREATE TABLESPACE
、CREATE LIBRARY
およびCREATE DIRECTORY
)で、ソース・データ・ファイルの名前をターゲット・データ・ファイル名に変更します。
構文および説明
REMAP_DATAFILE=source_datafile:target_datafile
データ・ファイルの再マップは、ファイル名のネーミング規則が異なるプラットフォーム間でデータベースを移動する場合に有効です。source_datafile
とtarget_datafile
の名前は、SQL文で指定するとおりのものである必要があります。コロンが有効なファイル指定文字として使用されるプラットフォームでの曖昧さを排除するために、データ・ファイル名は引用符で囲むことをお薦めします。
オペレーティング・システムによっては、このパラメータの値を指定するときに引用符を使用する場合、エスケープ文字も必要になる可能性があります。このパラメータはパラメータ・ファイルで指定することをお薦めします。パラメータ・ファイルを使用すると、コマンドラインでは必要なエスケープ文字の数を減らすことができます。
このパラメータを指定するには、DATAPUMP_IMP_FULL_DATABASE
ロールが必要です。
例
次の内容のパラメータ・ファイルpayroll.par
を作成したとします。
DIRECTORY=dpump_dir1
FULL=YES
DUMPFILE=db_full.dmp
REMAP_DATAFILE="'DB1$:[HRDATA.PAYROLL]tbs6.dbf':'/db1/hrdata/payroll/tbs6.dbf'"
次のコマンドを発行します。
> impdp hr PARFILE=payroll.par
この例では、インポート中に、すべてのSQL DDL文に対するVMSファイル指定(DR1$:[HRDATA.PAYROLL]tbs6.dbf
)をUnixファイル指定(/db1/hrdata/payroll/tbs6.dbf
)に再マップします。ダンプ・ファイルdb_full.dmp
は、ディレクトリ・オブジェクトdpump_dir1
によって位置が示されます。
3.4.36 REMAP_DIRECTORY
Oracle Data Pump Importのコマンドライン・モードのREMAP_DIRECTORY
パラメータを使用すると、プラットフォーム間でデータベースを移動するときにディレクトリを再マップできます。
デフォルト
デフォルトはありません
用途
REMAP_DIRECTORY
パラメータは、ソース・ディレクトリがファイルまたはディレクトリ指定全体の左端部分にあるすべてのSQL文(CREATE TABLESPACE
、CREATE LIBRARY
およびCREATE DIRECTORY
)において、ソース・ディレクトリ文字列をターゲット・ディレクトリ文字列に変更します。
構文および説明
REMAP_DIRECTORY=source_directory_string:target_directory_string
ディレクトリの再マップは、ファイルのネーミング規則が異なるプラットフォーム間でデータベースを移動する場合に便利です。元のデータ・ファイル名を維持してディレクトリ・ファイル指定のみを変更する必要がある場合は、これにより、ディレクトリ内の複数のデータ・ファイルを簡単に再マップできます。
source_directory_string
およびtarget_directory_string
は、SQL文に出現する内容に正確に一致する必要があります。また、個々のソースおよびターゲット・プラットフォームごとに、ディレクトリ・ファイル終了記号でディレクトリを適切に終了することをお薦めします。コロンが有効なディレクトリ・ファイル指定文字として使用されるプラットフォームでの曖昧さを排除するために、ディレクトリ名は引用符で囲むことをお薦めします。
オペレーティング・システムによっては、このパラメータの値を指定するときに引用符を使用する場合、エスケープ文字も必要になる可能性があります。このパラメータはパラメータ・ファイルで指定することをお薦めします。パラメータ・ファイルを使用すると、コマンドラインでは必要なエスケープ文字の数を減らすことができます。
このパラメータを指定するには、DATAPUMP_IMP_FULL_DATABASE
ロールが必要です。
制限事項
-
REMAP_DIRECTORY
およびREMAP_DATAFILE
は、相互に排他的なパラメータです。
例
たとえば、次のデータ・ファイルを再マップするとします。
DB1$:[HRDATA.PAYROLL]tbs5.dbf
DB1$:[HRDATA.PAYROLL]tbs6.dbf
また、次の内容のパラメータ・ファイルpayroll.par
があるとします。
DIRECTORY=dpump_dir1
FULL=YES
DUMPFILE=db_full.dmp
REMAP_DIRECTORY="'DB1$:[HRDATA.PAYROLL]':'/db1/hrdata/payroll/'"
この場合、次のコマンドを発行できます。
> impdp hr PARFILE=payroll.par
この例では、インポート中に、すべてのSQL DDL文について、VMSファイル指定(DB1$:[HRDATA.PAYROLL]tbs5.dbf
およびDB1$:[HRDATA.PAYROLL]tbs6.dbf
)がUNIXファイル指定(/db1/hrdata/payroll/tbs5.dbf
および/db1/hrdata/payroll/tbs6.dbf
)に再マップされます。ダンプ・ファイルdb_full.dmp
は、ディレクトリ・オブジェクトdpump_dir1
によって位置が示されます。
3.4.37 REMAP_SCHEMA
Oracle Data Pump Importのコマンドライン・モードのREMAP_SCHEMA
パラメータにより、すべてのオブジェクトをソース・スキーマからターゲット・スキーマにロードします。
デフォルト
デフォルトはありません
用途
ソース・スキーマにあるすべてのオブジェクトをターゲット・スキーマにロードします。
構文および説明
REMAP_SCHEMA=source_schema:target_schema
複数のREMAP_SCHEMA
行を指定できますが、ソース・スキーマは行ごとに異なっている必要があります。ただし、異なるソース・スキーマを同じターゲット・スキーマにマップすることはできます。マッピングが不完全である可能性があります。このトピックの「制限事項」の項を参照してください。
再マッピングするスキーマがインポート前に存在しない場合、インポート操作によってそのスキーマを作成できます。ただし、SYSTEM
ユーザーにREMAP_SCHEMA
がある場合を除きます。REMAP_SCHEMA
のターゲット・スキーマは、インポート前に存在している必要があります。スキーマを作成するには、ダンプ・ファイル・セットにソース・スキーマに必要なCREATE USER
メタデータが含まれている必要があり、十分な権限でインポートを実行する必要があります。たとえば、次のExportコマンドの場合、ユーザーSYSTEM
には必要な権限があるため、スキーマの作成に必要なメタデータを含むダンプ・ファイル・セットが作成されます。
> expdp system SCHEMAS=hr
Password: password
> expdp system FULL=YES
Password: password
スキーマの作成に必要なメタデータがダンプ・ファイル・セットに含まれていない場合や、ユーザーに必要な権限がない場合は、インポート操作を実行する前にターゲット・スキーマを作成しておく必要があります。権限が付与されていないダンプ・ファイルには、インポートでスキーマを自動作成するために必要な情報が含まれていないため、インポート前にターゲット・スキーマ作成しておく必要があります。
Oracle Database 11gより前のOracle Databaseリリースでは、インポート操作でスキーマが作成された場合、インポートの完了後に、有効なパスワードをそのスキーマに割り当てて接続する必要があります。この場合、次のSQL文を使用してパスワードを割り当てることができます。権限が必要であることに注意してください。
SQL> ALTER USER schema_name IDENTIFIED BY new_password
Oracle Database 11gリリース1 (11.1.0.1)より後のOracle Databaseリリースでは、スキーマ・パスワードをリセットする必要がなくなりました。元のパスワードは引き続き有効です。
制限事項
-
権限のないユーザーは、自分のスキーマが再マップのターゲット・スキーマの場合にのみ、スキーマの再マップを実行できます。(特権ユーザーがスキーマの再マップを実行する場合は、制限がありません。)たとえば、
SCOTT
は、自分のBLAKE
のオブジェクトをSCOTT
に再マップできますが、SCOTT
は、SCOTT
のオブジェクトをBLAKE
に再マップすることはできません。 -
インポートで検出できない一部のスキーマ参照があるため、マッピングは不完全となる可能性があります。たとえば、インポートでは、型定義、ビュー、プロシージャおよびパッケージの本体に埋め込まれたスキーマ参照は検出されません。
-
トリガーの場合、
REMAP_SCHEMA
はトリガー所有者にのみ影響を及ぼします。 -
再マップするスキーマ内の表にユーザー定義のオブジェクト型が含まれており、その表が、エクスポートされる時刻とインポートしようとする時刻の間に変更される場合、その表のインポートは失敗します。ただし、インポート操作自体は続行されます。
-
デフォルトでは、ソース・データベースのスキーマ・オブジェクトにオブジェクト識別子(OID)がある場合、それらと同じOIDを持つターゲット・データベースにインポートされます。オブジェクトがエクスポート元と同じデータベースであって異なるスキーマにインポートされた場合、新しい(インポートされた)オブジェクトのOIDは、既存のオブジェクトと同じものになり、インポートは失敗します。インポートを成功させるには、インポート時に
TRANSFORM=OID:N
パラメータも指定する必要があります。変換OID:N
により新しいオブジェクトに対して新しいOIDが作成され、インポートが成功します。
例
ユーザーSYSTEM
として、次のエクスポートおよびインポート・コマンドを実行して、hr
スキーマをscott
スキーマに再マップするとします。
> expdp system SCHEMAS=hr DIRECTORY=dpump_dir1 DUMPFILE=hr.dmp
> impdp system DIRECTORY=dpump_dir1 DUMPFILE=hr.dmp REMAP_SCHEMA=hr:scott
この例では、インポート前にユーザーscott
が存在する場合、インポートのREMAP_SCHEMA
コマンドによって、hr
スキーマにあるオブジェクトが既存のscott
スキーマに追加されます。インポート後、scott
スキーマに既存のパスワードで(パスワードの再設定なしで)接続できます。
インポート操作の実行前にユーザーscott
が存在しない場合は、インポートによって、このユーザーがパスワードなしで自動作成されます。この処理が可能なのは、ダンプ・ファイルhr
.dmp
が、スキーマの作成に必要なメタデータを含むダンプ・ファイルを作成する権限を所有するSYSTEM
によって作成されたためです。ただし、インポート完了後に、ターゲット・データベース上のscott
のパスワードを再設定しないかぎり、インポートの完了時にscott
には接続できません。
3.4.38 REMAP_TABLE
Oracle Data Pump Importのコマンドライン・モードのREMAP_TABLE
パラメータを使用すると、インポート操作中に表の名前を変更できます。
デフォルト
デフォルトはありません
用途
インポート操作中に、表の名前を変更できます。
構文および説明
次のいずれかの構文を使用できます(「使用上のノート」を参照)。
REMAP_TABLE=[schema.]old_tablename[.partition]:new_tablename
または
REMAP_TABLE=[schema.]old_tablename[:partition]:new_tablename
表が非パーティション化されている場合は、REMAP_TABLE
パラメータを使用して表全体の名前を変更することや、表パーティションの名前を変更することができます(「PARTITION_OPTIONS
」を参照)。
REMAP_TABLE
を使用して、エクスポートされた表パーティションの自動ネーミングを上書きすることもできます。
使用上のノート
最初の構文では、REMAP_TABLE=A.B:C
を指定すると、インポートによってA
はスキーマ名、B
は古い表名、C
は新しい表名とみなされます。最初の構文を使用して、非パーティション表にするパーティションの名前を変更するには、スキーマ名を指定する必要があります。
2番目の構文を使用して、非パーティション表にするパーティションの名前を変更するには、その表を古い表名で修飾します。スキーマ名は必要ありません。
制限事項
-
REMAP_TABLE
パラメータでは、ユーザーが作成した表のみが処理されます。データ・ポンプには、内部的に作成された依存表に関する十分な情報がありません。そのため、内部的に作成された表をREMAP_TABLE
パラメータで再マップできません。 -
インポートによって作成されたオブジェクトのみ、再マップされます。既存の表は再マップされないことに注意してください。
-
再マッピングする表に、同じスキーマ内の名前付きの制約が含まれ、表の作成時に制約を作成する必要がある場合、
REMAP_TABLE
パラメータは機能しません
例
次の例では、REMAP_TABLE
パラメータを使用して、employees
表をemps
という新しい名前に変更します。
> impdp hr DIRECTORY=dpump_dir1 DUMPFILE=expschema.dmp
TABLES=hr.employees REMAP_TABLE=hr.employees:emps
3.4.39 REMAP_TABLESPACE
Oracle Data Pump Importのコマンドライン・モードのREMAP_TABLESPACE
パラメータにより、インポート用に選択されたすべてのオブジェクトを再マップし、ソース表領域内の永続データがターゲット表領域内に作成されるようにします。
デフォルト
デフォルトはありません
用途
ターゲット表領域に作成するソース表領域内の永続データを使用して、インポート用に選択されたすべてのオブジェクトを再マップします。
構文および説明
REMAP_TABLESPACE=source_tablespace:target_tablespace
複数のREMAP_TABLESPACE
パラメータを指定できますが、ソース表領域はパラメータごとに1つのみです。ターゲット・スキーマのターゲット表領域には、十分な割当て制限が必要です。
データ・ポンプ・インポートで表領域を再マップする唯一の方法は、REMAP_TABLESPACE
です。REMAP_TABLESPACE
を使用する方法は、オリジナルのインポート・ユーティリティの機能よりも簡単で正確な方法です。その方法には、表領域の副次句の数など多くの制限事項があり、一部のDDLコマンドを正常に実行できない場合がありました。
これに対し、REMAP_TABLESPACE
パラメータを使用するデータ・ポンプ・インポートの方法は、ユーザーを含むすべてのオブジェクトに対して、DDL文に含まれる表領域副次句の数にかかわりなく有効に使用できます。
制限事項
-
データ・ポンプ・インポートで再マップ可能なトランスポータブル・インポートの表領域は、互換性レベルが10.1以降に設定されているデータベースにあるもののみです。
-
インポートによって作成されたオブジェクトのみ、再マップされます。特に、
TABLE_EXISTS_ACTION
がSKIP
、TRUNCATE
またはAPPEND
に設定されている場合、既存の表の表領域は再マップされません。
例
次に、REMAP_TABLESPACE
パラメータの使用例を示します。
> impdp hr REMAP_TABLESPACE=tbs_1:tbs_6 DIRECTORY=dpump_dir1
DUMPFILE=employees.dmp
3.4.40 SCHEMAS
Oracle Data Pump Importのコマンドライン・モードのSCHEMAS
パラメータにより、スキーマ・モード・インポートを実行することを指定します。
デフォルト
デフォルトはありません
用途
スキーマ・モード・インポートの実行を指定します。
構文および説明
SCHEMAS=schema_name [,...]
DATAPUMP_IMP_FULL_DATABASE
ロールがある場合は、インポートするスキーマのリストをこのパラメータで指定して、スキーマ・モードのインポートを実行できます。まず、システムおよびロールの権限、パスワード履歴などを含むユーザー定義がインポートされます(存在しない場合)。次に、スキーマ内のすべてのオブジェクトがインポートされます。権限のないユーザーは、自分のスキーマか、自分のスキーマに再マップされるスキーマのみを指定できます。この場合、スキーマ定義についての情報はインポートされず、その定義内に含まれているオブジェクトのみがインポートされます。
このインポート・モードを使用してインポートされる内容を制限するには、フィルタ処理を使用します。
スキーマ・モードは、ネットワーク・ベース・インポートを実行する際のデフォルト・モードです。
例
次に、SCHEMAS
パラメータの使用例を示します。この例では、ExportのSCHEMAS
パラメータで示した例を実行して、expdat.dmp
ファイルを作成できます。
> impdp hr SCHEMAS=hr DIRECTORY=dpump_dir1 LOGFILE=schemas.log
DUMPFILE=expdat.dmp
hr
スキーマは、expdat.dmp
ファイルからインポートされます。ログ・ファイルschemas.log
は、dpump_dir1
に書き込まれます。
3.4.41 SERVICE_NAME
Oracle Data Pump Importのコマンドライン・モードのSERVICE_NAME
パラメータでは、CLUSTER
パラメータとともに使用するサービス名を指定します。
デフォルト
デフォルトはありません
用途
CLUSTER
パラメータとともに使用するサービス名を指定するために使用します。
構文および説明
SERVICE_NAME=name
SERVICE_NAME
パラメータをCLUSTER=YES
パラメータとともに使用して、リソース・グループに属しているOracle Real Application Clusters(Oracle RAC)インスタンス群(通常は全Oracle RACインスタンスのサブセット)を定義するリソース・グループに関連付けられている、既存のサービスを指定できます。
サービス名は、リソース・グループおよびそのリソース・グループに対して定義されたインスタンスを決定する目的でのみ使用されます。ジョブが開始されたインスタンスは、そのインスタンスがリソース・グループに含まれているかどうかとは関係なく、常に使用されます。
SERVICE_NAME
パラメータは、CLUSTER=NO
と同時に指定されると、無視されます。
インスタンスA、B、CおよびDを含むOracle RAC構成があります。インスタンスA、BおよびCのみで構成されるリソース・グループを持つmy_service
というサービスが存在するとします。そのような場合は、次の内容が成立します。
-
Oracle Data PumpジョブをインスタンスAで開始したときに、
CLUSTER=YES
を指定し(またはデフォルトのYES
をそのまま使用し)、SERVICE_NAME
パラメータを指定しなかった場合、Oracle Data Pumpは、指定されている並列度に応じて、すべてのインスタンス(A、B、CおよびD)にワーカーを作成します。 -
Oracle Data PumpジョブをインスタンスAで開始し、
CLUSTER=YES
およびSERVICE_NAME=my_service
を指定した場合、ワーカーは、インスタンスA、BおよびCのみで開始可能です。 -
Oracle Data PumpジョブをインスタンスDで開始し、
CLUSTER=YES
およびSERVICE_NAME=my_service
を指定した場合、ワーカーは、インスタンスA、B、CおよびDのみで開始可能です。インスタンスDはmy_service
に存在しませんが、インスタンスDはジョブが開始されたインスタンスであるため含まれています。 -
Oracle Data PumpジョブをインスタンスAで開始し、
CLUSTER=NO
を指定した場合、SERVICE_NAME
パラメータを指定しても無視され、すべてのプロセスがインスタンスAで開始されます。
例
> impdp system DIRECTORY=dpump_dir1 SCHEMAS=hr
SERVICE_NAME=sales NETWORK_LINK=dbs1
この例では、hr
スキーマのスキーマ・モード・ネットワーク・インポートを開始します。コマンドラインではCLUSTER=YES
は指定されていませんが、それはデフォルトの動作なので、ジョブではサービス名sales
に関連付けられたリソース・グループのすべてのインスタンスが使用されます。dbs1
のNETWORK_LINK
値は、データのインポート元であるソース・データベースの名前に置き換えます。(ネットワーク・インポートではダンプ・ファイルは生成されないことに注意してください。)
NETWORK_LINK
パラメータは、単にこの例の一部として使用されています。SERVICE_NAME
パラメータの使用時は必須ではありません。
関連トピック
3.4.42 SKIP_UNUSABLE_INDEXES
Oracle Data Pump Importのコマンドライン・モードのSKIP_UNUSABLE_INDEXES
パラメータにより、(システムまたはユーザーのどちらかによって)索引使用禁止状態に設定されている索引を持つ表のロードをインポート・ユーティリティでスキップするかどうかを指定します。
デフォルト
Oracle Databaseの構成パラメータSKIP_UNUSABLE_INDEXES
の値。
用途
インポートで、(システムまたはユーザーのいずれかによって)索引使用禁止に設定されている索引を持つ表をロードするかどうかを指定します。
構文および説明
SKIP_UNUSABLE_INDEXES=[YES | NO]
SKIP_UNUSABLE_INDEXES
がYES
に設定されているときに、索引が使用禁止の状態になっている表またはパーティションが検出された場合、その表やパーティションは、使用禁止の索引が存在しない場合と同様にロードされます。
SKIP_UNUSABLE_INDEXES
がNO
に設定されているときに、索引が使用禁止の表またはパーティションが検出された場合、その表やパーティションはロードされません。索引が使用禁止に設定されていない他の表に対しては、行の挿入時に更新が行われます。
SKIP_UNUSABLE_INDEXES
パラメータが指定されていない場合は、Oracle Databaseの構成パラメータSKIP_UNUSABLE_INDEXES
の設定値が参照され、使用禁止の索引の処理が決定されます。このパラメータのデフォルト値はy
です。
制約の施行に使用される索引に使用禁止のマークが付けられている場合、その表にデータはインポートされません。
ノート:
SKIP_UNUSABLE_INDEXES
は、既存の表にデータをインポートする場合にのみ有効です。インポートの一部として表が作成される場合、実質的な効果はありません。この場合、表および索引は新規に作成され、使用禁止のマークは付けられません。
例
次に、SKIP_UNUSABLE_INDEXES
パラメータの使用例を示します。この例では、ExportのFULL
パラメータで示した例を実行して、expfull.dmp
ダンプ・ファイルを作成できます。
> impdp hr DIRECTORY=dpump_dir1 DUMPFILE=expfull.dmp LOGFILE=skip.log
SKIP_UNUSABLE_INDEXES=YES
関連トピック
3.4.43 SOURCE_EDITION
Oracle Data Pump Importのコマンドライン・モードのSOURCE_EDITION
パラメータでは、オブジェクトのフェッチ元となるリモート・ノード上のデータベース・エディションを指定します。
デフォルト
オブジェクトのフェッチ元となるリモート・ノード上のデフォルトのデータベース・エディション。
用途
オブジェクトのフェッチ元となるリモート・ノード上のデータベース・エディションを指定します。
構文および説明
SOURCE_EDITION=edition_name
SOURCE_EDITION=edition_name
を指定すると、そのエディションのオブジェクトがインポートされます。Oracle Data Pumpは、変更されずに継承されているすべてのオブジェクトと、変更されているすべての実際のオブジェクトを選択します。
このパラメータが指定されていない場合は、デフォルトのエディションが使用されます。指定されたエディションが存在しない場合や使用できない場合は、エラー・メッセージが返されます。
制限事項
-
SOURCE_EDITION
パラメータがインポート操作で有効なのは、NETWORK_LINK
パラメータも指定されている場合のみです。 - このパラメータは、バージョニング可能な同じオブジェクトのバージョンがデータベース内に2つ以上ある場合にのみ有効です。
- ジョブ・バージョンは、11.2以上に設定する必要があります。
例
次に、インポートのSOURCE_EDITION
パラメータの使用例を示します。
> impdp hr DIRECTORY=dpump_dir1 SOURCE_EDITION=exp_edition
NETWORK_LINK=source_database_link EXCLUDE=USER
この例では、オブジェクトのインポート元となるexp_edition
というエディションがシステム上に存在することを前提としています。インポート・モードは指定されていないため、デフォルト(スキーマ・モード)が使用されます。source_database_link
は、データのインポート元であるソース・データベースの名前に置き換えます。EXCLUDE=USER
パラメータは、ユーザーの定義のみを除外し、ユーザーのスキーマに含まれるオブジェクトは除外しません。これはネットワーク・インポートであるため、ダンプ・ファイルは生成されません。
関連トピック
関連項目:
-
エディションの作成方法の詳細は、『Oracle Database SQL言語リファレンス』の「CREATE EDITION」を参照してください
-
エディション機能(継承されたオブジェクトと実際のオブジェクトなど)の詳細は、『Oracle Database開発ガイド』の「エディション」を参照してください
3.4.44 SQLFILE
Oracle Data Pump Importのコマンドライン・モードのSQLFILE
パラメータでは、選択した他のインポート・パラメータに基づいて、インポート・ユーティリティによって実行準備が整えられたすべてのSQL DDLの書込み先となるファイルを指定します。
デフォルト
デフォルトはありません
用途
選択した他のインポート・パラメータに基づいて、インポートによって実行準備が整えられたすべてのSQL DDLが書き込まれるファイルを指定します。
構文および説明
SQLFILE=[directory_object:]file_name
file_name
には、ジョブで実行する準備が整ったDDLをインポート・ジョブが書き込む場所を指定します。そのSQLは、実際には実行されず、ターゲット・システムも変更されません。ファイルは、別のディレクトリ・オブジェクトを明示的に指定しないかぎり、DIRECTORY
パラメータに指定されたディレクトリ・オブジェクトに書き込まれます。このパラメータで指定した名前と一致する名前を持つ既存のファイルはすべて上書きされます。
パスワードは、SQLファイルに含まれないことに注意してください。たとえば、実行したDDLにCONNECT
文が含まれている場合、この文はコメントで置き換えられ、スキーマ名のみが示されます。次の例で、ダッシュ(--
)はコメントが後に続くことを示しています。hr
スキーマ名が表示されますが、パスワードは表示されません。
-- CONNECT hr
したがって、SQLファイルは、実行する前に、コメントを示すダッシュを削除しhr
スキーマのパスワードを追加することで編集する必要があります。
Oracle Data Pumpは、ALTER SESSION
文を、Oracle Data Pumpインポートにより作成されたSQLファイルの上に配置します。インポート操作に異なる接続文がある場合は、各ALTER SESSION
文を手動でコピーして、適切なCONNECT
文の後に貼り付ける必要があります。
一部のOracle Databaseオプションでは、無名PL/SQLブロックがSQLFILE
出力に含まれていることがあります。これらのPL/SQLブロックは直接実行しないでください。
制限事項
-
SQLFILE
が指定されている場合、CONTENT
パラメータは、ALL
またはDATA_ONLY
のいずれかに設定されていると無視されます。 -
Oracle Automatic Storage Management (Oracle ASM)を使用してSQLファイルへのOracle Data Pump Importを実行する場合、
SQLFILE
パラメータでは、OracleASM +
表記法を使用せずにディレクトリ・オブジェクトを指定する必要があります。つまり、SQLファイルはディスク・ファイルに書き込まれ、Oracle ASMの記憶域には書き込まれません。 -
SQLFILE
パラメータをQUERY
パラメータと組み合せて使用することはできません。
例
次に、SQLFILE
パラメータの使用例を示します。この例では、ExportのFULL
パラメータで示した例を実行して、expfull.dmp
ダンプ・ファイルを作成できます。
> impdp hr DIRECTORY=dpump_dir1 DUMPFILE=expfull.dmp
SQLFILE=dpump_dir2:expfull.sql
SQLファイルexpfull.sql
は、dpump_dir2
に書き込まれます。
関連トピック
3.4.45 STATUS
Oracle Data Pump Importのコマンドライン・モードのSTATUS
パラメータでは、ジョブの状態を表示する頻度を指定します。
デフォルト
0
用途
ジョブの状態を表示する頻度を指定します。
構文および説明
STATUS[=integer]
integer
に値を入力すると、ロギング・モードでジョブの状態を表示する頻度を秒単位で指定できます。値を入力しなかった場合またはデフォルト値の0を使用した場合、各オブジェクト型、表またはパーティションの完了に関する情報のみ表示されます。
この状態情報は、標準出力デバイスのみに書き込まれ、ログ・ファイルには(使用可能な場合でも)書き込まれません。
例
次に、STATUS
パラメータの使用例を示します。この例では、エクスポートのFULL
パラメータで示した例を実行して、expfull.dmp
ダンプ・ファイルを作成できます。
> impdp hr NOLOGFILE=YES STATUS=120 DIRECTORY=dpump_dir1 DUMPFILE=expfull.dmp
この例では、状態が2分(120秒)ごとに表示されます。
関連トピック
3.4.46 STREAMS_CONFIGURATION
Oracle Data Pump Importのコマンドライン・モードのSTREAMS_CONFIGURATION
パラメータでは、エクスポート・ダンプ・ファイル内に存在する可能性のあるすべてのGoldenGateレプリケーション・メタデータをインポートするかどうかを指定します。
デフォルト
YES
用途
エクスポート・ダンプ・ファイル内に存在する可能性のあるすべてのGoldenGateレプリケーション・メタデータをインポートするかどうかを指定します。
構文および説明
STREAMS_CONFIGURATION=[YES | NO]
例
次に、STREAMS_CONFIGURATION
パラメータの使用例を示します。この例では、ExportのFULL
パラメータで示した例を実行して、expfull.dmp
ダンプ・ファイルを作成できます。
> impdp hr DIRECTORY=dpump_dir1 DUMPFILE=expfull.dmp STREAMS_CONFIGURATION=NO
3.4.47 TABLE_EXISTS_ACTION
Oracle Data Pump Importのコマンドライン・モードのTABLE_EXISTS_ACTION
パラメータでは、インポート・ユーティリティで作成しようとしている表がすでに存在する場合の動作を指定します。
デフォルト
SKIP
ノート:
CONTENT=DATA_ONLY
が指定されている場合、デフォルトはSKIP
ではなくAPPEND
です。
用途
インポートで作成しようとしている表がすでに存在する場合の動作を指定します。
構文および説明
TABLE_EXISTS_ACTION=[SKIP | APPEND | TRUNCATE | REPLACE]
次の値を指定できます。
-
SKIP
: 表はそのままにして、次のオブジェクトに移動します。CONTENT
パラメータがDATA_ONLY
に設定されている場合、このオプションは無効です。 -
APPEND
: ソースから行をロードし、既存の行は変更しません。 -
TRUNCATE
: 既存の行を削除した後、ソースから行をロードします。 -
REPLACE
: 既存の表を削除した後、ソースから表を作成およびロードします。CONTENT
パラメータがDATA_ONLY
に設定されている場合、このオプションは無効です。
これらのオプションを使用する場合は、次の点に注意してください。
TRUNCATE
またはREPLACE
を使用する場合は、影響を受ける表の行が参照制約のターゲットではないことを確認してください。SKIP
、APPEND
またはTRUNCATE
を使用する場合、索引、権限、トリガー、制約など、ソースの既存の表依存オブジェクトは変更されません。REPLACE
を使用すると、依存オブジェクトが明示的または暗黙的に(EXCLUDE
を使用して)除外され、それらがソースのダンプ・ファイルまたはシステムに存在する場合、依存オブジェクトは削除され、ソースから再作成されます。-
APPEND
またはTRUNCATE
を使用する場合は、操作を実行する前に、ソースの行が既存の表と互換性があるかどうかがインポートによりチェックされます。既存の表にアクティブな制約およびトリガーがある場合は、外部表によるアクセス方法を使用してロードされます。アクティブな制約に違反する行がある場合、ロードは失敗し、データはロードされません。この動作を変更するには、インポート・ユーティリティのコマンドラインで
DATA_OPTIONS=SKIP_CONSTRAINT_ERRORS
を指定します。制約違反の可能性があるデータをロードする必要がある場合は、制約を無効にし、データをロードした後、制約を再度有効にする前に問題のある行を削除する方法を検討してください。
-
APPEND
を使用すると、常に、データは新しい領域にロードされます。既存の領域は、使用可能な場合でも再利用されません。そのため、ロード後にデータを圧縮することもできます。 -
パラレル処理を使用する場合は、既存のターゲット表の有無によりパーティション表のパラレル処理がどのように影響を受けるかについて、インポート・ユーティリティの
PARTITION_OPTIONS
パラメータの説明を参照してください。 - 既存の表(
TABLE_EXISTS_ACTION=REPLACE
またはTRUNCATE
)にインポートする場合は、表のパーティション化スキームに応じて次のガイドラインに従います。- パーティション化スキームがソースとターゲット間で一致する場合は、インポート時に
DATA_OPTIONS=TRUST_EXISTING_TABLE_PARTITIONS
を使用します。 - パーティション化スキームがソースとターゲットで異なる場合は、エクスポート時に
DATA_OPTIONS=GROUP_PARTITION_TABLE_DATA
を使用します。
- パーティション化スキームがソースとターゲット間で一致する場合は、インポート時に
ノート:
Oracle Data Pumpは、ソース表とターゲット表の不一致(2つの表の列数が同じでないか、ソース表にない列名がターゲット表にある)を検出すると、2つの表間で列名を比較します。これらの表に共通の列が少なくとも1つあると、(データ型に互換性があるとみなされる)共通する列のデータが表にインポートされます。次の制限があります。
- この動作はネットワーク・インポートではサポートされません。
- 次の型の列は削除できません。オブジェクト列、オブジェクト属性、ネストされた表の列、主キーに基づくREF列。
制限事項
TRUNCATE
は、クラスタ化された表では使用できません。
例
次に、TABLE_EXISTS_ACTION
パラメータの使用例を示します。この例では、ExportのFULL
パラメータで示した例を実行して、expfull.dmp
ダンプ・ファイルを作成できます。
> impdp hr TABLES=employees DIRECTORY=dpump_dir1 DUMPFILE=expfull.dmp
TABLE_EXISTS_ACTION=REPLACE
3.4.48 REUSE_DATAFILES
Oracle Data Pump Importのコマンドライン・モードのREUSE_DATAFILES
パラメータでは、インポート・ジョブで表領域の作成に既存のデータ・ファイルを再利用するかどうかを指定します。
デフォルト
NO
用途
インポート・ジョブで、表領域の作成に既存のデータ・ファイルを再利用するかどうかを指定します。
構文および説明
REUSE_DATAFILES=[YES | NO]
デフォルト(n
)を使用して、CREATE TABLESPACE
文で指定されているデータ・ファイルがすでに存在する場合は、CREATE TABLESPACE
文の失敗によるエラー・メッセージが発行されますが、インポート・ジョブは続行されます。
このパラメータにY
を指定すると、既存のデータ・ファイルが再度初期化されます。
注意:
REUSE_DATAFILES=YES
を指定すると、データが失われる可能性があります。
例
次に、REUSE_DATAFILES
パラメータの使用例を示します。この例では、ExportのFULL
パラメータで示した例を実行して、expfull.dmp
ダンプ・ファイルを作成できます。
> impdp hr DIRECTORY=dpump_dir1 DUMPFILE=expfull.dmp LOGFILE=reuse.log
REUSE_DATAFILES=YES
この例では、expfull.dmp
ファイルのCREATE TABLESPACE
文で指定されたデータ・ファイルを再度初期化します。
関連トピック
3.4.49 TABLES
Oracle Data Pump Importのコマンドライン・モードのTABLES
パラメータにより、表モード・インポートを実行することを指定します。
デフォルト
デフォルトはありません
用途
表モード・インポートの実行を指定します。
構文および説明
TABLES=[schema_name.]table_name[:partition_name]
表モード・インポートでは、表およびパーティションまたはサブパーティションをカンマで区切ったリストを指定して、ソースからインポートするデータをフィルタ処理できます。
schema_name
を指定しなかった場合は、デフォルトで現在のユーザーのスキーマ名になります。自分のスキーマ以外のスキーマを指定するには、DATAPUMP_IMP_FULL_DATABASE
ロールを持っているか、またはスキーマを現在のユーザーに再マップする必要があります。
インポートする内容を制限する場合は、このインポート・モードでフィルタ処理を使用できます。
partition_name
を指定する場合は、関連表にあるパーティションまたはサブパーティションの名前にする必要があります。
ワイルドカード文字%
を使用して表名とパーティション名を指定できます。
表名には次の制限があります。
-
デフォルトでは、表名は大文字でデータベースに格納されます。表名が大文字と小文字または小文字のみで表記され、大/小文字を区別する場合、名前を引用符で囲む必要があります。したがって、表名は、データベースに格納されている表名と完全に一致するように指定する必要があります。
ただし、オペレーティング・システムによっては、コマンドラインの引用符自体をエスケープする必要がある場合があります。次に、異なるインポート・モードで大/小文字の区別を保持する方法を示します。
-
コマンドライン・モード
TABLES='\"Emp\"'
-
パラメータ・ファイル・モード
TABLES='"Emp"'
-
-
表名を引用符で囲まないと、コマンドラインで指定する表名にポンド記号(
#
)は使用できません。同様に、パラメータ・ファイルでは、表名がポンド記号(#
)を含んでいると、インポート・ユーティリティは、表名が引用符で囲まれていない場合コメントとして解釈します。たとえば、パラメータ・ファイルに次のコマンドラインが記述されている場合、インポート・ユーティリティでは
emp#
の右側がすべてコメントとして解釈されるため、表dept
およびmydata
はインポートされません。TABLES=(emp#, dept, mydata)
ただし、パラメータ・ファイルに次の行が含まれる場合は、
emp#
が引用符で囲まれているため、インポート・ユーティリティは3つの表をすべてインポートします。TABLES=('"emp#"', dept, mydata)
ノート:
オペレーティング・システムによっては、一重引用符を使用する必要がある場合と、二重引用符を使用する必要がある場合があります。ご使用のオペレーティング・システムのドキュメントで確認してください。表のネーミング方法に制限があるオペレーティング・システムもあります。
たとえば、UnixのCシェルではドル記号(
$
)やポンド記号(#
)またはその他の特定の特殊文字には特別な意味があります。名前に特殊文字を使用する場合は、オペレーティング・システム・シェルによって無視され、インポートで使用できるように、エスケープ文字を使用する必要があります。
制限事項
-
TABLES
パラメータの値としてのシノニムの使用はサポートされていません。たとえば、hr
スキーマのregions
表にregn
のシノニムが存在する場合、TABLES=regn
を使用すると無効になります。この場合、エラーが返されます。 -
インポートに対して
PARTITION_OPTIONS=DEPARTITION
も指定されている場合、1つの表からのパーティションのみを指定できます。 -
TRANSPORTABLE=ALWAYS
を指定する場合は、TABLES
パラメータで指定されるすべてのパーティションが同じ表内に存在する必要があります。 -
TABLES
パラメータに指定する表名のリストの長さは、最大4MBに制限されます。ただし、NETWORK_LINK
パラメータで10.2.0.3以前のOracle Databaseまたは読取り専用のデータベースが設定されている場合は異なります。この場合の上限は4KBです。
例
次に、TABLES
パラメータを使用して、expfull.dmp
ファイルからemployees
およびjobs
表のみをインポートする簡単な例を示します。この例では、ExportのFULL
パラメータで示した例を実行して、expfull.dmp
ダンプ・ファイルを作成できます。
> impdp hr DIRECTORY=dpump_dir1 DUMPFILE=expfull.dmp TABLES=employees,jobs
次に、TABLES
を使用してパーティションをインポートするコマンドの例を示します。
> impdp hr DIRECTORY=dpump_dir1 DUMPFILE=expdat.dmp
TABLES=sh.sales:sales_Q1_2012,sh.sales:sales_Q2_2012
この例では、sh
スキーマのsales
表のパーティションsales_Q1_2012
およびsales_Q2_2012
をインポートします。
関連トピック
3.4.50 TABLESPACES
Oracle Data Pump Importのコマンドライン・モードのTABLESPACES
パラメータにより、表領域モード・インポートを実行することを指定します。
デフォルト
デフォルトはありません
用途
表領域モード・インポートの実行を指定します。
構文および説明
TABLESPACES=tablespace_name [, ...]
TABLESPACES
を使用して、表と依存オブジェクトがソース(全体インポート・モード、スキーマ・モード、表領域モードまたは表モードのエクスポート・ダンプ・ファイル・セット、あるいは別のデータベース)からインポートされる表領域名のリストを指定します。
インポートの次の状況では、データ・ポンプによりデータのインポート先に自動的に表領域が作成されます。
-
インポートが
FULL
モードまたはTRANSPORT_TABLESPACES
モードで実行されている場合 -
インポートが
TRANSPORTABLE=ALWAYS
を含む表モードで実行されている場合
その他のすべての場合では、選択したオブジェクトの表領域がインポート先のデータベースにすでに存在している必要があります。REMAP_TABLESPACE
インポート・パラメータを使用して、インポート先のデータベースにある表領域に表領域名をマッピングすることもできます。
インポートする内容を制限する場合は、このインポート・モードでフィルタ処理を使用できます。
制限事項
-
TABLESPACES
パラメータに指定する表領域名のリストの長さは、最大4MBに制限されます。ただし、NETWORK_LINK
パラメータで10.2.0.3以前のデータベースまたは読取り専用のデータベースが設定されている場合は異なります。この場合の上限は4KBです。
例
次に、TABLESPACES
パラメータの使用例を示します。表領域はすでに存在するものとします。この例では、ExportのFULL
パラメータで示した例を実行して、expfull.dmp
ダンプ・ファイルを作成できます。
> impdp hr DIRECTORY=dpump_dir1 DUMPFILE=expfull.dmp TABLESPACES=tbs_1,tbs_2,tbs_3,tbs_4
この例では、表領域tbs_1
、tbs_2
、tbs_3
およびtbs_4
にデータがある表がすべてインポートされます。
関連トピック
3.4.51 TARGET_EDITION
Oracle Data Pump Importのコマンドライン・モードのTARGET_EDITION
パラメータにより、オブジェクトをインポートするデータベース・エディションを指定します。
デフォルト
システム上のデフォルトのデータベース・エディション。
用途
オブジェクトのインポート先のデータベース・エディションを指定します。
構文および説明
TARGET_EDITION=name
TARGET_EDITION=name
を指定すると、データ・ポンプ・インポートによって、ダンプ・ファイル内で検出されたすべてのオブジェクトが作成されます。エディション化可能でないオブジェクトは、すべてのエディションで作成されます。
たとえば、表はエディション化可能でないため、ダンプ・ファイル内に表があると、その表が作成されてすべてのエディションから参照されます。ダンプ・ファイル内のオブジェクトでエディション化可能なもの(プロシージャなど)は、指定されたターゲット・エディションのみに作成されます。
このパラメータが指定されていない場合は、エクスポート・ジョブでエディションが指定されていた場合でも、インポートでターゲット・データベースのデフォルトのエディションが使用されます。指定されたエディションが存在しない場合や使用できない場合は、エラー・メッセージが返されます。
制限事項
-
このパラメータは、バージョニング可能な同じオブジェクトのバージョンがデータベース内に2つ以上ある場合にのみ有効です。
-
ジョブ・バージョンは、11.2以上である必要があります。
例
次に、TARGET_EDITION
パラメータの使用例を示します。
> impdp hr DIRECTORY=dpump_dir1 DUMPFILE=exp_dat.dmp TARGET_EDITION=exp_edition
この例は、オブジェクトのインポート先となるexp_edition
というエディションがシステム上に存在することを前提としています。インポート・モードは指定されていないため、デフォルトのスキーマ・モードが使用されます。
エディションの作成方法の詳細は、Oracle Database SQL言語リファレンスを参照してください。エディションの機能の詳細は、Oracle Database開発ガイドを参照してください。
3.4.52 TRANSFORM
Oracle Data Pump Importのコマンドライン・モードのTRANSFORM
パラメータを使用すると、インポート中のオブジェクトに対するオブジェクト作成DDLを変更できます。
デフォルト
デフォルトはありません
用途
インポート中のオブジェクトに対するオブジェクト作成DDLを変更できます。
構文および説明
TRANSFORM = transform_name:value[:object_type]
transform_name
には、変換の名前を指定します。
object_type
の指定はオプションです。指定した場合、このパラメータでは、変換が適用されるオブジェクト型を指定します。オブジェクト型を指定しなかった場合、変換はすべての有効なオブジェクト型に適用されます。
使用可能な変換は次のとおりです(アルファベット順に記載)。
-
CONSTRAINT_NAME_FROM_INDEX: [Y | N ]
この変換は、
TABLE
およびCONSTRAINT
の各オブジェクト型に対して有効です。この変換パラメータは、ユーザー作成索引を参照する
pk
またはfk
の制約の生成に影響します。Y
に設定すると、制約の名前が索引の名前と一致するように強制されます。N
(デフォルト)に設定すると、ソース・データベースで指定されたとおりに制約が作成されます。 -
CONSTRAINT_USE_DEFAULT_INDEX: [Y | N ]
この変換は、
TABLE
およびCONSTRAINT
の各オブジェクト型に対して有効です。この変換パラメータは、
pk
またはfk
の制約に関連する索引の生成に影響します。変換パラメータがY
に設定されている場合、変換により、制約を強制するために自動的に作成される索引の名前が、制約名と同一になります。また、索引は、ターゲット・データベースのデフォルトの制約定義を使用して作成および定義され、ソース・データベースで定義されている可能性がある特別な特性は使用しません。デフォルトの索引は、
UNIQUE
、PRIMARY KEY
、FOREIGN KEY
などの標準スキーマ整合性制約を使用しないかぎり許可されません。したがって、制限のないシステムからOracle Data Pumpインポートを実行し、ソース索引に追加の制約(たとえば、ハッシュ・パーティション索引などのユーザー生成制約)がある場合、これらの追加の制約はインポート中に削除されます。N
(デフォルト)に設定すると、ソース・データベースで指定され定義されているとおりに索引が作成されます。 -
DISABLE_ARCHIVE_LOGGING:[Y | N]
この変換は、
INDEX
およびTABLE
の各オブジェクト型に対して有効です。Y
に設定すると、データがインポートされる前に、指定したオブジェクト型(TABLE
またはINDEX
あるいはその両方)のロギング属性が無効になります。N
に設定すると(デフォルト)、アーカイブ・ロギングはインポート中に無効になりません。データがロードされた後に、オブジェクトのロギング属性は元の設定に戻されます。オブジェクト型を指定しない場合、DISABLE_ARCHIVE_LOGGING
の動作は、TABLE
とINDEX
の両方のオブジェクト型に適用されます。この変換は、ファイル・モード・インポートとネットワーク・モード・インポートの両方で動作します。これは、トランスポータブル表領域インポートには適用されません。ノート:
データベースがFORCE LOGGING
モードである場合、索引および表の作成時にDISABLE_ARCHIVE_LOGGING
オプションではロギングは無効になりません。 -
DWCS_CVT_IOTS: [Y | N ]
この変換は、
TABLE
オブジェクト型に対して有効です。Y
に設定すると、表の作成時にORGANIZATION INDEX
句を抑止して、索引構成表をヒープ構成表に変換するようOracle Data Pumpに指示します。N
(デフォルト)に設定すると、生成されるDDLでは、ソース・オブジェクトの表特性が保持されます。 -
DWCS_CVT_CONSTRAINTS: [Y | N ]
この変換は、
TABLE
およびCONSTRAINT
の各オブジェクト型に対して有効です。Y
に設定すると、pk
、fk
またはuk
の制約を無効として作成するようOracle Data Pumpに指示します。N
(デフォルト)に設定すると、pk
、fk
またはuk
の制約をソース・データベースのステータスに基づいて作成するようOracle Data Pumpに指示します。 -
INMEMORY:[Y | N]
この変換は、
TABLE
およびTABLESPACE
の各オブジェクト型に対して有効です。INMEMORY
変換は、インメモリー列ストア(IM列ストア)に関連があります。IM列ストアは、表、表パーティションおよびその他のデータベース・オブジェクトのコピーを格納するSystem Global Area(SGA)のオプションの部分です。IM列ストアはSGAの一部であるため、データは行ではなく、列によって移入されます。データは高速スキャンで最適化されます。IM列ストアでは、バッファ・キャッシュは置換しませんが、両方のメモリー領域において同じデータを異なる形式で格納するための補足としての役割を果たします。IM列ストアは、Oracle Databaseインメモリー・オプションに含まれています。インポートで
Y
(デフォルト値)が指定されている場合、データ・ポンプは、IM列ストア句を含むすべてのオブジェクトに対してIM列ストア句を保持します。これらのオブジェクトがインポート時に再作成されると、データ・ポンプは、エクスポート時にこれらのオブジェクトの設定と一致するIM列ストア句を生成します。インポートで
N
が指定されている場合、データ・ポンプは、IM列ストア句を含むすべてのオブジェクトからIM列ストア句を削除します。表領域に格納されているオブジェクトにIM列ストア句がない場合、オブジェクトは表領域からIM列ストア句を継承します。したがって、データベースを移行していて、IM列ストア機能を使用する新しいデータベースが必要な場合、適切なIM列ストア句を持つ表領域を事前に作成できます。その後、インポート・コマンドでTRANSFORM=INMEMORY:N
を使用します。オブジェクトは、事前に作成済の新しい表領域からIM列ストア句を継承します。INMEMORY
変換を使用しない場合、すべてのオブジェクトを個別に変更して、適切なIM列ストア句を追加する必要があります。ノート:
INMEMORY
変換は、Oracle Database 12c リリース1 (12.1.0.2)以上でのみ使用できます。インメモリー列ストア(IM列ストア)の使用方法の詳細は、Oracle Database管理者ガイドを参照してください。
-
INMEMORY_CLAUSE:"string with a valid in-memory parameter"
この変換は、
TABLE
およびTABLESPACE
の各オブジェクト型に対して有効です。INMEMORY_CLAUSE
変換は、インメモリー列ストア(IM列ストア)に関連があります。IM列ストアは、表、表パーティションおよびその他のデータベース・オブジェクトのコピーを格納するSystem Global Area(SGA)のオプションの部分です。IM列ストアはSGAの一部であるため、データは行ではなく、列によって移入されます。データは高速スキャンで最適化されます。IM列ストアでは、バッファ・キャッシュは置換しませんが、両方のメモリー領域において同じデータを異なる形式で格納するための補足としての役割を果たします。IM列ストアは、Oracle Databaseインメモリー・オプションに含まれています。この変換を指定すると、データ・ポンプは、DDL内にIM列ストア句が含まれる、インポート対象のすべてのオブジェクトに対して、文字列の内容を
INMEMORY_CLAUSE
として使用します。この変換は、ダンプ・ファイルのオブジェクトに対してIM列ストア句を優先させる必要がある場合に有効です。指定する文字列を二重引用符で囲む必要があります。コマンドラインでコマンドを入力する場合、オペレーティング・システムによってはコマンドの解析中に疑問符が削除され、エラーが発生する可能性があることに注意してください。バックスラッシュ・エスケープ文字(\
)を使用すると、このエラーを回避できます。たとえば:transform=inmemory_clause:\"INMEMORY MEMCOMPRESS FOR DML PRIORITY CRITICAL\"
または、パラメータ・ファイルにパラメータを配置することもできます。処理中に、パラメータ・ファイル内の引用符は維持されます。
ノート:
INMEMORY_CLAUSE
変換は、Oracle Database 12c リリース1 (12.1.0.2)以上でのみ使用できます。インメモリー列ストア(IM列ストア)の使用方法の詳細は、Oracle Database管理者ガイドを参照してください。IM列ストア句で指定できるパラメータのリストおよび詳細は、Oracle Databaseリファレンスを参照してください
-
LOB_STORAGE:[SECUREFILE | BASICFILE | DEFAULT | NO_CHANGE]
この変換は、オブジェクト型
TABLE
に対して有効です。指定した記憶域(
SECUREFILE
またはBASICFILE
)で、LOBセグメントが作成されます。値がNO_CHANGE
(デフォルト)の場合、LOBセグメントは、ソース・データベースに存在するものと同じ記憶域に作成されます。値がDEFAULT
の場合、キーワード(SECUREFILE
またはBASICFILE
)は省略され、LOBセグメントはデフォルト記憶域に作成されます。この変換を指定すると、マテリアライズド・ビューに記憶域を提供する表を含め、ジョブのすべての表のLOB記憶域が変更されます。
LOB_STORAGE
の変換は、トランスポータブル・インポート・ジョブでは無効です。 -
OID:[Y | N]
この変換は、
INC_TYPE
、TABLE
およびTYPE
の各オブジェクト型に対して有効です。インポート時に
Y
(デフォルト値)を指定した場合、エクスポートされたOIDが、新しいオブジェクト表およびオブジェクト型に割り当てられます。Oracle Data Pumpでは、ターゲット・データベース上で、一致する既存の型を検出する際にOIDの確認も実行されます。インポート時に
N
を指定した場合、次が実行されます。-
エクスポートされたOIDは、新しいオブジェクト表とオブジェクト型の作成で割り当てられません。かわりに、新しいOIDが割り当てられます。エクスポートされたOIDを割り当てないようにすると、スキーマのクローニングに有効ですが、参照オブジェクトには影響しません。
-
Oracle Data Pumpでは、型に関連付けられた表にデータをロードする前の、ターゲット・データベース上の既存の一致する型を検出する際に、標準の型のOID確認がスキップされます。型のハッシュ・コード、バージョン番号、型名によるその他のチェックは実行されます。
-
-
OMIT_ENCRYPTION_CLAUSE: [Y | N ]
この変換は、
TABLE
オブジェクト型に対して有効です。Y
に設定することで、列暗号化句を抑止するようOracle Data Pumpに指示できます。ソース・データベースで暗号化された列は、インポートされた表では暗号化されません。N
(デフォルト)に設定すると、列暗号化句をソース・データベースでのように作成するようOracle Data Pumpに指示します。 -
PCTSPACE:some_number_greater_than_zero
この変換は、
CLUSTER
、CONSTRAINT
、INDEX
、ROLLBACK_SEGMENT
、TABLE
およびTABLESPACE
の各オブジェクト型に対して有効です。この変換の
値
には、0より大きい数字を指定する必要があります。この値は、エクステントの割当てとデータ・ファイル・サイズの変更に使用する、割合の乗数を表します。なお、この
PCTSPACE
変換とデータ・ポンプ・エクスポートのSAMPLE
パラメータを組み合せて使用すると、記憶域の割当てサイズを、サンプリングされたデータ・サブセットに合わせることができます。(SAMPLE
エクスポート・パラメータを参照してください。) -
SEGMENT_ATTRIBUTES:[Y | N]
この変換は、
CLUSTER
、CONSTRAINT
、INDEX
、ROLLBACK_SEGMENT
、TABLE
およびTABLESPACE
の各オブジェクト型に対して有効です。値を
Y
に指定すると、適切なDDLにセグメント属性(物理属性、記憶域属性、表領域およびロギング)が指定されます。デフォルトはY
です。 -
SEGMENT_CREATION:[Y | N]
この変換は、オブジェクト型
TABLE
に対して有効です。Y
(デフォルト)に設定した場合、この変換によってSQLSEGMENT CREATION
句がCREATE TABLE
文に追加されます。つまり、CREATE TABLE
文でSEGMENT CREATION DEFERRED
かSEGMENT CREATION IMMEDIATE
のいずれかが明示的に表現されます。値がN
の場合、SEGMENT CREATION
句はCREATE TABLE
文から省略されます。ロードされる表に対してデフォルトのセグメント作成属性を使用するには、このパラメータをN
に設定します。この機能は、Oracle Database 11gリリース2 (11.2.0.2)以降で使用できます。 -
STORAGE:[Y | N]
この変換は、
CLUSTER
、CONSTRAINT
、INDEX
、ROLLBACK_SEGMENT
およびTABLE
の各オブジェクト型に対して有効です。値を
Y
に指定すると、適切なDDLにSTORAGE句が指定されます。デフォルトはY
です。SEGMENT_ATTRIBUTES=N
の場合、このパラメータは無視されます。 -
TABLE_COMPRESSION_CLAUSE:[NONE | compression_clause]
この変換は、オブジェクト型
TABLE
に対して有効です。NONE
を指定すると、表圧縮句は省略されます(その表の表領域にはデフォルトの圧縮が使用されます)。それ以外の場合、その値が有効な表圧縮句です(NOCOMPRESS
、COMPRESS BASIC
など)。指定した圧縮を使用して表が作成されます。有効な表圧縮構文の詳細は、『Oracle Database SQL言語リファレンス』を参照してください。表圧縮句が複数の語の場合、一重引用符または二重引用符で囲む必要があります。また、オペレーティング・システムでは、句をエスケープ文字(バックスラッシュ文字など)で囲むことが必要な場合があります。たとえば:
TRANSFORM=TABLE_COMPRESSION_CLAUSE:\"COLUMN STORE COMPRESS FOR QUERY HIGH\"
この変換を指定すると、マテリアライズド・ビューに記憶域を提供する表を含め、ジョブのすべての表の圧縮タイプが変更されます。
例
次の例では、hr
スキーマのemployees
表をエクスポートしたとします。表をインポートした結果返されるSQL CREATE TABLE
文は、次のようになります。
CREATE TABLE "HR"."EMPLOYEES"
( "EMPLOYEE_ID" NUMBER(6,0),
"FIRST_NAME" VARCHAR2(20),
"LAST_NAME" VARCHAR2(25) CONSTRAINT "EMP_LAST_NAME_NN" NOT NULL ENABLE,
"EMAIL" VARCHAR2(25) CONSTRAINT "EMP_EMAIL_NN" NOT NULL ENABLE,
"PHONE_NUMBER" VARCHAR2(20),
"HIRE_DATE" DATE CONSTRAINT "EMP_HIRE_DATE_NN" NOT NULL ENABLE,
"JOB_ID" VARCHAR2(10) CONSTRAINT "EMP_JOB_NN" NOT NULL ENABLE,
"SALARY" NUMBER(8,2),
"COMMISSION_PCT" NUMBER(2,2),
"MANAGER_ID" NUMBER(6,0),
"DEPARTMENT_ID" NUMBER(4,0)
) PCTFREE 10 PCTUSED 40 INITRANS 1 MAXTRANS 255 NOCOMPRESS LOGGING
STORAGE(INITIAL 10240 NEXT 16384 MINEXTENTS 1 MAXEXTENTS 121
PCTINCREASE 50 FREELISTS 1 FREELIST GROUPS 1 BUFFER_POOL DEFAULT)
TABLESPACE "SYSTEM" ;
STORAGE
句またはTABLESPACE
句は、保持しない場合、インポート・ユーティリティのTRANSFORM
パラメータを使用してCREATE STATEMENT
から削除できます。SEGMENT_ATTRIBUTES
の値をN
に指定します。これによって、セグメント属性(記憶域と表領域の両方)が表から除外されます。
> impdp hr TABLES=hr.employees DIRECTORY=dpump_dir1 DUMPFILE=hr_emp.dmp
TRANSFORM=SEGMENT_ATTRIBUTES:N:table
この結果返される、employees
表のCREATE TABLE
文は次のようになります。STORAGE
またはTABLESPACE
句は含まれていません。かわりに、HR
スキーマのデフォルト表領域が使用されます。
CREATE TABLE "HR"."EMPLOYEES"
( "EMPLOYEE_ID" NUMBER(6,0),
"FIRST_NAME" VARCHAR2(20),
"LAST_NAME" VARCHAR2(25) CONSTRAINT "EMP_LAST_NAME_NN" NOT NULL ENABLE,
"EMAIL" VARCHAR2(25) CONSTRAINT "EMP_EMAIL_NN" NOT NULL ENABLE,
"PHONE_NUMBER" VARCHAR2(20),
"HIRE_DATE" DATE CONSTRAINT "EMP_HIRE_DATE_NN" NOT NULL ENABLE,
"JOB_ID" VARCHAR2(10) CONSTRAINT "EMP_JOB_NN" NOT NULL ENABLE,
"SALARY" NUMBER(8,2),
"COMMISSION_PCT" NUMBER(2,2),
"MANAGER_ID" NUMBER(6,0),
"DEPARTMENT_ID" NUMBER(4,0)
);
前述の例で示したとおり、SEGMENT_ATTRIBUTES
変換は、記憶域と表領域の両方の属性に適用されます。STORAGE
句のみを省略して、TABLESPACE
句を保持する場合は、STORAGE
変換を次のように使用できます。
> impdp hr TABLES=hr.employees DIRECTORY=dpump_dir1 DUMPFILE=hr_emp.dmp TRANSFORM=STORAGE:N:table
SEGMENT_ATTRIBUTES
およびSTORAGE
変換は、次のコマンドに示すとおり、TRANSFORM
パラメータにオブジェクト型を指定しないことによって、すべての適用可能な表オブジェクトおよび索引オブジェクトに適用できます。
> impdp hr DIRECTORY=dpump_dir1 DUMPFILE=hr.dmp SCHEMAS=hr TRANSFORM=SEGMENT_ATTRIBUTES:N
3.4.53 TRANSPORT_DATAFILES
Oracle Data Pump Importのコマンドライン・モードのTRANSPORT_DATAFILES
パラメータでは、エクスポート中にTRANSPORTABLE=ALWAYS
が設定された場合にターゲット・データベースにインポートするデータ・ファイルのリストを指定します。
デフォルト
デフォルトはありません
用途
トランスポータブル表領域モード・インポートか、エクスポート中にTRANSPORTABLE=ALWAYS
が設定された場合には表モード・インポートまたは全体モード・インポートによって、ターゲット・データベースにインポートするデータ・ファイルのリストを指定します。データ・ファイルはターゲット・データベース・システム上にすでに存在する必要があります。
構文および説明
TRANSPORT_DATAFILES=datafile_name
datafile_name
には、ディレクトリ・オブジェクト名ではなく、ターゲット・データベースが存在するシステムで有効な絶対ディレクトリ・パスを指定する必要があります。
また、datafile_name
の絶対パス指定のファイル名部分にワイルドカードを使用することもできます。アスタリスク(*)
は、0からN個の文字と一致します。疑問符(?
)は、正確に1文字と一致します。絶対パス指定のディレクトリ部分にワイルドカードを使用することはできません。ワイルドカードを使用する場合、一致するすべてのファイルがトランスポート・セットの一部である必要があります。トランスポート・セットの一部ではないファイルが見つかった場合、エラーが表示され、インポート・ジョブは終了します。
インポート操作前の任意の時点で、ソース・システムからターゲット・システムにデータ・ファイルをコピーしておく必要があります。データ・ファイルは、オペレーティング・システムでサポートされている任意のコピー方法でコピーできます。必要に応じて、ターゲット・システムにコピーするときに、ファイルの名前を変更できます。例2を参照してください。
トランスポータブル・モード・エクスポートによって生成されたダンプ・ファイル・セットがすでにある場合、(メタデータを含んでいる)ダンプ・ファイルおよびTRANSPORT_DATAFILES
パラメータを指定することで、そのダンプ・ファイルのトランスポータブル・モード・インポートを実行できます。TRANSPORT_DATAFILES
パラメータが存在することで、これがトランスポータブル・モード・インポートであることと、実際のデータを取得する場所がインポートに通知されます。
オペレーティング・システムによっては、このパラメータの値を引用符を使用して指定する場合、エスケープ文字を使用することも必要になる可能性があります。このパラメータはパラメータ・ファイルで指定することをお薦めします。パラメータ・ファイルを使用すると、コマンドラインでは使用する必要があるエスケープ文字の数を減らすことができます。
制限事項
-
TRANSPORT_DATAFILES
パラメータをQUERY
パラメータと組み合せて使用することはできません。 -
トランスポータブル・インポート・ジョブは再起動できません。
-
絶対ファイル・パスの
TRANSPORT_DATAFILES
ディレクトリ部分にワイルドカードを含めることはできません。ただし、絶対ファイル・パスのファイル名部分にはワイルドカードを含めることができます。
例1
次に、TRANSPORT_DATAFILES
パラメータの使用例を示します。次の内容のパラメータ・ファイルtrans_datafiles.par
を作成したとします。
DIRECTORY=dpump_dir1
DUMPFILE=tts.dmp
TRANSPORT_DATAFILES='/user01/data/tbs1.dbf'
次のコマンドを発行します。
> impdp hr PARFILE=trans_datafiles.par
例2
この例は、トランスポータブル表領域のエクスポートおよびインポート操作の一環として、データ・ファイルの名前を変更する操作を示しています。ソース・システムにemployees.dat
というデータ・ファイルがあることを前提としています。
-
オペレーティング・システムでサポートされている方法で、ソース・システムからターゲット・データベースがあるシステムに、
employees.dat
というデータ・ファイルを手動でコピーします。コピー操作の一環として、ファイル名をworkers.dat
に変更します。 -
表領域
tbs_1
について、トランスポータブル表領域のエクスポートを実行します。> expdp hr DIRECTORY=dpump_dir1 DUMPFILE=tts.dmp TRANSPORT_TABLESPACES=tbs_1
tbs_1
のメタデータのみ(データなし)がtts.dmp
というダンプ・ファイルにエクスポートされます。実際のデータは、ステップ1でターゲット・データベースにコピーされています。 -
workers.dat
というデータ・ファイルの絶対ディレクトリ・パスを指定して、トランスポータブル表領域のインポートを実行します。> impdp hr DIRECTORY=dpump_dir1 DUMPFILE=tts.dmp TRANSPORT_DATAFILES='/user01/data/workers.dat'
tts.dmp
に含まれているメタデータがインポートされ、workers.dat
ファイル内の情報がOracle Data Pumpによってデータベース内の正しい場所に割り当てられます。
例3
この例では、TRANSPORT_DATAFILES
パラメータで使用するファイル名に、アスタリスク(*
)のワイルドカード文字を使用しています。
TRANSPORT_DATAFILES='/db1/hrdata/payroll/emp*.dbf'
このパラメータを使用すると、ディレクトリ/db1/hrdata/payroll/
内にある、タイプ.dbf
のファイルのうち、名前の先頭がemp
であるものがすべてトランスポート・セットの一部になっていることが、Oracle Data Pumpによって検査されます。
例4
この例では、TRANSPORT_DATAFILES
パラメータで使用するファイル名に、疑問符(?
)のワイルドカード文字を使用しています。
TRANSPORT_DATAFILES='/db1/hrdata/payroll/m?emp.dbf'
このパラメータを使用すると、ディレクトリ/db1/hrdata/payroll/
内にある、タイプ.dbf
のファイルのうち、名前の先頭がm
、その次が任意の他の単一文字、末尾がemp
であるものがすべてトランスポート・セットの一部になっていることが、Oracle Data Pumpによって検査されます。たとえば、myemp.dbf
という名前のファイルは含められますが、memp.dbf
という名前のファイルは含められません。
3.4.54 TRANSPORT_FULL_CHECK
Oracle Data Pump Importのコマンドライン・モードのTRANSPORT_FULL_CHECK
パラメータでは、指定したトランスポータブル表領域セットが他の表領域内のオブジェクトによって参照されていることを確認するかどうかを指定します。
デフォルト
NO
用途
指定したトランスポータブル表領域セットが他の表領域内のオブジェクトによって参照されていることを確認するかどうかを指定します。
構文および説明
TRANSPORT_FULL_CHECK=[YES | NO]
TRANSPORT_FULL_CHECK=YES
を指定すると、インポート・ユーティリティによって、トランスポータブル・セット内のオブジェクトとトランスポータブル・セット外のオブジェクトの間に依存性が存在しないことが確認されます。ここでは、双方向の依存性がチェックされます。たとえば、トランスポータブル・セット内に表は存在するが、その表の索引は存在しない場合は、エラーが返され、インポート操作が終了します。同様に、トランスポータブル・セット内に索引は存在するが表は存在しない場合も、エラーが返されます。
TRANSPORT_FULL_CHECK=NO
を指定すると、インポート・ユーティリティによって、トランスポータブル・セット外のオブジェクトに依存するオブジェクトが、トランスポータブル・セット内に存在しないことのみ確認されます。ここでは、一方向の依存性がチェックされます。たとえば、表は索引に依存しませんが、索引は表に依存します。これは、索引は表なしでは意味を持たないためです。そのため、トランスポータブル・セット内に表は存在するが、表の索引は存在しない場合、このチェックは正常に終了します。ただし、トランスポータブル・セット内に索引は存在するが表は存在しない場合は、インポート操作が終了します。
このチェックに加えて、インポートでは、常に、TRANSPORT_TABLESPACES
で指定された表領域セット内に定義されているすべての表(およびその索引)のすべての記憶域セグメントが、表領域セット内に実際に含まれていることが確認されます。
制限事項
-
このパラメータは、
NETWORK_LINK
パラメータを指定した場合にのみトランスポータブル・モード(またはTRANSPORTABLE=ALWAYS
がエクスポート時に指定されていた場合は表モードまたは全体モード)に対して有効です。
例
次の例では、source_database_link
を有効なデータベース・リンクの名前に置き換えます。また、この例では、tbs6.dbf
というデータ・ファイルがすでに存在するものとします。
次の内容のパラメータ・ファイルfull_check.par
を作成したとします。
DIRECTORY=dpump_dir1
TRANSPORT_TABLESPACES=tbs_6
NETWORK_LINK=source_database_link
TRANSPORT_FULL_CHECK=YES
TRANSPORT_DATAFILES='/wkdir/data/tbs6.dbf'
次のコマンドを発行します。
> impdp hr PARFILE=full_check.par
3.4.55 TRANSPORT_TABLESPACES
Oracle Data Pump Importのコマンドライン・モードのTRANSPORT_TABLESPACES
パラメータにより、データベース・リンク経由でトランスポータブル表領域モードでのインポートを実行することを指定します。
デフォルト
デフォルトはありません
用途
データベース・リンク(NETWORK_LINK
パラメータで指定)経由でトランスポータブル表領域モードのインポートの実行を指定します。
構文および説明
TRANSPORT_TABLESPACES=tablespace_name [, ...]
TRANSPORT_TABLESPACES
パラメータは、ソース・データベースからターゲット・データベースにオブジェクト・メタデータがインポートされる表領域の名前のリストを指定するために使用します。
このインポートはトランスポータブル・モード・インポートであるため、データのインポート先の表領域は、データ・ポンプによって自動的に作成されます。事前に表領域を作成しておく必要はありません。ただし、インポートを開始する前に、データ・ファイルをターゲット・データベースにコピーします。
インポート・コマンドラインでTRANSPORT_TABLESPACES
を指定する場合は、データベース・リンクを指定するためにNETWORK_LINK
パラメータも使用する必要があります。データベース・リンクは2つの物理データベース・サーバー間の接続であり、データベース・リンクを使用すると、クライアントから1つの論理データベースとしてこれらのサーバーにアクセスできます。オブジェクト・メタデータはデータベース・リンクを使用してソース(NETWORK_LINK
によって指定されるデータベース)からエクスポートされ、ターゲット(impdp
コマンドの発行元のデータベース)に直接インポートされるため、NETWORK_LINK
パラメータが必要となります。この処理にはダンプ・ファイルは関連しません。他の方法を使用して個別の操作で実際のデータをターゲットにコピーする場合は、TRANSPORT_DATAFILES
パラメータを指定し、データの場所を指定します。
ノート:
トランスポータブル表領域モード・エクスポートによって生成されたダンプ・ファイル・セットがすでにある場合、そのダンプ・ファイルのトランスポータブル・モード・インポートを実行できますが、この場合TRANSPORT_TABLESPACES
またはNETWORK_LINK
を指定しません。指定するとエラーが発生します。かわりに、(メタデータを含んでいる)ダンプ・ファイルとTRANSPORT_DATAFILES
パラメータを指定します。TRANSPORT_DATAFILES
パラメータが存在することで、これがトランスポータブル・モード・インポートであることと、実際のデータを取得する場所がインポートに通知されます。
トランスポータブル・ジョブを実行する場合、ベスト・プラクティスは、インポート・ジョブがターゲット・システムで正常に完了するまで、ソース・システムにデータ・ファイルのコピーを保持することです。インポート・ジョブが失敗しても、破損していないデータ・ファイルのコピーが残ります。
制限事項
-
トランスポータブル表領域をエクスポートした後、それよりも古いリリース・レベルのデータベースにインポートすることはできません。インポート先のターゲット・データベースのリリース・レベルは、ソース・データベース以上である必要があります。
-
TRANSPORT_TABLESPACES
パラメータは、NETWORK_LINK
パラメータも指定されている場合のみ有効です。 -
TRANSPORT_TABLESPACES
パラメータを使用してトランスポータブル表領域インポートを実行するには、COMPATIBLE
初期化パラメータを11.0.0以上に設定する必要があります。 -
オペレーティング・システムによっては、このパラメータの値を引用符を使用して指定する場合、エスケープ文字を使用することも必要になる可能性があります。このパラメータはパラメータ・ファイルに配置することをお薦めします。パラメータ・ファイルを使用すると、コマンドラインの場合には使用する必要があるエスケープ文字の数を減らすことができます。
-
トランスポータブル表領域のジョブでは、データ・ポンプ・インポートの
ACCESS_METHOD
パラメータはサポートされません。
例
次の例では、source_database_link
を有効なデータベース・リンクの名前に置き換えます。また、この例では、tbs6.dbf
というデータ・ファイルが、ソース・データベースからローカル・システムにすでにコピーされているものとします。次の内容のパラメータ・ファイルtablespaces.par
を作成したとします。
DIRECTORY=dpump_dir1
NETWORK_LINK=source_database_link
TRANSPORT_TABLESPACES=tbs_6
TRANSPORT_FULL_CHECK=NO
TRANSPORT_DATAFILES='user01/data/tbs6.dbf'
次のコマンドを発行します。
> impdp hr PARFILE=tablespaces.par
3.4.56 TRANSPORTABLE
Oracle Data Pump Importのコマンドライン・モードのTRANSPORTABLE
パラメータにより、表モード・インポートまたは全体モード・インポートの際にトランスポータブル・オプションを使用するかどうかを指定します。
デフォルト
NEVER
用途
トランスポータブル・オプションを使用する必要があるかどうかは、表モード・インポート(TABLES
パラメータで指定)または全体モード・インポート(FULL
パラメータで指定)の際に指定します。KEEP_READ_ONLY
およびNO_BITMAP_REBUILD
は、TRANSPORTABLE
パラメータ値として追加されます。KEEP_READ_ONLY
およびNO_BITMAP_REBUILD
は、トランスポータブル・モードのインポート操作について有効となります。
構文および説明
TRANSPORTABLE = [NEVER|ALWAYS|KEEP_READ_ONLY|NO_BITMAP_REBUILD]
使用可能な値の定義は、次のとおりです。
-
ALWAYS
: トランスポータブル・オプションを使用するようにインポート・ジョブに指示します。トランスポータブルが使用できない場合、ジョブは失敗します。表モード・インポートでトランスポータブル・オプションを使用すると、指定した表、パーティションまたはサブパーティションのメタデータのみがインポートされるトランスポータブル表領域インポートになります。
全体モード・インポートでトランスポータブル・オプションを使用すると、指定したデータベースのすべてのオブジェクトのメタデータがインポートされる全体トランスポータブル・インポートになります。
どちらの場合も、別々の操作でターゲット・データベースに実際のデータ・ファイルをコピー(および通常は変換)する必要があります。
トランスポータブル・ジョブを実行する場合、ベスト・プラクティスは、インポート・ジョブがターゲット・システムで正常に完了するまで、ソース・システムにデータ・ファイルのコピーを保持することです。インポート・ジョブがなんらかの理由で失敗しても、破損していないデータ・ファイルのコピーが残ります。
-
NEVER
: トランスポータブル・オプションではなく、ダイレクト・パス方式または外部表方式を使用してデータをロードするようにインポート・ジョブに指示します。これはデフォルトです。表のパーティションのサブセットのみをインポートし、
TRANSPORTABLE=ALWAYS
パラメータを使用すると、それぞれのパーティションが非パーティション表になります。表のパーティションのサブセットのみをインポートし、
TRANSPORTABLE
パラメータを使用しない場合や、そのパラメータがNEVER
に設定されている場合(デフォルト)は、次のオプションが適用されます。-
PARTITION_OPTIONS=DEPARTITION
: 各パーティションを非パーティション表として作成することを指定します。 -
PARTITION_OPTIONS
: 値が指定されていない場合は、この設定により完全な表の作成が可能になります。つまり、完全な表のすべてのメタデータが存在するようになり、ターゲット・システムでの表定義はソースに存在していたときと同じになります。ただし、その表には指定したパーティションのデータのみが挿入されます。
-
-
KEEP_READ_ONLY
: トランスポータブル・データ・ファイルがread-only
モードを維持する必要があることを指示します。KEEP_READ_ONLY
を使用すると、読取り専用アクセスのためにデータ・ファイルを1つ以上の追加の互換データベースにプラグインできるようになります。 -
NO_BITMAP_REBUILD
: トランスポータブル・データ・ファイル・ヘッダーのビットマップを再構築する必要がないことを指示します。未使用のデータ・セグメントを再利用しないと、インポート操作の時間が短縮されます。ビットマップは、dbms_space_admin.tablespace_rebuild_bitmaps
を使用することで再構築できます。 -
TRANSPORTABLE=KEEP_READ_ONLY
: 指定すると、データ・ファイルはread-only
モードを維持します。この設定の結果として、TSTZ
列のデータを格納している表は更新できなくなり、インポートから削除されます。また、データ・ファイル・ビットマップを再構築することはできません。 -
TRANSPORTABLE=NO_BITMAP_REBUILD
: 指定すると、インポート時にTSTZ列のデータを格納している表の更新が必要になったときに、データ・ファイルはread/write
モードに移行します。
APIまたはクラス
TRANSPORTABLE
パラメータの値は、既存のプロシージャDBMS_DATAPUMP.SET_PARAMETER
を使用して設定できます。
制限事項
-
インポートの
TRANSPORTABLE
パラメータは、NETWORK_LINK
パラメータも指定されている場合のみ有効です。 -
TRANSPORTABLE
パラメータは、表モード・インポートおよび全体モード・インポートでのみ有効です。 -
トランスポータブル・インポートを実行するユーザーには、ソース・データベースでの
DATAPUMP_EXP_FULL_DATABASE
ロールと、ターゲット・データベースでのDATAPUMP_IMP_FULL_DATABASE
ロールの両方が必要になります。 -
ネットワーク・インポートのために選択された記憶域を持つすべてのオブジェクトでは、ソース・システム上のすべての記憶域セグメントが、管理対象の非トランスポータブル表領域(
SYSTEM
/SYSAUX
),内に全体として存在するか、ユーザー定義のトランスポータブル表領域内に全体として存在する必要があります。シングル・オブジェクトの記憶域は、2種類の表領域にまたがることはできません。 -
ソース・データベースがリリース11.2.0.3の場合に
TRANSPORTABLE
パラメータを使用してネットワーク・ベースの全体トランスポータブル・インポートを実行するには、データ・ポンプのVERSION
パラメータを12.0以上に設定する必要があります。ソース・データベースがリリース12.1以上の場合、VERSION
パラメータは不要ですが、COMPATIBLE
データベース初期化パラメータを12.0.0以上に設定する必要があります。
ネットワーク・リンク・インポートの例
次に、ネットワーク・リンク・インポート中にTRANSPORTABLE
パラメータを使用する例を示します。datafile_name
は、インポート対象のデータ・ファイルです。
> impdp system TABLES=hr.sales TRANSPORTABLE=ALWAYS
DIRECTORY=dpump_dir1 NETWORK_LINK=dbs1 PARTITION_OPTIONS=DEPARTITION
TRANSPORT_DATAFILES=datafile_name
全体トランスポータブル・インポートの例
次の例は、データベース・リンクdbs1
を通じて全体トランスポータブル・インポートを実行する際のTRANSPORTABLE
パラメータの使用方法を示しています。この例では、暗号化された列を含む表のパスワードを指定しています。
> impdp import_admin FULL=Y TRANSPORTABLE=ALWAYS VERSION=12 NETWORK_LINK=dbs1
ENCRYPTION_PASSWORD=password TRANSPORT_DATAFILES=datafile_name
LOGFILE=dpump_dir1:fullnet.log
NEVERまたはALWAYSの設定例
文字列値を使用したTRANSPORTABLE
パラメータの設定は、NEVER
値またはALWAYS
値に制限されます。
SYS.DBMS_DATAPUMP.SET_PARAMETER(jobhdl, ‘TRANSPORTABLE’,’ALWAYS’);
SYS.DBMS_DATAPUMP.SET_PARAMETER(jobhdl, ‘TRANSPORTABLE’,’NEVER’);
新しいTRANSPORTABLE
パラメータ・オプションは、新しい数値ビットマスク値を使用して設定します。
DBMS_DATAPUMP.KU$_TTS_NEVER
は値1
DBMS_DATAPUMP.KU$_TTS_ALWAYS
は値2
DBMS_DATAPUMP.KU$_TTS_KEEP_READ_ONLY
は値4
DBMS_DATAPUMP.KU$_TTS_NO_BITMAP_REBUILD
は値8
SYS.DBMS_DATAPUMP.SET_PARAMETER(jobhdl, ‘TRANSPORTABLE’,
DBMS_DATAPUMP.KU$_TTS_ALWAYS+DBMS_DATAPUMP.KU$_TTS_KEEP_READ_ONLY);
ファイル・ベースのトランスポータブル表領域インポートの例
次の例は、ファイル・ベースのトランスポータブル表領域インポートでのTRANSPORTABLE
パラメータの使用を示しています。指定されたKEEP_READ_ONLY
オプションは、インポート操作全体にわたってデータ・ファイルが読取り専用アクセスを保持することを示します。必要なデータ・ファイルは、トランスポータブル表領域エクスポートによって報告されます。
impdp system DIRECTORY=dpump_dir DUMPFILE=dumpfile_name
TRANSPORT_DATAFILES=datafile_name TRANSPORTABLE=KEEP_READ_ONLY
3.4.57 VERSION
Oracle Data Pump Importのコマンドライン・モードのVERSION
パラメータでは、インポートするデータベース・オブジェクトのバージョンを指定します。
デフォルト
通常はインポート操作でVERSION
パラメータを指定する必要はありません。Oracle Data Pumpでは、次のうちの古い方が使用されます。
-
ネットワーク・インポートの場合、ダンプ・ファイルまたはソース・データベースに関連付けられているバージョン
-
ターゲット・データベースの
COMPATIBLE
初期化パラメータで指定されたバージョン
用途
インポートするデータベース・オブジェクトのバージョンを指定します(つまり、指定されたリリースと互換性のあるデータベース・オブジェクトおよび属性のみがインポートされます)。なお、これは、10.1より前のリリースのOracle DatabaseでOracle Data Pump Importを使用可能ということではありません。Oracle Data Pump Importは、Oracle Database 10gリリース1 (10.1)以降でのみ動作します。VERSION
パラメータを使用して可能になるのは、インポートするオブジェクトのバージョンの識別のみです。
構文および説明
VERSION=[COMPATIBLE | LATEST | version_string]
このパラメータは、ソース・システムのリリースより古い互換リリースのOracle Databaseが稼働しているターゲット・システムのロードに使用できます。VERSION
パラメータが設定されている場合、指定したリリースと互換性のないソース・システム上のデータベース・オブジェクトまたは属性はターゲットに移動されません。たとえば、指定したリリースではサポートされていない新しいデータ型を含む表はインポートされません。このパラメータの有効な値は次のとおりです。
-
COMPATIBLE
- デフォルト値。メタデータのバージョンは、データベースの互換性レベルに対応します。データベースの互換性は、9.2.0以上に設定する必要があります。 -
LATEST
- メタデータのバージョンは、データベースのリリースに対応します。ターゲット・データベースの実際のバージョンがCOMPATIBLE
初期化パラメータで指定されたバージョンより新しいである場合、インポート・ジョブでVERSION=LATEST
を指定しても影響がありません。 -
version_string
- 特定のデータベース・リリース(12.2.0
など)。
制限事項
-
Oracle Data Pumpの
VERSION
パラメータを12.1より前の任意の値に指定すると、4000バイトを超える長さのVARCHAR2
列またはNVARCHAR2
列と、2000バイトを超える長さのRAW
列を含む表は、Oracle Data Pumpのダンプ・ファイルから除外されます。 -
ターゲットがOracle Database 12cリリース1 (12.1.0.1)以降で、ソースがOracle Database 11gリリース2 (11.2.0.3)以降である場合、ネットワーク・リンクで実行される全体インポートでは、
VERSION=12
を設定する必要があります。 -
Oracle Data Pumpのパラメータ
VERSION=12
を使用してOracle Database 11gリリースで作成したダンプ・ファイルは、Oracle Database 12cリリース1 (12.1)以降でのみインポートできます。 -
VERSION
パラメータの値がインポートに及ぼす影響は、データ・バインドされた照合(DBC)が有効になっているかどうかで異なります。
例
次の例では、ターゲット・データベースをOracle Database 12cリリース1 (12.1.0.1)、ソース・データベースをOracle Database 11gリリース2 (11.2.0.3)と想定しています。ここでは、ネットワーク・ベース・インポートにVERSION=12
を設定する必要があります。また、NETWORK_LINK
パラメータを使用している場合、デフォルト・インポート・モードが全体モードであっても、コマンドラインでこれを指定する必要があります。
> impdp hr FULL=Y DIRECTORY=dpump_dir1
NETWORK_LINK=source_database_link VERSION=12
3.4.58 VIEWS_AS_TABLES (ネットワーク・インポート)
Oracle Data Pump Importのコマンドライン・モードのVIEWS_AS_TABLES
(ネットワーク・インポート)パラメータでは、1つ以上のビューを表としてインポートすることを指定します。
デフォルト
デフォルトはありません
ノート:
このVIEWS_AS_TABLES
の説明は、ネットワーク・インポート時に適用されます(データ・ポンプ・インポートのNETWORK_LINK
パラメータの値を指定する場合)。
用途
1つ以上のビューを表としてインポートするように指定します。
構文および説明
VIEWS_AS_TABLES=[schema_name.]view_name[:table_name], ...
Oracle Data Pumpによって、ビューと同じ列を含み、ビューからフェッチされた行データを含む表がインポートされます。Oracle Data Pumpでは、権限や制約などのビューに依存するオブジェクトもインポートされます。表に適用されない依存オブジェクト(UNDER
オブジェクト権限の付与など)はインポートされません。VIEWS_AS_TABLES
パラメータは、単独で使用することも、TABLES
パラメータと組み合せて使用することもできます。どちらを使用しても、Oracle Data Pumpでは表モード・インポートが実行されます。
構文要素の定義は次のとおりです。
schema_name
: ビューが存在するスキーマの名前。スキーマ名を指定しない場合、デフォルトで、インポートを実行するユーザーになります。
view_name
: 表としてインポートするビューの名前。ビューは存在し、LOB以外のスカラー列のみを含むリレーショナル・ビューである必要があります。無効なビューや存在しないビューを指定すると、そのビューはスキップされてエラー・メッセージが返されます。
table_name
: インポートされるビューのメタデータのソースとなる表の名前。デフォルトでは、Oracle Data Pumpによって、ビューと同じ列およびデータ型を持つ、行の含まれない一時的なテンプレート表が自動的に作成されます。データベースが読取り専用の場合、このテンプレート表のデフォルトの作成には失敗します。この場合、表名を指定できます。表は、ビューと同じスキーマに属している必要があります。これは、ヒープ構成のパーティション化されていないリレーショナル表である必要があります。ネストした表にすることはできません。
テンプレート表が明示的に指定された複数のビューがインポート・ジョブに含まれる場合、それらのテンプレート表はすべて異なっている必要があります。たとえば、2つのビューで同じテンプレート表を使用している次のジョブでは、ビューの1つがスキップされます。
impdp hr DIRECTORY=dpump_dir NETWORK_LINK=dblink1 VIEWS_AS_TABLES=v1:employees,v2:employees
オブジェクトの省略をレポートするエラー・メッセージが返されます。
テンプレート表は、インポート操作の完了後に自動的に削除されます。それらが存在している間は、次の問合せを実行してその名前を表示できます(名前はすべてKU$VAT
で始まります)。
SQL> SELECT * FROM user_tab_comments WHERE table_name LIKE 'KU$VAT%';
TABLE_NAME TABLE_TYPE
------------------------------ -----------
COMMENTS
-----------------------------------------------------
KU$VAT_63629 TABLE
Data Pump metadata template table for view HR.EMPLOYEESV
制限事項
-
VIEWS_AS_TABLES
パラメータは、TRANSPORTABLE=ALWAYS
パラメータと組み合せて使用することはできません。 -
VIEWS_AS_TABLES
パラメータを使用して作成された表には、指定したビューの一部であった非表示列は含まれません。 -
VIEWS_AS_TABLES
パラメータでは、LONG
のデータ型の列のある表をサポートしていません。
例
次の例では、ネットワーク・インポートを実行して、読取り専用データベースからビューhr.v1
のコンテンツをインポートします。ソース・データベースのhr
スキーマには、ビューview1
と同じジオメトリを持つテンプレート表が含まれる必要があります(この表はview1_tab
と呼ばれます)。VIEWS_AS_TABLES
パラメータには、ビュー名と表名をコロンで区切ってリストします。
> impdp hr VIEWS_AS_TABLES=view1:view1_tab NETWORK_LINK=dblink1
ビューは、ビューからフェッチされた行を持つview1
という表としてインポートされます。表のメタデータは、テンプレート表のview1_tab
からコピーされます。
3.5 Oracle Data Pump Import対話方式コマンド・モードで使用可能なコマンド
対話方式コマンド・モードでは、現行のジョブは継続して続行されますが、端末へのロギングは一時停止され、インポート・プロンプト(Import>
)が表示されます。
- Oracle Data Pump Importの対話型コマンド・モードについて
接続されているクライアント、またはジョブが実行されている端末以外からOracle Data Pumpコマンドを実行する方法について説明します。 - CONTINUE_CLIENT
Oracle Data Pumpインポートの対話方式コマンド・モードのCONTINUE_CLIENT
パラメータでは、対話方式コマンド・モードからロギング・モードに変更します。 - EXIT_CLIENT
Oracle Data Pumpインポートの対話方式コマンド・モードのEXIT_CLIENT
パラメータでは、インポート・クライアント・セッションを停止し、インポートを終了して、端末へのロギングを中断します。ただし、現行のジョブの実行は続行します。 - HELP
Oracle Data Pumpインポートの対話型コマンド・モードのHELP
パラメータは、対話型コマンド・モードで使用可能なインポート・コマンドに関する情報を提供します。 - KILL_JOB
Oracle Data Pumpインポートの対話方式コマンド・モードのKILL_JOB
パラメータでは、現在接続中のすべてのクライアント・セッションを切断してから、現行のジョブを停止します。インポート・ユーティリティを終了し、端末プロンプトに戻します。 - PARALLEL
Oracle Data Pumpインポートの対話型コマンド・モードのPARALLEL
パラメータを使用すると、現在のジョブのアクティブな子プロセスまたはPQ子プロセス(あるいはその両方)の数を増減できます。 - START_JOB
Oracle Data Pumpインポートの対話方式コマンド・モードのSTART_JOB
パラメータでは、接続している現行のジョブを開始します。 - STATUS
Oracle Data Pump Importの対話型コマンドのSTATUS
パラメータでは、ジョブ・ステータスが表示され、ロギング・モード・ステータスの表示間隔を更新できます。 - STOP_JOB
Oracle Data Pumpインポートの対話方式コマンド・モードのSTOP_JOB
パラメータでは、現行のジョブを即時にまたは手順に従って停止し、インポートを終了します。
親トピック: Oracleデータ・ポンプ・インポート
3.5.1 Oracle Data Pump Importの対話方式コマンド・モードについて
接続されているクライアント、またはジョブが実行されている端末以外からOracle Data Pumpコマンドを実行する方法を学習します。
対話方式コマンド・モードを開始するには、次のいずれかの方法を使用します。
-
接続されたクライアントから、[Ctrl]を押しながら[C]を押します。
-
ジョブを実行している端末以外の端末から、
ATTACH
パラメータを使用してジョブに接続します。この機能は、ある場所で開始したジョブを、後で別の場所から確認する必要がある場合に有効です。
Oracle Data Pumpの対話方式モード用のコマンド
次の表に、現行のジョブに対して対話方式コマンド・モードでOracle Data Pump Importプロンプトから実行できる操作を示します。
表3-1 Oracle Data Pump Importの対話方式コマンド・モードでサポートされているコマンド
操作 | 使用するコマンド |
---|---|
対話方式コマンド・モードを終了する。 |
|
現行のジョブは続行したままインポート・クライアント・セッションを停止する。 |
|
使用可能なコマンドの概要を表示する。 |
|
現在接続中のすべてのクライアント・セッションを切断し、現行のジョブを停止する。 |
|
現行のジョブに対するアクティブなワーカー・プロセスの数を増減する。このコマンドは、Oracle Database Enterprise Editionでのみ使用可能です。 |
|
接続している停止ジョブを再開する。 |
|
現行のジョブの詳細な状態を表示する。 |
|
現行のジョブを停止する。 |
|
3.5.2 CONTINUE_CLIENT
Oracle Data Pumpインポートの対話方式コマンド・モードのCONTINUE_CLIENT
パラメータでは、対話方式コマンド・モードからロギング・モードに変更します。
用途
モードを、対話方式コマンド・モードからロギング・モードに変更します。
構文および説明
CONTINUE_CLIENT
ロギング・モードでは、ジョブの状態が端末に継続的に出力されます。ジョブが現在停止している場合、CONTINUE_CLIENT
を指定すると、クライアントがジョブの開始を試みます。
例
Import> CONTINUE_CLIENT
3.5.3 EXIT_CLIENT
Oracle Data Pumpインポートの対話方式コマンド・モードのEXIT_CLIENT
パラメータでは、インポート・クライアント・セッションを停止し、インポートを終了して、端末へのロギングを中断します。ただし、現行のジョブの実行は続行します。
用途
インポート・クライアント・セッションを停止し、インポート・ユーティリティを終了して、端末へのロギングを中断します。ただし、現行のジョブの実行は続行します。
構文および説明
EXIT_CLIENT
EXIT_CLIENT
はジョブを実行したままにするため、ジョブがまだ実行中の場合、またはジョブが停止状態の場合は、後でジョブに接続できます。ジョブの状態を確認するには、ジョブのログ・ファイルを監視するか、USER_DATAPUMP_JOBS
ビューまたはV$SESSION_LONGOPS
ビューを問い合せることができます。
例
Import> EXIT_CLIENT
3.5.4 HELP
Oracle Data Pumpインポートの対話型コマンド・モードのHELP
パラメータは、対話型コマンド・モードで使用可能なインポート・コマンドに関する情報を提供します。
用途
対話方式コマンド・モードで使用可能なOracle Data Pumpインポート・コマンドの情報を表示します。
構文および説明
HELP
対話方式コマンド・モードで使用可能なコマンドの情報を表示します。
例
Import> HELP
3.5.5 KILL_JOB
Oracle Data Pumpインポートの対話方式コマンド・モードのKILL_JOB
パラメータでは、現在接続中のすべてのクライアント・セッションを切断してから、現行のジョブを停止します。インポート・ユーティリティを終了し、端末プロンプトに戻します。
用途
現在接続中のすべてのクライアント・セッションを切断してから、現行のジョブを停止します。インポート・ユーティリティを終了し、端末プロンプトに戻します。
構文および説明
KILL_JOB
KILL_JOB
を使用して中断されたジョブは、再開できません。接続中のすべてのクライアント(KILL_JOB
コマンドを発行しているクライアントを含む)は、現在のユーザーがジョブを停止しているという警告を受け取った後、切断されます。すべてのクライアントが切断されると、ジョブ・プロセス構造がただちに停止し、データ・ポンプ制御ジョブ表が削除されます。ログ・ファイルは、削除されません。
例
Import> KILL_JOB
3.5.6 PARALLEL
Oracle Data Pumpインポートの対話型コマンド・モードのPARALLEL
パラメータを使用すると、現在のジョブのアクティブな子プロセスまたはPQ子プロセス(あるいはその両方)の数を増減できます。
用途
現在のジョブのアクティブな子プロセス、パラレル問合せ(PQ)子プロセス、またはその両方の数を増減できます。
構文および説明
PARALLEL=integer
PARALLEL
は、コマンドライン・パラメータおよび対話方式モードのパラメータとして使用可能です。必要な数のパラレル処理を設定できます。増加処理は、リソースが十分にありパラレル化を必要とする作業量が十分にある場合は、即時に実行されます。減少処理は、既存のプロセスが現行のタスクを終了してから実行されます。整数値が減少すると、子プロセスはアイドル状態になりますが、ジョブが終了するまで削除されません。
制限事項
- このパラメータは、Oracle Database 11g以降のリリースのEnterprise Editionでのみ有効です。
-
トランスポータブル表領域のメタデータは、パラレルでインポートできません。
NETWORK_LINK
パラメータも使用されていると、メタデータはパラレルでインポートできなくなります- 次のオブジェクトはパラレルでインポートできません。
TRIGGER
VIEW
OBJECT_GRANT
SEQUENCE
CONSTRAINT
REF_CONSTRAINT
例
Import> PARALLEL=10
3.5.7 START_JOB
Oracle Data Pumpインポートの対話方式コマンド・モードのSTART_JOB
パラメータでは、接続している現行のジョブを開始します。
用途
接続している現行のジョブを開始します。
構文および説明
START_JOB[=SKIP_CURRENT=YES]
START_JOB
コマンドは、(現在実行できない)接続中のジョブを再開します。ダンプ・ファイル・セットおよび親ジョブ表が元のまま保持されている場合は、予期しない障害またはSTOP_JOB
コマンドの発行後にデータの損失や破損なしにジョブが再開されます。
SKIP_CURRENT
オプションでは、以前失敗したジョブ、または特定のオブジェクトでハングしたか、実行が遅いジョブを再開できます。失敗する文または現在処理されているオブジェクトはスキップされ、ジョブは次の項目から再開されます。パラレル・ジョブの場合は、このオプションが原因で、各ワーカーでの現在の処理がスキップされ、再開時に次の項目に移動されます。
トランスポータブル表領域モードで実行されたSQLFILE
ジョブまたはインポートを再開することはできません。
例
Import> START_JOB
3.5.8 STATUS
Oracle Data Pump Importの対話型コマンドのSTATUS
パラメータでは、ジョブ・ステータスが表示され、ロギング・モード・ステータスの表示間隔を更新できます。
用途
ジョブの累積的な状態、現行の操作の説明および推定完了率を表示します。ロギング・モードの状態を表示する間隔を再設定することもできます。
構文および説明
STATUS[=integer]
ロギング・モードでのこの状態の表示頻度を秒単位で指定できるオプションがあります。値を入力しなかった場合またはデフォルト値の0
を使用した場合は、状態の定期表示はオフになり、状態は1回のみ表示されます。
この状態情報は、標準出力デバイスのみに書き込まれ、ログ・ファイルには(使用可能な場合でも)書き込まれません。
例
次に、現行のジョブの状態を表示し、ロギング・モードの表示間隔を2分(120秒)に変更する例を示します。
Import> STATUS=120
3.5.9 STOP_JOB
Oracle Data Pumpインポートの対話方式コマンド・モードのSTOP_JOB
パラメータでは、現行のジョブを即時にまたは手順に従って停止し、インポートを終了します。
用途
現行のジョブを即時にまたは手順に従って停止し、インポートを終了します。
構文および説明
STOP_JOB[=IMMEDIATE]
STOP_JOB
を実行してから、START_JOB
を使用して、後でジョブを接続および再開できます。ジョブを接続および再開するには、コマンドの発行時またはコマンドの発行後に、マスター表とダンプ・ファイル・セットに障害が発生していない必要があります。
手順に従って停止する場合は、関連する値を指定しないでSTOP_JOB
を使用します。確認を要求する警告が発行されます。手順に従った停止では、ワーカー・プロセスで現行のタスクが終了した後、ジョブが停止されます。
即時に停止するには、STOP_JOB=IMMEDIATE
を指定します。確認を要求する警告が発行されます。接続中のすべてのクライアント(STOP_JOB
コマンドを発行しているクライアントを含む)は、現在のユーザーがジョブを停止しているという警告を受け取ります。その後、これらは切断されます。すべてのクライアントが切断されると、ジョブのプロセス構造が即時に停止されます。つまり、データ・ポンプ制御ジョブ・プロセスは、ワーカー・プロセスが現在のタスクを終了するまで待機しません。STOP_JOB=IMMEDIATE
を指定した場合、破損やデータ損失の危険性はありません。ただし、停止時に完了していなかった一部のタスクは、再開時に再実行が必要になる可能性があります。
例
Import> STOP_JOB=IMMEDIATE
3.6 Oracleデータ・ポンプ・インポートの使用例
次の一般的なシナリオ例を使用して、データの移動にOracleデータ・ポンプ・インポートを使用する方法について学習します。
- データのみ表モード・インポートの実行
Oracle Data Pumpを使用してデータのみ表モード・インポートを実行する方法を参照してください。 - スキーマ・モード・インポートの実行
Oracle Data Pumpを使用してスキーマ・モード・インポートを実行する方法を参照してください。 - ネットワーク・モード・インポートの実行
Oracle Data Pumpを使用してネットワーク・モード・インポートを実行する方法を参照してください。 - URLベースのダンプ・ファイル名でのワイルドカードの使用
Oracleデータ・ポンプでは、URLベースのダンプ・ファイル名にワイルドカードを使用できるため、Oracleオブジェクト・ストア・サービスからOracle Autonomous Databaseへの複数のダンプ・ファイルのインポートが簡単になります。
親トピック: Oracleデータ・ポンプ・インポート
3.6.1 データのみ表モード・インポートの実行
Oracle Data Pumpを使用してデータのみ表モード・インポートを実行する方法を参照してください。
この例では、表はemployees
という名前です。ここでは、表モード・エクスポートの実行で作成したダンプ・ファイルを使用します。
CONTENT=DATA_ONLY
パラメータは、すべてのデータベース・オブジェクト定義(メタデータ)をフィルタから除外します。表の行データのみロードされます。
例3-1 データのみ表モード・インポートの実行
> impdp hr TABLES=employees CONTENT=DATA_ONLY DUMPFILE=dpump_dir1:table.dmp
NOLOGFILE=YES
関連トピック
親トピック: Oracleデータ・ポンプ・インポートの使用例
3.6.2 スキーマ・モード・インポートの実行
Oracle Data Pumpを使用してスキーマ・モード・インポートを実行する方法を参照してください。
これは、スキーマ・モード・エクスポートの実行で作成したダンプ・ファイル・セットのスキーマ・モード・インポートの例です。
例3-2 スキーマ・モード・インポートの実行
> impdp hr SCHEMAS=hr DIRECTORY=dpump_dir1 DUMPFILE=expschema.dmp
EXCLUDE=CONSTRAINT,REF_CONSTRAINT,INDEX TABLE_EXISTS_ACTION=REPLACE
EXCLUDE
パラメータは、インポートしたメタデータをフィルタします。指定したインポート・モードでは、EXCLUDE
文に指定されたオブジェクトを除き、ソースに含まれるすべてのオブジェクトおよびその依存オブジェクトが含まれます。オブジェクトが除外されると、そのオブジェクトのすべての依存オブジェクトも除外されます。TABLE_EXISTS_ACTION=REPLACE
パラメータでは、表がすでに存在する場合は削除し、ダンプ・ファイルの内容でその表を再作成してロードするように指定します。
関連トピック
親トピック: Oracleデータ・ポンプ・インポートの使用例
3.6.3 ネットワーク・モード・インポートの実行
Oracle Data Pumpを使用してネットワーク・モード・インポートを実行する方法を参照してください。
ネットワーク・モード・インポートでは、NETWORK_LINK
パラメータで指定されたデータベースをソースとして使用します。
例3-3 スキーマのネットワーク・モード・インポート
> impdp hr TABLES=employees REMAP_SCHEMA=hr:scott DIRECTORY=dpump_dir1
NETWORK_LINK=dblink
この例では、hr
スキーマからscott
スキーマへemployees
表をインポートします。dblink
は、ターゲット・データベースとは異なるソース・データベースを示します。
スキーマを再マップするには、ユーザーhr
に、ローカル・データベースのDATAPUMP_IMP_FULL_DATABASE
ロールおよびソース・データベースのDATAPUMP_EXP_FULL_DATABASE
ロールが必要です。
REMAP_SCHEMA
は、ソース・スキーマにあるすべてのオブジェクトをターゲット・スキーマにロードします。
関連トピック
親トピック: Oracleデータ・ポンプ・インポートの使用例
3.6.4 URLベースのダンプ・ファイル名でのワイルドカードの使用
Oracleデータ・ポンプでは、URLベースのダンプ・ファイル名にワイルドカードを使用できるため、Oracleオブジェクト・ストア・サービスからOracle Autonomous Databaseへの複数のダンプ・ファイルのインポートが簡単になります。
例3-4 URLベースのファイル名に使用したワイルドカード
この例は、Oracleオブジェクト・ストア・サービスからOracle Autonomous Databaseに複数のダンプ・ファイルをインポートするために、ファイル名にワイルドカードを使用する方法を示しています。
> impdp admin/password@ATPC1_high
directory=data_pump_dir credential=my_cred_name
dumpfile= https://objectstorage.example.com/v1/atpc/atpc_user/exp%u.dmp"
ノート:
ワイルドカード文字は、URLのバケット名コンポーネントには使用できません。
親トピック: Oracleデータ・ポンプ・インポートの使用例
3.7 Oracle Data Pump Importの構文図
構文図を使用すると、Oracle Data Pump Importでの有効なSQL構文を理解できます。
構文図の読み方
構文図とは、SQLの有効な構文を図で示したものです。構文図は、矢印が示す方向に左から右へ読んでください。
標準のSQL構文表記法の詳細は、次を参照してください。
ImpInit
ImpStart
ImpModes
ImpOpts
ImpOpts_続き
ImpContent
ImpEncrypt
ImpFilter
ImpPartitioning
ImpRacOpt
ImpFileOpts
ImpNetworkOpts
ImpDynOpts
ImpTransforms
ImpVersion
ImpDiagnostics
親トピック: Oracleデータ・ポンプ・インポート