generate_subset

指定されたサブセット定義とターゲット・データベースを使用してサブセットを生成します。

書式

emcli generate_subset
      -subset_name=<subset_definition_name>
      -target_name=<target_name>      -target_type=<target_type>
      [-in_place_delete]
      [-db_pref_cred_name=<DBCredsNormal | DBCredsSYSDBA>]
      [-db_cred_name=<database_credential_name>]
      [-host_cred_name=<host_credential_name>]
      [-rule_parameters=<rule_parameters>]
      [-subset_directory=<database_directory_object_name>]
      [-custom_directory_path=<custom_directory_path> ]
      [-use_external_directory]
      [-external_directory=<external_directory_object_name>]
      [-export_file_name=<export_file_name>]
      [-max_file_size=<maximum_file_size>]
      [-max_threads=<maximum_number_of_threads>]
      [-compress_dump_file=<compress_dump>]
      [-encrypt_dump_file]
      [-encryption_password=<encryption_password>
      [-confirm_encryption_password=<encryption_password_confirmation>]
      [-seed_flag]
      [-seed_password=<seed_password>]
      [-log_file_name=<log_file_name>]
      [-job_name=<job_name>]
      [-job_description=<job_description>]
      [-is_non_prod_env]

[ ]  indicates that the parameter is optional

オプション

subset_name

サブセットを生成する既存のサブセット定義の名前。
target_name

データベース・ターゲット名。
target_type

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

サブセット操作を生成するかどうかを決定します。デフォルトの操作では、データをダンプ・ファイルにエクスポートします。指定したターゲットからデータを削除するには、このフラグを設定します。
db_pref_cred_name

Enterprise Managerリポジトリに格納されている優先資格証明の名前。db_pref_cred_nameまたはdb_cred_nameのいずれかに値を指定する必要があります。このオプションに対する有効な値は次のとおりです。
- DBCredsNormal - oracle_databaseターゲット用のデフォルトの標準資格証明セット。
- DBCredsSYSDBA - oracle_databaseターゲット用のSYSDBA資格証明セット。
db_cred_name

選択したターゲット・データベースに接続するための、Enterprise Managerリポジトリに格納されている既存の資格証明の名前。
host_cred_name

ターゲット・ホストにアクセスするための、Enterprise Managerリポジトリに格納されている既存のホスト資格証明の名前。値を指定しないと、このターゲットに設定された優先ホスト資格証明が、ターゲット・ホストへのアクセスに使用されます。
rule_parameters

値をルール・パラメータ名にマップします。いずれかのルール・パラメータの値がない場合、このオプションの値を指定する必要があります。また、このオプションを使用して、指定された値を上書きすることもできます。

次に例を示します。
```
-rule_parameters="department_id_param:80;order_id_param:2400"
```
subset_directory

ダンプ・ファイルとログ・ファイルを保存するディレクトリの場所のオブジェクト名。次に例を示します。
```
DATA_PUMP_DIR
```
custom_directory_path

ダンプ・ファイルとログ・ファイルを保存する、ターゲット・ホスト上のユーザー指定ディレクトリの場所。subset_directoryまたはcustom_directory_pathのいずれかに値を指定する必要があります。次に例を示します。
```
/scratch/user/subset_dir
```
use_external_directory

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

高速エクスポート・ダンプのための外部ディレクトリ(クラスタ化/共有ファイル・システムまたはASM)。次に例を示します。
```
DATA_PUMP_DIR
```
export_file_name

ダンプ・ファイルを保存するファイル名。値を指定しない場合はデフォルト値のEXPDAT%U.DMPになります。ファイル名に%Uを使用して、一連のダンプ・ファイルをワイルドカードによって指定できます。
max_file_size

最大ファイル・サイズ(MB)。値を指定しない場合はデフォルト値の100になります。
max_threads

エクスポート操作で作成されるスレッドの最大数。値を指定しない場合はデフォルト値の1になります。
compress_dump_file

エクスポート操作中のデータ圧縮を有効にします。
encrypt_dump_file

エクスポート操作中のデータ暗号化を有効にします。
encryption_password

エクスポート操作中にデータを暗号化するパスワードのキー。encrypt_dump_fileを設定したが、このオプションの値を指定しないと、暗号化パスワードを指定するように求められます。セキュアな操作のためには、パスワードをスクリプトに含めずに、プロンプトに対して指定することをお薦めします。
confirm_encryption_password

このオプションの値は、encryption_passwordと同じにする必要があります。encrypt_dump_fileを設定したが、このオプションの値を指定しないと、暗号化パスワードの確認を入力するように求められます。セキュアな操作のためには、パスワードをスクリプトに含めずに、プロンプトに対して指定することをお薦めします。
seed_flag

サブセット定義に1つ以上のマスキング定義が含まれ、マスキング定義のいずれかに置換フォーマットまたは暗号化フォーマットが含まれることを指定します。
seed_password

サブセット定義に1つ以上のマスキング定義が含まれ、マスキング定義のいずれかに置換フォーマットまたは暗号化フォーマットが含まれる場合に使用されるシード文字列。seed_flagを設定したが、このオプションの値を指定しないと、シード・パスワードを指定するように求められます。シードには任意のテキスト文字列を使用できます。セキュアな操作のためには、パスワードをスクリプトに含めずに、プロンプトに対して指定することをお薦めします。
log_file_name

ログ・ファイルを保存するファイル名。デフォルト値はEXPDAT.LOGです。
is_non_prod_env

指定したデータベースが本番データベースではないという確認。in_place_deleteオプションが設定されている場合、このオプションは必須です。
job_name

サブセット・ジョブ名を生成します。
job_description

ジョブの説明。

出力

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

例

例1

この例では、ルール・パラメータを使用してデータをダンプ・ファイルにエクスポートします。

emcli generate_subset 
      -subset_name=hr_subset 
      -target_name=sample_database  
      -target_type=oracle_database 
      -export_file_name=EXPDAT.DMP 
      -db_cred_name=db_cred 
      -host_cred_name=host_cred  
      -subset_directory=DATA_PUMP_DIR 
      -rule_parameters="department_id:80;order_id:2400"

例2

この例では、暗号化を有効にしてデータをダンプ・ファイルにエクスポートします。encryption_passwordとconfirm_encryption_passwordの入力を求められます。

emcli generate_subset 
      -subset_name=hr_subset 
      -target_name=sample_database 
      -encryption_password  
      -target_type=oracle_database 
      -export_file_name=EXPDAT.DMP 
      -db_cred_name=db_cred 
      -host_cred_name=host_cred  
      -subset_directory=DATA_PUMP_DIR