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"]
      [-win_svc_host_creds_name="clone_database_windows_service_host_credential_name"] 
      [-asm_inst_creds_name="asm_instance_credential_name"]  
      [-dest_target_name="clone_database_name"] 
      [-clone_type="clone_type"]
      [-pitr_date="point-in-time_recovery_date"|-pitr_scn="point-in-time_recovery_system_change_number"]
      [-encryption_mode="encryption_mode_of_database_backups"]
      [-backups_encryption_creds_name="database_named_credential_for_encrypted_backups"]
      [-tape_settings="tape_settings"] 
      [-db_backups_location="source_database_backups_location"]
      [-are_backups_on_dest_host]
      [-degree_of_parallelism="number_of_parallel_channels_used_by_RMAN"]
      [-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]
      [-multiplex_locs="multiplex_locations"] 
      [-job_name="job_name"] 
      [-job_desc="job_description"]
      [-src_ssh_tunnel_port="<ssh tunnel port used by clone to connect to primary>"]
      [-dest_ssh_tunnel_port="<ssh tunnel port used by primary to connect to clone>"]
      [-src_gateway_cred_name="<primary database host hybrid gateway agent credential name>"]
      [-dest_gateway_cred_name="<clone database host hybrid gateway agent credential name>"]
      [-dest_GI_host_creds_name="<clone database grid infrastructure credential name>"]
      [-tde_wallet_creds_name="<transparent data encryption wallet credentials of the source database>"]
      [-tde_wallet_location="<transparent data encryption wallet location>"]

[ ] 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

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

データベース・サービスが構成されるOracleホーム・ユーザー・アカウントのWindowsホスト資格証明。
asm_inst_creds_name

自動ストレージ管理(ASM)の名前付き資格証明。サポートされている資格証明タイプは、SYSDBAおよびSYSASMです。
dest_target_name

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

クローニングに使用されるソース・データベース・バックアップのタイプ。有効な値は次のとおりです。
- DUPLICATE — Recovery Manager (RMAN)によりデータベース・ファイルはクローン・データベース・ホストに直接移動されます。
- STAGING — データベース・ファイルはステージング領域にバックアップされ、HTTPを介してクローン・データベース・ホストに移動されます。
- EXISTING_BACKUP — 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_dateとpitr_scnは同時に使用できません。これらのうち1つのみを指定できます。
pitr_scn

ソース・データベースの指定したシステム変更番号(SCN)のクローン・データベース。指定しない場合、クローン・データベースは最新のPoint-in-Timeで作成されます。このオプションは、clone_typeがEXISTING_BACKUPの場合に使用できます。オプションpitr_dateとpitr_scnは同時に使用できません。これらのうち1つのみを指定できます。
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ディスク・グループ上にある場合、これらのバックアップは転送されないのでディスクグループが宛先ホストにマウントされるようにします。
- このオプションを指定済と指定した場合、この場所で利用可能なすべてのファイルは、宛先ホストの一時的なステージング領域に転送されます。
- このオプションは、カンマ(,)をデリミタに使用して複数の値を指定できます。
are_backups_on_dest_host

ソース・データベースのバックアップが宛先ホストですでに使用可能であることを示します。このオプションは、clone_typeがEXISTING_BACKUPで、db_backups_locationが指定されている場合に使用できます。
degree_of_parallelism

RMANによってデータベース・ファイルのコピーに使用されるパラレル・チャネルの数。指定した値は、-clone_typeがDUPLICATEの場合にのみ考慮されます。
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は必要に応じて、自動的にデータベースを開始します。
multiplex_locs

REDOログおよび制御ファイルの場所を多重化します。最大5つのコンマ区切りの場所を指定できます。
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>"
```
tde_wallet_location

透過的データ暗号化ウォレットの場所。

Oracle Databaseバージョン18c以上の場合: 指定したパスは、クローン・データベースのSQLNET.ORAネットワーク構成ファイルのWALLET_ROOTパラメータの値として設定されます。ディレクトリ構造は、TDEウォレットを格納するために指定されたパスの下に作成されます。

18cより前のOracle Databaseバージョンの場合: 指定したパスは、クローン・データベースのOracleホームのSQLNET.ENCRYPTION_WALLET_LOCATIONパラメータに設定されます。クローン・データベースのOracleホームから実行されているすべてのデータベースがこの設定を共有するため、各データベースが一意のウォレットで構成されるように、パスで$ORACLE_UNQNAMEを使用することをお薦めします。この値は、データベースの起動時に環境内で自動的に構成されます。

例

例1

次のコマンドは、RMAN複製を使用して、クローン・データベースのOracleホームにある最初の既存のTCPリスナーを使用したデータベースをクローニングします。

emcli clone_database 
	-source_db_name="database" 
	-dest_target_name="dbClone1" 
	-dest_host_name="host1" 
	-dest_oracle_home="/u01/app/oracle/product/12.2.0/dbhome_1" 
	-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で暗号化されたソース・データベースのクローン・データベースを作成します。ソース・データベースとクローン・データベース間の通信は、指定されたトンネル・ポートを使用して確立されます。これにより、4つのパラレルRMANチャネルを使用してデータベース・ファイルがコピーされます。

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="TESTDB2"
	-dest_global_dbname="TESTDB2"
	-dest_listener_selection="GRID_INFRA"
	-clone_type="DUPLICATE"
	-degree_of_parallelism="4"
	-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"

例4

次のコマンドは、RMAN複製を使用して、REDOログ・ファイルと制御ファイルの複数の場所を持つデータベースをクローニングします。

emcli clone_database 
	-source_db_name="database" 
	-dest_target_name="dbClone1"
	-dest_host_name="host1"
	-dest_oracle_home="/u01/app/oracle/product/11.2.0/dbhome_2" 
	-dest_oracle_sid="dbClone1"
	-dest_global_dbname="dbClone1"
	-dest_listener_selection="DEST_DB_HOME"
	-clone_type="DUPLICATE"
	-dest_storage_type="FILE_SYSTEM"
	-multiplex_locs="/u01/app/oracle/oradata/dbClone1/loc1,
			    /u01/app/oracle/oradata/dbClone1/loc2,
			    /u01/app/oracle/fast_recovery_area/dbClone1/loc3,
			    /u01/app/oracle/oradata/dbclone1/loc4,
			    /u01/app/oracle/fast_recovery_area/dbclone1/loc5"