1. コマンドライン・インタフェース
  2. Verbリファレンス
  3. EM CLI Verb
  4. create_pluggable_database

create_pluggable_database

プラガブル・データベースを作成します。

書式

emcli create_pluggable_database
		 -cdbTargetName="Specify the CDB target name for creating new PDB"
		 -cdbTargetType="Specify the CDB target type - oracle_database, rac_database"
		 -cdbHostCreds="Specify the host credentials on which the CDB target is located. (owner:name)"
		 [-cdbTargetCreds="Specify the credentials of container database on which the new PDB will be created. (owner:name)"]
		 -pdbName="Specify a name for the new PDB"
		 -sourceType="Type of pdb to be created - DEFAULT, UNPLUGGED_PDB, CLONE, PROFILE"
		 [-sourcefromSWLIB="If -sourceType is 'UNPLUGGED_PDB', specify if the dump location is SWLIB or not."]
		 [-pdbTemplateInSWLIB="If -sourceFromSWLIB, specify the URN of pdb template component in SWLIB."]
		 [-sourcePDBTempStagingLocation="Specify fully qualified location for staging temporary files. If not specified it will be defaulted to to "C:\Temp" in case of Windows and "\tmp" otherwise."]
		 [-unpluggedPDBType="If -sourceType is 'UNPLUGGED_PDB', specify pdb dump type - ARCHIVE, RMAN, XML."]
		 [-sourcePDBArchiveLocation="If -unpluggedPDBType=ARCHIVE, this is fully qualified archive location"]
		 [-sourcePDBMetadataFile="If -unpluggedPDBType=RMAN or XML, this is fully qualified path of the source PDB metadata file"]
		 [-sourcePDBDataBackup="If -unpluggedPDBType=RMAN, this is fully qualified path of the source PDB datafile"]
		 [-moveDatafiles="If -unpluggedPDBType=XML, this will move the source PDB datafiles to the destination"]
		 [-excludeStandbys="If -unpluggedPDBType=XML and if 'moveDatafiles' is specified, this will exclude the new PDB from standby CDBs"]
		 [-sourcePDBName="If -sourceType is 'CLONE', specify the name of an existing PDB which is a valid em target"]
		 [-sourceCDBCreds="If -sourceType is 'CLONE', specify the credentials of container database on which the -sourcePDBName is present. (owner:name)"]
		 [-pdbAdminCreds="Name of pdb credentials with admin role. (owner:name)"]
		 [-useOMF="Specifies that the datafiles can be stored in OMF location"]
		 [-sameAsSource="Specifies that the datafiles of new PDB can be stored in the same location as that of source CDB"]
		 [-newPDBFileLocation="Specify the storage location for datafiles of the created PDB."]
		 [-createAsClone="If -sourceType is 'UNPLUGGED_PDB' and if 'createAsClone' is specified, the PDB will be created as clone."]
		 [-lockAllUsers="If -sourceType is 'UNPLUGGED_PDB' and if 'lockAllUsers' is specified, all PDB users of the new PDB will be locked."]
		 [-noUserTablespace="Specifies that the new DEFAULT PDB will not be created with USERS tablespace."]
		 [-useSnapClone="If -sourceType is 'CLONE', specify if Snap Clone should be used for cloning"]
		 [-sourceCDBHostCreds="If -sourceType is 'CLONE' and -useSnapClone is specified, this is the host credentials for the source container database. (owner:name)"]
		 [-mountPointPrefix="If -sourceType is 'CLONE' and -useSnapClone is specified, this is the mount point prefix for the clone volumes"]
		 [-writableSpace="If -sourceType is 'CLONE' and -useSnapClone is specified, this is the writable space in GB for the clone volumes"]
		 [-saveProfile="If -sourceType is 'CLONE' and -useSnapClone is specified, -saveProfile allows the created snapshot to be saved as profile"]
		 [-profileName="If -saveProfile is specified, -profileName is required"]
		 [-profileLocation="If -saveProfile is specified, -profileLocation is required"]
		 [-profileURN="If -sourceType is 'PROFILE', -profileURN is required"]
		 [-privHostCreds="If -sourceType is 'CLONE' and -useSnapClone is specified, this is the privileged host credentials to mount the volumes at the specified locations. (owner:name)"]

[ ]  indicates that the parameter is optional

