clone_database

データベースをクローニングします。

書式

emcli clone_database
      -source_db_name="source_database_name"
      -dest_global_dbname="global_name_of_clone_database" 
      -dest_oracle_sid="clone_database_instance_name"
      [-dest_host_name="clone_host_name"]  
      [-dest_oracle_home="clone_database_oracle_home"] 
      [-source_db_creds_name="source_database_credential_name"] 
      [-source_host_creds_name="source_database_host_credential_name"] 
      [-dest_host_creds_name="clone_database_host_credential_name"] 
      [-asm_inst_creds_name="asm_instance_credential_name"]  
      [-dest_target_name="clone_database_name"] 
      [-clone_type="clone_type"] 
      [-source_staging_area="source_staging_directory"]  
      [-dest_staging_area="clone_database_staging_directory"]  
      [-dest_storage_type="clone_database_storage_type"] 
      [-dest_database_area="clone_database_files_location"] 
      [-dest_recovery_area="clone_database_fast_recovery_area"] 
      [-dest_listener_selection="clone_database_listener_selection"] 
      [-dest_listener_name="clone_database_listener_name"]
      [-dest_listener_port="clone_database_listener_port"]
      [-configure_with_oracle_restart"] 
      [-job_name="job_name"] 
      [-job_desc="job_description"]
      [-src_ssh_tunnel_port="<ssh tunnel port used by standby to connect to primary>"]
      [-dest_ssh_tunnel_port="<ssh tunnel port used by primary to connect to standby>"]
      [-src_gateway_cred_name="<primary database host hybrid gateway agent credential name>"]
      [-dest_gateway_cred_name="<standby database host hybrid gateway agent credential name>"]
      [-dest_GI_host_creds_name="<standby database grid infrastructure credential name>"]
      [-tde_wallet_creds_name="<transparent data encryption wallet credentials of the source database>"]

[ ] indicates that the parameter is optional

オプション

source_db_name

ソース・データベースのEnterprise Managerターゲット名。単一インスタンス・データベースまたはクラスタ・データベース・インスタンスのいずれも可能です。
dest_global_dbname

クローン・データベースのグローバル・データベース名。通常、<name>.<domain>で指定されます(ここで<name>は、db_unique_nameに使用され、<domain>はdb_domain_nameオプションに使用されます)。
dest_oracle_sid

クローン・データベースのインスタンス名。
dest_host_name

クローン・データベースのホスト名。指定しない場合、クローン・データベースはソース・データベースと同じホストに作成されます。
dest_oracle_home

クローン・データベースのOracleホーム。指定しない場合、ソース・データベースのOracle Homeが使用されます。
source_db_creds_name

ソース・データベースの名前付き資格証明。
source_host_creds_name

ソース・データベース・ホストの名前付き資格証明。
dest_host_creds_name

宛先(クローン)のホスト名前付き資格証明。
asm_inst_creds_name

自動ストレージ管理(ASM)の名前付き資格証明。
dest_target_name

クローン・データベースのEnterprise Managerターゲット名。
clone_type

クローニングに使用されるソース・データベース・バックアップのタイプ。有効な値は次のとおりです。
- DUPLICATE: Recovery Manager (RMAN)によりデータベース・ファイルはクローン・データベース・ホストに直接移動されます。
- STAGING: データベース・ファイルはステージング領域にバックアップされ、HTTPを介してクローン・データベース・ホストに移動されます。
- EXISTING_BACKUP: Recovery Manager (RMAN)によりデータベース・ファイルは既存のバックアップからクローン・データベース・ホストにリストアされます。
pitr_date

MM/dd/yyyy hh:mm:a (月/日/年時:分:AM/PMマーカー)の書式での指定日のクローン・データベース。たとえば: 03/22/2014 08:25:AM。指定しない場合、クローン・データベースは最新のPoint-in-Timeで作成されます。このオプションは、clone_typeがEXISTING_BACKUPの場合に使用できます。
pitr_scn

ソース・データベースの指定したシステム変更番号のクローン・データベース。指定しない場合、クローン・データベースは最新のPoint-in-Timeで作成されます。このオプションは、clone_typeがEXISTING_BACKUPの場合に使用できます。
encryption_mode

既存のソース・データベース・バックアップの暗号化モード。指定されていない場合、デフォルト値はNONEです。このオプションは、clone_typeがEXISTING_BACKUPの場合に使用できます。有効な値は次のとおりです。
- WALLET: バックアップはOracle Encryption Walletを使用して暗号化されます。
- PASSWORD: バックアップはパスワードを使用して暗号化されます。
- DUAL: バックアップはOracle Encryption Walletおよびパスワードの両方を使用して暗号化されます。
backups_encryption_creds_name

暗号化されたバックアップのデータベースの名前付き資格証明。このオプションはencryption_modeがPASSWORDまたはDUALの場合使用できます。

ノート:

このオプションは、クローン・タイプがEXISTING_BACKUPで、データベース・バックアップがパスワードを使用して暗号化されている場合のみ使用できます。このデータベース資格証明は、Enterprise Managerでユーザー名をbackup_adminに指定してスコープはGLOBALで作成する必要があります。
tape_settings

データベースがテープにバックアップされている場合、メディア管理ベンダー設定。このオプションは、clone_typeがEXISTING_BACKUPの場合に使用できます。
db_backups_location

バックアップの宛先ホストの転送場所。,をデリミタに使用して、複数の値を指定できます。このオプションは、clone_typeがEXISTING_BACKUPで、様々なホストにクローニングする場合に使用できます。
ノート:

このオプションは、クローン・タイプがEXISTING_BACKUPで、ソース・データベース・バックアップを参照できない様々なホストでデータベースがクローンされるときのみ使用できます。バックアップが宛先ホストから参照可能な場合、このオプションは指定しないようにする必要があります。
- データベースのバックアップ・サイズが大容量な場合、宛先ホストから参照可能な共通の場所にバックアップする必要があります。
- ソース・データベース・バックアップがASMディスク・グループ上にある場合、これらのバックアップは転送されないのでディスクグループが宛先ホストにマウントされるようにします。
- このオプションを指定済と指定した場合、この場所で利用可能なすべてのファイルは、宛先ホストの一時的なステージング領域に転送されます。
- このオプションは、カンマ(,)をデリミタに使用して複数の値を指定できます。
source_staging_area

ソース・データベースのバックアップを格納するために使用されるステージング領域。このオプションは、clone_typeがSTAGINGの場合に使用できます。
dest_staging_area

ソース・ホストから転送されたバックアップ・ファイルを格納するために使用されるステージング領域。このオプションは、clone_typeがSTAGINGの場合に使用できます。
dest_storage_type

クローン・データベースのストレージ・タイプ。有効な値は次のとおりです。
- FILE_SYSTEM: クローン・データベース・ファイルは、(Oracle Managed Filesを使用した)標準のファイル・システムに配置されます。
- ASM: クローン・データベースは自動ストレージ管理(ASM)を使用します。
dest_database_area

クローン・データベース・ファイルのOracle Managed Files (OMF)の場所。これは、(storage_typeがFILE_SYSTEMの場合は)標準のファイル・システムまたは(storage_typeがASMの場合は)ASMディスク・グループになります。指定されていない場合、デフォルト値が使用されます。
dest_recovery_area

高速リカバリ領域の場所。指定されていない場合、デフォルト値が使用されます。
dest_listener_selection

選択したクローン・データベース・リスナー。有効な値は次のとおりです。
- GRID_INFRA: グリッド・インフラストラクチャ・ホームのリスナーを使用します。
- DEST_DB_HOME: クローン・データベースOracle Homeのリスナーを使用します。
dest_listener_name

クローン・データベースのリスナー名。このオプションは、dest_listener_selectionがDEST_DB_HOMEの場合のみ使用できます。指定しない場合、クローン・データベースOracle Homeに存在する最初のTCPリスナーが使用されます。このオプションを指定した場合、dest_listener_portも指定する必要があります。
dest_listener_port

クローン・データベースのリスナー・ポート。このオプションは、dest_listener_selectionがDEST_DB_HOMEの場合のみ使用できます。このオプションを指定した場合、dest_listener_nameも指定する必要があります。
configure_with_oracle_restart

クローン・ホストにOracle Restartが構成されている場合、クローン・データベースにOracle Restartを構成します。Oracle Restartは必要に応じて、自動的にデータベースを開始します。
job_name

クローン・ジョブに固有のEnterprise Managerリポジトリ内のジョブ名。
job_desc

ジョブの説明。
src_ssh_tunnel_port

スタンバイ・データベースがプライマリ・データベースに接続するために使用するSSHトンネル・ポート。これは、接続リクエストをプライマリ・データベース・リスナー・ポートに転送するためにスタンバイ・ホストで作成されたポートです。
dest_ssh_tunnel_port

プライマリ・データベースがスタンバイ・データベースに接続するために使用するSSHトンネル・ポート。これは、接続リクエストをスタンバイ・データベース・リスナー・ポートに転送するためにプライマリ・ホストで作成されたポートです。
src_gateway_creds_name

プライマリ・データベース・ホストのハイブリッド・ゲートウェイ・エージェントの名前付き資格証明。
dest_gateway_creds_name

スタンバイ・データベース・ホストのハイブリッド・ゲートウェイ・エージェントの名前付き資格証明。
dest_GI_host_creds_name

グリッド・インフラストラクチャのOracleホームにアクセスできるオペレーティング・システム・ユーザーのグリッド・インフラストラクチャの名前付き資格証明。
tde_wallet_creds_name
ソース・データベースの透過的データ暗号化ウォレット資格証明。次に示すようにcreate_named_credential動詞を使用して、これらの資格証明を作成します。
```
emcli create_named_credential
	-cred_name=WC1 -cred_type=GenericPassword
	-auth_target_type='<system>'
	-attributes="GENERIC_PASSWORD:<Source Database TDE Wallet Password>"
```

例1

emcli clone_database 
	-source_db_name="database" 
	-dest_target_name="dbClone1" 
	-dest_host_name="host1" 
	-dest_oracle_home="/ade/ngade_gct/oracle" 
	-dest_oracle_sid="dbClone1" 
	-dest_global_dbname="dbClone1" 
	-dest_listener_selection="DEST_DB_HOME" 
	-clone_type="DUPLICATE" 
	-dest_storage_type="FILE_SYSTEM"

例2

emcli clone_database 
	-source_db_name="database" 
	-source_db_creds_name="NC_DBCREDS1" 
	-source_host_creds_name="NC_HOST_CREDS1" 
	-dest_host_name="host1" 
	-dest_host_creds_name="NC_HOST_CREDS2" 
	-dest_oracle_home="/u01/app/oracle/product/11.2.0/dbhome_2" 
	-dest_oracle_sid="TESTDB1" -dest_global_dbname="TESTDB1" 
	-dest_listener_selection="GRID_INFRA" 
	-clone_type="EXISTING_BACKUP" 
	-dest_storage_type="FILE_SYSTEM" 
	-db_backups_location="/oracle/dir1"

例3

次のコマンドは、クラウド・ホスト'cloudhost.oracle.com'上にTDEで暗号化されたソース・データベースのクローン・データベースを作成します。ソース・データベースとクローン・データベース間の通信は、指定されたトンネル・ポートを使用して確立されます。

emcli clone_database 
	-source_db_name="database"
	-source_db_creds_name="NC_DBCREDS1"
	-source_host_creds_name="NC_HOST_CREDS1"
	-dest_host_name="cloudhost.oracle.com"
	-dest_host_creds_name="OPC_SSH_NAMED_CREDS"
	-dest_oracle_home="/u01/app/oracle/product/12.1.0/dbhome_2"
	-dest_oracle_sid="TESTDB1"
	-dest_global_dbname="TESTDB1"
	-dest_listener_selection="GRID_INFRA"
	-clone_type="DUPLICATE"
	-dest_storage_type="FILE_SYSTEM"
	-dest_gateway_creds_name='DEST_GATEWAY_CREDS'
	-dest_GI_host_creds_name="DEST_GRID_CREDS"
	-src_ssh_tunnel_port="4001"
	-dest_ssh_tunnel_port="4001"
	-configure_with_oracle_restart"
	-tde_wallet_creds_name='WC1'