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

migrate_noncdb_to_pdb

非コンテナ・データベース(非CDB)をPDBとして移行します。

書式

 emcli migrate_noncdb_to_pdb 
  -cdbTargetName="EM CDB target into which the database will be added as PDB"
  -cdbTargetType="EM CDB target type (oracle_database|rac_database)"          
  -cdbDBCreds="Named DB credentials of CDB user having sysdba privileges"
  -cdbHostCreds="Named host credentials for Oracle Home owner of CDB"
  -migrationMethod="Migration method to be used (DATAPUMP|PLUG_AS_PDB)"
  -noncdbTargetName="EM non-CDB target to be migrated"
  -noncdbTargetType="EM non-CDB target type (oracle_database|rac_database)"
  -noncdbDBCreds="Named DB credentials for non-CDB user having sysdba privileges"
  -noncdbHostCreds="Named host credentials for Oracle Home owner of non-CDB"
  -pdbName="Name of the PDB to be created on the CDB"	
  -pdbAdminName="Username of the PDB administrator to be created"
  -pdbAdminPassword="Password for the PDB administrator"
  [-exportDir="Temporary file system location on the non-CDB host where the exported files will be stored"]
  [-importDir="Temporary file system location on the CDB host used to stage the migration metadata and/or datafiles"]
  [-useOMF="Use OMF for datafile location if CDB is OMF enabled (Y|N)"]
  [-createAsClone="If -migrationMethod is 'PLUG_AS_PDB' and if 'createAsClone' is 'Y', the PDB will be created as clone. (Y|N)"]
  [-dataFilesLoc="Location on the CDB host where datafiles for the newly created PDB will be stored. Disk Group name in case of ASM"]
  [-encryptionPwd="Password to decrypt/encrypt datapump dump file. Mandatory if non-CDB contains encrypted tablespaces"]
  [-cdbWalletPwd="Wallet password of the CDB. Mandatory if non-CDB contains encrypted tablespaces"]
  [-objectExistsAction="Action to be taken when the exported object with same name is found on the newly created PDB (SKIP|REPLACE). Defaulted to SKIP"]
  [-precheck="Perform pre-requisite checks (YES|NO|ONLY). Defaulted to YES"]
  [-ignoreWarnings="Ignore the warnings from precheck (Y|N)"]
  [-locationSharedAcrossTargets="Export/Import location is shared across Source and Destination targets)"]
									           
[ ]  indicates that the parameter is optional.