オプション

  • cdbTargetName

    プラガブル・データベースが作成されるターゲット・コンテナ・データベース。これはEnterprise Manager上の有効なターゲットである必要があります。

  • cdbTargetType

    ターゲット・コンテナ・データベースのタイプ。

  • cdbHostCreds

    ターゲット・コンテナ・データベースがあるホストの資格証明。これはEnterprise Managerに保存された資格証明の名前です。現在のユーザー以外のユーザーが所有する資格証明を指定するには、owner:nameという書式を使用します。

  • cdbTargetCreds

    新しいPDBが作成されるコンテナ・データベースの資格証明。これはEnterprise Managerに格納された資格証明の名前です。

  • pdbName

    作成されるプラガブル・データベース名。これは複数のプラガブル・データベースを作成する場合には接頭辞として機能し、シーケンス番号が後ろに付いてpdb名<pdbname>#が生成されます

  • numOfPdbs

    作成されるプラガブル・データベースの合計数。所定のコンテナ・データベースで許可される新しいプラガブル・データベースの最大数は252です。値を指定しない場合はデフォルト値の1になります。

  • sourceType

    作成されるプラガブル・データベースのタイプ。有効な値は次のとおりです。

    • DEFAULT: シード・プラガブル・データベースからプラガブル・データベースを作成します

    • UNPLUGGED_PDB: 切断されたデータベースの既存のダンプ(アーカイブ、RMANファイル・セットまたはXML)から、プラガブル・データベースを作成します

    • CLONE: 既存のプラガブル・データベースからプラガブル・データベースを作成します

    • PROFILE: 既存のPDBプロファイルからプラガブル・データベースを作成します

  • sourceFromSWLIB

    -sourceTypeに'UNPLUGGED_PDB'が指定され、ダンプがソフトウェア・ライブラリにある場合、このフラグを設定する必要があります。

  • pdbTemplateInSWLIB

    -sourceFromSWLIBの場合、ソフトウェア・ライブラリのpdbテンプレートの有効なURNを指定します。

  • sourcePDBTempStagingLocation

    一時ファイルをステージングするために完全修飾された場所を指定します。指定されない場合、デフォルトの場所はWindowsであれば"C:\Temp"、それ以外は"\tmp"です。ファイルは操作の後で削除されます。

  • unpluggedPDBType

    -sourceTypeをUNPLUGGED_PDBに指定し、ダンプがファイル・システムからである場合、これは、使用するダンプのタイプを指定します。有効な値は次のとおりです。

    • ARCHIVE: プラガブル・データベースを既存のPDBアーカイブから作成します

    • RMAN: プラガブル・データベースを既存のPDB RMANファイル・セットから作成します

    • XML: プラガブル・データベースをメタデータ・ファイルから作成します

  • sourcePDBArchiveLocation

    -unpluggedPDBTypeにARCHIVEが指定される場合、これはPDBアーカイブの完全修飾された場所です。

  • sourcePDBMetadataFile

    -unpluggedPDBTypeにRMANまたはXMLが指定される場合、これはメタデータ・ファイルの完全修飾された場所です。

  • sourcePDBDataBackup

    -unpluggedPDBTypeにRMANが指定される場合、これはデータファイル・バックアップの完全修飾された場所です。

  • moveDatafiles

    このパラメータが適用されるのは、パラメータ-unpluggedPDBTypeにXMLが指定される場合のみです。このオプションは、ソース・プラガブル・データベースのデータファイルを宛先のデータファイルの場所に移動するように指定します。

  • excludeStandbys

    このパラメータが適用されるのは、パラメータ-unpluggedPDBTypeにXMLが指定され、'moveDatafiles'が指示される場合のみです。このオプションは、新しいプラガブル・データベースをすべてのスタンバイ・コンテナ・データベースから除外します(STANDBYS=NONE)。

  • sourcePDBName

    -sourceTypeにCLONEが指定される場合、これには、新しいプラガブル・データベースのクローニング元のプラガブル・データベースの名前を指定します。これはEnterprise Managerの有効なターゲットである必要があります。

  • sourceCDBCreds

    -sourceTypeにCLONEが指定される場合、-sourcePDBNameが存在するコンテナ・データベースの資格証明を指定します。これはEnterprise Managerに格納された資格証明の名前です。

  • useOMF

    新しいプラガブル・データベースのデータファイルの宛先は、OMFの場所になります。これはソースCDBがOMFである場合のみ有効です。

  • sameAsSource

    新しいプラガブル・データベースのデータファイルの宛先は、CDBと同じになります。複数のPDBを作成する場合、このオプションは無効です。

  • newPDBFileLocation

    新しいプラガブル・データベースのデータファイルの宛先。

  • pdbAdminCreds

    新しいプラガブル・データベースの管理資格証明。新しいプラガブル・データベースのソースがDEFAULTの場合、これは必須パラメータです。他のオプションの場合は、オプションです。

  • createAsClone

    -sourcePDBTypeが'UNPLUGGED_PDB'に指定され、複数のプラガブル・データベースの作成時にデフォルトで使用される場合、このフラグは、新しいプラガブル・データベースをクローンとして作成するかどうかを指定します。

  • lockAllUsers

    このフラグは、-sourcePDBTypeが'UNPLUGGED_PDB'の場合にすべてのユーザーがロックされるかどうかを指定します。

  • noUserTablespace

    このフラグは、新規DEFAULT PDBをUSER表領域なしで作成するかどうかを指定します。これは、-sourceTypeがDEFAULTの場合のみ適用されます。

  • useSnapClone

    このフラグは、スナップ・クローンがPDBのクローニングに使用できるかどうかを指定します。これは-sourceTypeがCLONEの場合にのみ適用されます。

  • sourceCDBHostCreds

    これはソース・コンテナ・データベースのストレージ情報を取得するためのホスト資格証明です。これは-sourceTypeがCLONEで-useSnapCloneが指定されている場合にのみ適用されます。

  • mountPointPrefix

    これはクローン・ボリュームのマウント・ポイント接頭辞です。これは-sourceTypeがCLONEで-useSnapCloneが指定されている場合にのみ適用されます。

  • writableSpace

    これはクローン・ボリュームの書込み可能領域(GB単位)です。これは-sourceTypeがCLONEで-useSnapCloneが指定されている場合にのみ適用されます。

  • saveProfile

    これにより、ソースPDBに作成されたスナップショットをプロファイルとして保存できます。これは-sourceTypeがCLONEで-useSnapCloneが指定されている場合にのみ適用されます。

  • profileName

    作成するプロファイルの名前を指定します。これは-saveProfileが指定される場合のみ適用されます。

  • profileLocation

    これにより、作成したプロファイルを保存するソフトウェア・ライブラリの場所を指定します。これは-saveProfileが指定される場合のみ適用されます。

  • profileURN

    これにより、PDBの作成元のプロファイルのURNを指定します。これは、-sourceTypeがPROFILEの場合のみ適用されます。

  • privHostCreds

    これは指定した場所でボリュームをマウントするための特権ホスト資格証明です。これは-sourceTypeがCLONEで-useSnapCloneが指定されている場合にのみ適用されます。

