submit_masking_job

マスキング・ジョブを発行し、表示ジョブIDと実行IDを返します。

書式

emcli submit_masking_job
    -definition_name=<masking_defn_name>
    -target_name=<database_target_name>
    -target_type=<database_target_type>
    -parameters=name1:value1;name2:value2;...
    [-host_pref_creds_name=<preferred_host_credentials_name> 
      OR -host_cred_name=<host_credential_name>]
    [-db_pref_creds_name=<preferred_db_credentials_name> 
      OR -db_cred_name=<db_credential_name>]
    [-encryption_key=<encryption_key_string]
    [-script_file_location=<script_file_location>]
    [-script_file_name=<script_file_name>]
    [-input_file=PWD_FILE_TAG:<credentials_file_name>]
    [-script | -format=[name:<pretty|script|csv>];
         [column_separator:"column_sep_string"];
         [row_separator:"row_sep_string"];
    ]

[ ]  indicates that the parameter is optional

ノート:

ホストおよびDB資格証明の値が-parametersパラメータに指定されないかぎり、host_pref_creds_nameまたはhost_cred_nameパラメータを指定する必要があります。同様に、db_pref_creds_nameまたはdb_cred_nameパラメータを指定する必要があります。

オプション

  • definition_name

    マスキング定義の名前。

  • target_name

    マスクするデータベース・ターゲット名。

  • target_type

    マスクするデータベース・ターゲット・タイプ。

  • parameters

    データベース・インスタンスへの接続に必要な資格証明を示す名前と値のペアのリスト。サポートされているパラメータは、db_username、db_password、db_role、db_cred_name、host_username、host_passwordおよびhost_cred_nameです。PDPを使用する必要がある場合、指定する追加のパラメータはPDP、RUNASおよびPROFILEです。PROFILEオプションは、Powerbrokerにのみ適用されます。

  • host_pref_creds_name

    データベース・ホストへの接続に使用する優先資格証明のタイプ。HostCredsNormalまたはHostCredsPrivのいずれかです。

  • host_cred_name

    データベース・ホストへの接続に使用する資格証明名。

  • db_pref_creds_name

    データベース・インスタンスへの接続に使用する優先資格証明のタイプ。DBCredsNormalまたはDBCredsSYSDBAのいずれかです。

  • db_cred_name

    データベース・インスタンスへの接続に使用する資格証明名。

  • encryption_key

    マスキング定義に置換フォーマットの使用が含まれる場合は、暗号化キーを指定します。

  • script_file_location

    SQLスクリプトがコピーされて実行される場所。値を指定しない場合、デフォルト値の$ORACLE_HOME/dbsが使用されます。

  • script_file_name

    マスキングSQLスクリプトを格納するスクリプト・ファイルの名前。名前を指定しない場合、システム生成のファイル名が使用されます。

  • input_file

    parametersオプションとともに使用すると、ユーザー名やパスワードなどのパラメータ値を別のファイルで格納できます。input_fileオプションでは、タグとローカルのファイル・パス間のマッピングを指定します。タグは、parametersオプションの特定のパラメータ値のかわりに指定します。複数の-input_fileパラメータを指定できます。結果は、すべてのファイルの組合せになります。

    input_fileパラメータの詳細は、「-input_fileの構文ガイドライン」を参照してください。

  • script

    このオプションは、-format="name:script"と同じです。

  • format

    書式指定(デフォルトは-format="name:pretty")。

    • format="name:pretty"は、スクリプトによる解析を目的としない読取り可能な書式で出力表を出力します。

    • format="name:script"は、デフォルトの列セパレータをタブに、デフォルトの行セパレータを改行に設定します。列および行セパレータの文字列を指定して、これらのデフォルトを変更できます。

    • format="name:csv"は、列セパレータをカンマに、行セパレータを改行に設定します。

    • format=column_separator:"column_sep_string"は、verb出力の列を<column_sep_string>で区切ります。行は改行で区切られます。

    • row_separator:"row_sep_string"は、verb出力の行を<row_sep_string>で区切ります。行はタブ文字で区切られます。

例1

この例では、定義名MASKING_DEFに対するマスキング・ジョブを発行し、ジョブIDと実行IDを返します。

emcli submit_masking_job -definition_name=MASKING_DEF -target_name=testdb -target_type=oracle_database -parameters="db_username:sys;db_password:password;db_role:SYSDBA;db_cred_name:DBCREDS;host_username:test;host_password:password;host_cred_name:HOSTCREDS"

例2

この例では、指定された入力ファイルhost_creds.txtおよびdb_creds.txtから資格証明を取得します。

emcli submit_masking_job -definition_name=MASKING_DEF -target_name=testdb -target_type=oracle_database  -parameters="HOST_CREDS;DB_CREDS" -input_file=HOST_CREDS:host_creds.txt -input_file=DB_CREDS:db_creds.txt

1つのファイルで両方の資格証明を指定し、1つの-input_fileタグのみを使用することもできます。PDPを使用する必要がある場合、パラメータまたはinput_fileで値を次のように指定する必要があります。

  • SUDO:

    db_username:sys;db_password:password;db_role:SYSDBA;host_username:user2;host_password:password;PDP:SUDO;RUNAS:user1
    
  • POWERBROKER:

    db_username:sys;db_password:password;db_role:SYSDBA;host_username:user2;host_password:password;PDP:POWERBROKER;RUNAS:user1;PROFILE:profile