オプション

  • cdbTargetName

    移行を行うEnterprise Managerのコンテナ・データベース(CDB)ターゲットの名前。

  • cdbTargetType

    CDBのターゲット・タイプ。単一インスタンス・データベースは"oracle_database"、クラスタ・データベースは"rac_database"です。

  • cdbDBCreds

    SYSDBA権限を持つDBユーザーのCDBでの名前付きデータベース資格証明。

  • cdbHostCreds

    CDBのOracleホーム・インストールを所有しているユーザーの名前付きホスト資格証明。

  • migrationMethod

    データベースをCDBに移行するために使用する方法。有効な値は次のとおりです。

    • DATAPUMP (Oracle Data Pumpの完全トランスポータブル・エクスポートおよびインポート): Data Pumpの完全トランスポータブル・エクスポートおよびインポートを使用して、非CDBからデータをエクスポートし、新規に作成したPDBにインポートします。このオプションは、非CDBのバージョン11.2.0.3以上に対してのみサポートされています。

    • PLUG_AS_PDB (PDBとしてプラグ): DBMS_PDBパッケージを使用してXMLメタデータ・ファイルを生成します。XMLメタデータ・ファイルは、CDBへのプラグに使用される非CDBのデータベース・ファイルを記述します。このオプションを使用するには、非CDBがOracle Database、PDBが12cデータベースである必要があります。

      例: ソース非CDBと接続先PDBバージョン12.1

  • noncdbTargetName

    移行する非CDBのEnterprise Managerターゲット名。

  • noncdbTargetType

    非CDBのターゲット・タイプ。単一インスタンス・データベースは"oracle_database"、クラスタ・データベースは"rac_database"です。

  • noncdbDBCreds

    SYSDBA権限を持つユーザーの非CDBでの名前付きデータベース資格証明。

  • noncdbHostCreds

    非CDBのOracleホーム・インストールを所有しているユーザーの名前付きホスト資格証明。

  • pdbName

    CDBで作成するプラガブル・データベースの名前。

  • pdbAdminName

    新しいPDB用として作成するPDB管理者のユーザー名。

  • pdbAdminPassword

    PDB管理者のパスワード。

  • exportDir

    エクスポートしたデータ・ポンプ・ファイル(ダンプ・ファイルおよびデータ・ファイル)が格納される非CDBホスト上のファイル・システムの場所。このディレクトリは、移行が成功した後にクリーンアップされます。デフォルトのエクスポート・ディレクトリは、非CDB上のDATA_PUMP_DIRディレクトリ・オブジェクトが指し示す場所です。非CDBのOracleホーム所有者が読取り権限と書込み権限を持つ場所を使用してください。

  • importDir

    移行メタデータまたはデータファイルを一時的にステージングするために使用されるCDBホスト上のファイル・システムの場所。このディレクトリは、移行が成功した後にクリーンアップされます。デフォルトのインポート・ディレクトリは、CDB上のDATA_PUMP_DIRディレクトリ・オブジェクトが指し示す場所です。CDBのOracleホーム所有者が読取り権限と書込み権限を持つ場所を使用してください。-locationSharedAcrossTargetsを指定すると、エクスポート・ディレクトリが使用されます。

  • useOMF

    データファイルの場所としてOMFの場所を使用します。

    Y: CDBでOMFが使用される場合のみサポートされます。それ以外の場合は無視されます。

    N (デフォルト)

  • createAsClone

    このフラグは、新規プラガブル・データベースをクローンとして作成するかどうかを指定します。-migrationMethodがPLUG_AS_PDBとして指定されている場合にのみ使用され、それ以外の場合は無視されます。有効な値はYまたはN (デフォルト)です。

  • dataFilesLoc

    新しく作成したPDBのデータファイルが格納されるCDBホスト上のファイル・システムの場所。CDBにASMが使用されている場合、データファイルの場所としてディスク・グループ名を使用することもできます。デフォルトのデータファイルの場所は、CDB上のDATA_FILE_DIRディレクトリ・オブジェクトが指し示す場所です。CDBのOracleホーム所有者が読取り権限と書込み権限を持つ場所を使用してください。useOMFがYの場合は無視されます。

  • encryptionPwd

    データ・ポンプのダンプ・ファイルを復号化/暗号化するためのパスワード。非CDBに暗号化された表領域が含まれる場合は必須です。

  • cdbWalletPwd

    CDB上のウォレットをオープンするためのウォレット・パスワード。非CDBに暗号化された表領域が含まれる場合は必須です。

  • objectExistsAction

    新しく作成されたPDBに同じ名前を持つエクスポートされたオブジェクトが見つかった場合に実行するアクション。

    • SKIP: デフォルト値

    • REPLACE

  • precheck

    移行ジョブの際に前提条件チェックを実行するオプション。

    • YES (デフォルト): 前提条件チェックを実行し、前提条件チェック中にエラーが発生しない場合は、データベースの移行に進みます。

    • NO: データベースの移行に直接進みます。前提条件チェックは実行しません。

    • ONLY: 前提条件チェックのみを実行します。データベースは移行しません。

  • ignoreWarnings

    前提条件チェック中の警告(存在する場合)を無視して移行を進めるオプション。事前チェックがYESに設定されている場合のみ使用され、それ以外の場合は無視されます。有効な値は次のとおりです。

    • YES (デフォルト): 警告を無視して移行を続行します。

    • NO: 警告が見つかった場合。移行を続行しません。

  • locationSharedAcrossTargets

    このパラメータは、エクスポートの場所がソース・ターゲットと宛先ターゲットで共有されることを指定します。つまり、インポートの場所とエクスポートの場所が同じであるため、ファイル転送が省略されます。

例

例1

次の例では、非CDBターゲットNON_CDB_1をNEW_PDBという名前のPDBとして移行します。この場合、移行方法はdatapump、非CDBターゲットの資格証明はNON_CDB_DB_CREDS、非CDBホストの資格証明はNON_CDB_HOST_CREDSを使用し、新しく作成したPDBの管理者のユーザー名はpdbAdmin、管理者パスワードはwelcomeとして指定します。

emcli migrate_noncdb_to_pdb 
  -migrationMethod=datapump
  -noncdbTargetName=NON_CDB_NAME 
  -noncdbTargetType=oracle_database
  -noncdbHostCreds=NON_CDB_HOST_CREDS 
  -noncdbDBCreds=NON_CDB_DB_CREDS 
  -cdbTargetName=CDB_NAME
  -cdbTargetType=oracle_database 
  -cdbHostCreds=CDB_HOST_CREDS 
  -cdbDBCreds=CDB_DB_CREDS 
  -pdbName=NEW_PDB 
  -pdbAdminName=pdbAdmin 
  -pdbAdminPassword=welcome 
  -precheck=ONLY 
  -ignoreWarnings