例

例1

emcli create_pluggable_database 
		 -cdbTargetName=database 
		 -cdbTargetType=oracle_database 
		 -pdbName=pdb -sourceType=UNPLUGGED_PDB 
		 -unpluggedPDBType=ARCHIVE
		 -sourcePDBArchiveLocation=/u01/app/oracle/product/12.1.0/dbhome_2/assistants/dbca/templates/a.tar.gz 
		 -cdbHostCreds=HOST_CREDS 
		 -cdbTargetCreds=DBSNMP 
		 -newPDBFileLocation=/u01/app/oradata/pdb 
		 -pdbAdminCreds=pdb_creds 
		 -lockAllUsers

例2

emcli create_pluggable_database 
		 -cdbTargetName=database 
		 -cdbTargetType=oracle_database 
		 -pdbName=pdb -numOfPdbs=1 
		 -sourceType=CLONE 
		 -cdbHostCreds=SYSMAN:HOST_CREDS 
		 -cdbTargetCreds=SYSMAN:DBSNMP 
		 -sourcePDBName=source_pdb 
		 -sourceCDBCreds=CDB_SYS_CREDS 
		 -useSnapClone  
		 -srcCDBHostCreds=SYS 
		 -mountPointPrefix=/mount/point/prefix -writableSpace=1 
		 -sourcePDBTempStagingLocation=/tmp 
		 -privHostCreds=HOST_SUDO 
		 -saveProfile -profileName=PROFILENAME 
		 -profileLocation=MyProfiles

例3

emcli create_pluggable_database 
		 -cdbTargetName=database 
		 -cdbTargetType=oracle_database 
		 -pdbName=pdb -numOfPdbs=1 
		 -sourceType=PROFILE 
		 -cdbHostCreds=HOST_CREDS 
		 -cdbTargetCreds=DBSNMP 
		 -mountPointPrefix=/mount/point/prefix
		 -writableSpace=1 
		 -sourcePDBTempStagingLocation=/tmp 
		 -privHostCreds=HOST_SUDO -profileURN=oracle:defaultService:em:provisioning:1:PROFILE:URN:RANDOM:0.1

例4

emcli create_pluggable_database 
		 -cdbTargetName=database 
		 -cdbTargetType=oracle_database 
		 -pdbName=pdb -numOfPdbs=2 
		 -sourceType=UNPLUGGED_PDB -unpluggedPDBType=RMAN 
		 -sourcePDBMetadataFile=/u01/app/oracle/product/12.1.0/dbhome_2/assistants/dbca/templates/a.xml 
		 -sourcePDBDataBackup=/u01/app/oracle/product/12.1.0/dbhome_2/assistants/dbca/templates/a.dfb 
		 -cdbHostCreds=HOST_CREDS 
		 -cdbTargetCreds=DBSNMP 
		 -newPDBFileLocation=/u01/app/oradata/pdb 
		 -pdbAdminCreds=pdb_creds 
		 -createAsClone

例5

emcli create_pluggable_database 
		 -cdbTargetName=database 
		 -cdbTargetType=oracle_database 
		 -cdbHostCreds=HOST_CREDS 
		 -cdbTargetCreds=CDB_SYS_CREDS 
		 -pdbName=pdb 
		 -sourceType=CLONE 
		 -sourcePDBName=source_pdb
		 -sourceCDBCreds=CDB_SYS_CREDS 
		 -useSnapClone -srcCDBHostCreds=HOST_CREDS 
		 -mountPointPrefix=/oracle -writableSpace=1 
		 -sourcePDBTempStagingLocation=/tmp 
		 -privHostCreds=ROOT_CREDS