import_subset

指定されたターゲット・データベースにダンプ・ファイルをインポートします。

書式

emcli import_subset_dump
      -target_name=<Target Database>
      -target_type=<Target Database type>
      [-db_cred_name=<Database Credential Name>]
      [-db_pref_cred_name=<DBCredsNormal | DBCredsSYSDBA> ]
      [-host_cred_name=<Host Credential Name>]
      [-subset_directory=<Database Directory Object Name> ]
      [-custom_directory_path=<Custom Directory Path>]
      [-use_external_directory]
      [-external_directory=<External Directory Object Name>]
      [-export_file_name=<Exported Dump File Name>]
      [-max_imp_threads=< Maximum Number of Import Threads>]
      [-encrypted_dump_file]
      [-encryption_password=<Encryption Password>]
      [-import_type=<ALL | DATA_T_L| DATA_A_L> ]
      [-tablespace_map=<Tablespace Map>]
      [-schema_map=<Schema Map>]
      [-log_file_name=<Log file name>]
      [-job_name=<Job Name>]
      [-job_description=<Job Description>]
      [-oid_transform]

[ ]  indicates that the parameter is optional

オプション

target_name

既存のターゲット・データベースの名前。
target_type

ターゲットのタイプ。ターゲット・タイプとして指定できる値は、oracle_database、rac_databaseおよびoracle_pdbです。
db_cred_name

選択したターゲット・データベースに接続するための、Enterprise Managerリポジトリに格納されている既存の資格証明の名前。db_pref_cred_nameまたはdb_cred_nameのいずれかに値を指定する必要があります。
db_pref_cred_name

Enterprise Managerリポジトリに格納されている優先資格証明の名前。

有効な値は次のとおりです。
- DBCredsNormal - oracle_databaseターゲット用のデフォルトの標準資格証明セット。
- DBCredsSYSDBA - oracle_databaseターゲット用のSYSDBA資格証明セット。
db_pref_cred_nameまたはdb_cred_nameのいずれかに値を指定する必要があります。
host_cred_name

ターゲット・ホストにアクセスするための、Enterprise Managerリポジトリに格納されている既存のホスト資格証明の名前。
subset_directory

ダンプ・ファイルが格納されるデータベース・ディレクトリ。たとえば、DATA_PUMP_DIRです。

subset_directoryまたはcustom_directory_pathのいずれかに値を指定する必要があります。
custom_directory_path

ダンプ・ファイルが存在するターゲット・ホスト上のユーザー指定ディレクトリの場所。たとえば、/scratch/user/subset_dirです。

subset_directoryまたはcustom_directory_pathのいずれかに値を指定する必要があります。
use_external_directory

高速インポート処理のために外部ディレクトリ(クラスタ化/共有ファイル・システムまたはASM)の使用を有効化するフラグ。このオプションを設定しない場合は、external_directoryの値を指定する必要があります。
external_directory

高速ホスト・アクセスのための外部ディレクトリの場所(クラスタ化/共有ファイル・システムまたはASM)のオブジェクト。たとえば、DATA_PUMP_DIRです。
export_file_name

インポートするダンプ・ファイルの名前。値を指定しない場合はデフォルト値のEXPDAT%U.DMPになります。
max_imp_threads

インポート・スレッドの最大数。値を指定しない場合はデフォルト値の1になります。
encrypted_dump_file

エクスポート操作で暗号化パスワードが指定された場合は、このオプションを設定します。このオプションを使用する場合は、encryption_passwordの値も指定する必要があります。
encryption_password

暗号化されたデータをインポート操作の際に復号化するためのパスワード。エクスポート操作で指定されたものと同じパスワードを指定する必要があります。encrypted_dump_fileオプションが設定されたときに、このオプションの値が指定されないと、暗号化パスワードの入力を求められます。セキュアな操作のためには、パスワードをスクリプトに含めずに、プロンプトに対して指定することをお薦めします。
import_type

インポート操作を設定します。有効な値は次のとおりです。
- ALL: メタデータとデータの両方をインポートします。
- DATA_T_L: 既存の表のデータが削除されます。インポート・ソースのデータによって置換されます。
- DATA_A_L: インポートされる表に含まれるデータが、既存の表の末尾に追加されます。
デフォルト値はALLです。
tablespace_map

このパスワードは、表領域と表領域の間でデータを再マッピングするために必要です。次に例を示します。
```
-tablespace_map="source_tbsp1:target_tbsp1;source_tbsp2:target_tbsp2"
```
schema_map

このパスワードは、スキーマとスキーマの間でデータを再マッピングするために必要です。
```
-schema_map="source_schema1:target_schema1;source_schema2:target_schema2"
```
log_file_name

値を指定しない場合はデフォルト値のIMPORT.LOGになります。
oid_transform

デフォルトでは、エクスポートされたOIDが表またはタイプの作成時にインポートされます。このオプションを設定すると、新しいOIDが作成されます。これは、データベース内にいくつかのオブジェクトがすでに存在しており、クローン・コピーが必要な場合に役立ちます。ただし、このオプションを選択すると、表を指すREF列が破損します。
job_name

サブセット・ダンプ・インポート操作のジョブ名。
job_description

ジョブの説明。

出力

成功またはエラー・メッセージ、およびジョブ名(該当する場合)。

例

例1

この例では、DATA_PUMP_DIRディレクトリにあるダンプ(E.dmp)をターゲットsample_databaseにインポートします。

emcli import_subset_dump -db_cred_name=db_cred -export_file_name=E.dmp -host_cred_name=host_cred -subset_directory=DATA_PUMP_DIR -target_type=oracle_database -target_name=sample_database -import_type=All

例2

この例では、優先データベース資格証明および優先ホスト資格証明を使用して、DATA_PUMP_DIRディレクトリにあるダンプ(E.dmp)をターゲットsample_databaseにインポートします。

emcli import_subset_dump -export_file_name=E.dmp -db_pref_cred_name=DBCredsNormal -subset_directory=DATA_PUMP_DIR -target_type=oracle_database -target_name=sample_database -import_type=All