4.10 foreignFileSpec

目的

foreignFileSpec副次句を使用すると、クロス・プラットフォームのリストア操作を実行するために必要な情報を指定できます。この情報には、クロス・プラットフォーム・バックアップを含むバックアップ・セットの名前と、リストアする必要があるオブジェクトまたはファイルの詳細を含めます。

使用上のノート

クロス・プラットフォーム・リストア操作を実行するには、foreignFileSpecを指定する必要があります。ソース・プラットフォームと宛先プラットフォームで、使用するエンディアン形式が異なる場合でも、表領域をリストアすることができます。

構文

foreignFileSpec::=

図foreignfilespec.epsの説明

(xfileList::=, xforeigndfList::=, handleNameList::=)

xfileList::=

図xfilelist.epsの説明

xforeigndfList::=

図xforeigndflist.epsの説明

handleNameList::=

図handlenamelist.epsの説明

セマンティクス

xfilelist::=

構文要素	説明
ALL FOREIGN DATAFILES	クロス・プラットフォーム・バックアップ・セットに含まれるすべてのデータファイルがリストアされる必要があることを指定します。リストアされるデータファイルを含むバックアップ・セットの名前を指定するには、ALL FOREIGN DATAFILESとともにFROM BACKUPSETを使用します。
FORMAT formatSpec	宛先データベースにリストアされるデータファイルのパターンを指定します。
TO NEW	データファイルが、Oracle Managed File (OMF)名を使用してDB_CREATE_FILE_DEST初期化パラメータで指定された場所にリストアされる必要があることを指定します。
DUMP FILE 'filename'	Data Pumpエクスポートのダンプ・ファイルを含むバックアップ・セットをリストアするように指定します。ダンプ・ファイルを含むバックアップ・セットの名前は、FROM BACKUPSET句を使用して指定します。ダンプ・ファイルには、プラットフォーム間でトランスポートされる表領域のメタデータが含まれます。このメタデータは、リストアされた表領域を宛先データベースに組み込むために必要です。 filenameは、エクスポート・ダンプ・ファイルがリストアされるファイルの名前です。
DATAPUMP DESTINATION 'datapump_destination'	エクスポート・ダンプ・ファイルをリストアする必要がある場所を指定します。この句を省略すると、エクスポート・ダンプ・ファイルは、オペレーティング・システムに応じたデフォルトの場所にリストアされます。 この句を使用すると、データベースを読取り/書込みモードで開く必要があり、そうでない場合はエラーが発生します。
NOIMPORT	エクスポート・ダンプ・ファイルをリストアする必要はあるが、宛先データベースにインポートする必要はないことを指定します。 エクスポート・ダンプ・ファイルはインポートされないため、表領域は宛先データベースに組み込まれません。表領域に組み込むには、データ・ポンプ・インポートを使用して、宛先データベースに手動でダンプ・ファイルをインポートする必要があります。
EXCLUDE	データ・ポンプ・エクスポート操作から統計を除外します。 大量のメモリー需要が発生しないように、エクスポート・ダンプ・ファイルで統計データを除外することを選択できます。次のキーワードのいずれかまたはすべてを使用して、EXCLUDEの基準を指定します: STATISTICS TABLE STATISTICS INDEX STATISTICS
XMLFILE filename	PDBがソースPDBから切断された後に作成される切断XMLファイルの名前を指定します。 Oracle Database 23c以降では、PDBの通常のRMANバックアップを使用して、PDBをソース・データベースから宛先データベースにトランスポートできます。 PDBのバックアップおよび以前のリリースのOracle Databaseで作成された切断XMLファイルを使用してPDBをトランスポートする場合は、宛先データベースで最終的なリストア操作を実行するときにXMLFILE句を含める必要があります。 PDBバックアップを使用したPDBのトランスポートの詳細は、バックアップおよびリカバリ・ユーザーズ・ガイドを参照してください。
XMLFILE DESTINATION	宛先データベースでPDB切断XMLファイルを抽出して格納するディレクトリを指定します。
FOREIGN DATABASE	CDB全体をクロス・プラットフォーム・バックアップ・セットからリストアする必要があることを指定します。クロス・プラットフォーム・データベース・バックアップを含むバックアップ・セットを指定するには、FROM BACKUPSETを使用します。 FOREIGN DATABASEが使用されている場合、CDBはマウントされていない必要があり、そうでない場合はエラーが発生します。
FOREIGN PLUGGABLE DATABASE pdb_name	pdb_nameによって指定されるプラガブル・データベース(PDB)が、クロスプラットフォーム・バックアップ・セットからリストアする必要があることを指定します。クロス・プラットフォームPDBバックアップを含むバックアップ・セットを指定するには、FROM BACKUPSETを使用します。 CDBをマウントしないでください(マウントすると、エラーが発生します)。
FOREIGN TABLESPACE tablespace_name	クロス・プラットフォーム・バックアップ・セットからリストアする必要がある表領域を指定します。表領域の名前は、ソース・データベースの元の表領域名である必要があります。クロス・プラットフォーム・バックアップを含むバックアップ・セットの名前を指定するには、FROM BACKUPSETを使用します。

xforeigndfList::=

構文要素	説明
FOREIGN DATAFILE integer	クロス・プラットフォーム・バックアップに含まれる、指定されたデータファイルをリストアします。クロス・プラットフォーム・バックアップ・セットに含まれるデータファイルのうち、一部のみをリストアすることができます。クロス・プラットフォーム・バックアップを含むバックアップ・セットの名前を指定するには、FROM BACKUPSETを使用します。 integerは、ソース・データベースのデータファイルの絶対数を指定します。
FORMAT formatSpec	宛先データベースにリストアされるデータファイルのパターンを指定します。
TO NEW	データファイルが、Oracle Managed File (OMF)名を使用してDB_CREATE_FILE_DEST初期化パラメータで指定された場所にリストアされる必要があることを指定します。
FOREIGN PLUGGABLE DATABASE pdb_name	PDBバックアップを使用して、pdb_nameで指定されたプラガブル・データベース(PDB)を宛先データベースにトランスポートする必要があることを指定します。 通常のPDBバックアップを使用して、PDBをソースCDBから宛先CDBにトランスポートできます。 宛先データベースでリストア操作を実行する場合は、RESTOREコマンドをFOREIGN PLUGGABLE DATABASE句とともに使用して、RMANがpdb_nameで指定されたPDBのバックアップからデータファイルをリストアする必要があることを指定します。 FROM TRANSPORTLISTまたはFROM TRANSPORTFILE句を使用して、RMANでリストア操作に使用する必要があるPDBバックアップを指定します。 PDBのバックアップを使用したPDBのトランスポートの詳細は、バックアップおよびリカバリ・ユーザーズ・ガイドを参照してください。
FOREIGN TABLESPACE tablespace_name	表領域バックアップを使用して宛先データベースにトランスポートする必要がある、tablespace_nameで指定された表領域を指定します。 通常の表領域バックアップを使用して、ソース・データベースから宛先データベースに表領域をトランスポートできます。 宛先データベースでリストア操作を実行する場合は、RESTOREコマンドをFOREIGN TABLESPACEコマンドとともに使用して、RMANがtablespace_nameで指定された表領域のバックアップからデータファイルをリストアする必要があることを指定します。 FROM TRANSPORTLISTまたはFROM TRANSPORTFILE句を使用して、RMANでリストア操作に使用する必要がある表領域バックアップを指定します。 表領域バックアップを使用した表領域のトランスポートの詳細は、バックアップおよびリカバリ・ユーザーズ・ガイドを参照してください。
FORMAT formatSpec	宛先データベースにリストアされるデータファイルのパターンを指定します。
TO NEW	データファイルが、Oracle Managed File (OMF)名を使用してDB_CREATE_FILE_DEST初期化パラメータで指定された場所にリストアされる必要があることを指定します

handleNameList::=

構文要素	説明
BACKUPSET filename	リストアする必要があるクロス・プラットフォーム・バックアップが含まれるバックアップ・セットを指定します。 ほとんどのバックアップ・セットには、バックアップ・ピースが1つのみ含まれます。ただし、各バックアップ・ピースの最大サイズを指定するようにMAXPIECESIZEを構成することによって、複数のバックアップ・ピースによるバックアップを作成できます。1つのバックアップ・セットに複数のバックアップ・ピースが含まれる場合、FROM BACKUPSET句には、そのバックアップ・セットのすべてのバックアップ・ピースのカンマ区切りリストを指定する必要があります。バックアップ・ピースの順序は、最初のピースから最後のピースである必要があります。このとおりの順序でないと、リストア操作が失敗します。複数のバックアップ・ピースが含まれるRESTOREコマンドについては、例3-37を参照してください。 クロス・プラットフォーム・バックアップが複数のバックアップ・セットで構成される場合、そのクロス・プラットフォーム・バックアップの一環として作成されたバックアップ・セットごとに、別々のBACKUPSET句を使用する必要があります。複数のバックアップ・セットが含まれるRESTOREコマンドについては、例3-36を参照してください。
TRANSPORTLIST	RMANがトランスポート・リストを使用して、宛先データベースでのリストア操作に必要な正確なバックアップを識別する必要があることを指定します。 トランスポート・リストを生成するには、宛先データベースでRESTORE PREVIEW TO TRANSPORTLISTコマンドを事前に実行しておく必要があります。 Oracle Database 23c以降では、定期的RMANバックアップを使用して、ソース・プラットフォームから宛先プラットフォームに表領域およびプラガブル・データベース(PDB)をトランスポートできます。宛先データベースでは、RMANはソース・データベースで作成されたバックアップからデータファイルをリストアし、宛先データベースの表領域またはPDBに接続してデータ・トランスポート・プロセスを完了します。 ソース・データベースと宛先データベースが同じリカバリ・カタログに接続されている場合、RMANはリカバリ・カタログ・メタデータを問い合せて、宛先データベースでリストア操作を実行するために必要な正確なバックアップを決定します。RMANにより、バックアップのメモリー内リストであるトランスポート・リストが生成されます。リストア操作中に、RMANはトランスポート・リストを使用してバックアップからデータファイルをリストアします。 宛先データベースで、RMANをソース・データベースと同じリカバリ・カタログに接続します。次に、SETコマンドをFOREIGN DBID句とともに使用して、ソースPDBのDBIDを設定します。RESTOREコマンドをPREVIEW句およびTO TRANSPORTLIST句とともに使用して、トランスポート・リストを生成します。 その後、RESTOREコマンドをFOREIGN PLUGGABLE DATABASEまたはFOREIGN TABLESPACE句およびFROM TRANSPORTLIST句とともに実行して、RMANがトランスポート・ファイルを使用してデータファイルをリストアする必要があることを指定できます。 通常のバックアップおよびリカバリ・カタログ接続を使用したPDBおよび表領域のトランスポートの詳細は、バックアップおよびリカバリ・ユーザーズ・ガイドを参照してください。
TRANSPORTFILE	宛先データベースにトランスポートするPDBまたは表領域のバックアップに関するメタデータを含むXMLファイルまたはトランスポート・ファイルを指定します。 ソース・データベースでトランスポート・ファイルを事前に作成しておく必要があります。トランスポート・ファイルは、宛先データベースにアクセスできる場所に格納する必要があります。 Oracle Database 23c以降では、定期的RMANバックアップを使用して、ソース・プラットフォームから宛先プラットフォームに表領域およびプラガブル・データベース(PDB)をトランスポートできます。宛先データベースでは、RMANはソース・データベースで作成されたバックアップからデータファイルをリストアし、宛先データベースの表領域またはPDBに接続してデータ・トランスポート・プロセスを完了します。 リカバリ・カタログを使用しない場合、トランスポート・ファイルはバックアップ・メタデータをXML形式で格納するために使用されます。RMANでは、バックアップからデータファイルをリストアし、リストアした表領域またはPDBを宛先データベースに接続するために、トランスポート・ファイルを必要とします。トランスポート・ファイルは、filenameを使用して指定します。 ソース・データベースで、RESTORE PREVIEWコマンドをTO TRANSPORTFILE句とともに使用してトランスポートXMLファイルを作成します。 次に、RESTOREコマンドをFOREIGN PLUGGABLE DATABASEまたはFOREIGN TABLESPACE句およびFROM TRANSPORTFILE句とともに実行します。FROM TRANSPORTFILE句で、ソース・ホストで作成されたトランスポート・ファイルを指定します。 通常のバックアップを使用してPDBおよび表領域をトランスポートする方法の詳細は、バックアップおよびリカバリ・ユーザーズ・ガイドを参照してください。

例

例4-23 クロス・プラットフォーム・バックアップからのすべてのデータファイルのリストア

次の例で、バックアップ・セットOelmdipc_1_1は、クロス・プラットフォームの表領域トランスポートのためにソース・データベースで作成されました。このクロス・プラットフォーム・バックアップに含まれるすべてのデータファイルを宛先データベースにリストアするには、RESTOREコマンドでforeignFileSpecを使用します。宛先データベースは、読取り/書込みモードで開いておく必要があります。

RESTORE
    ALL FOREIGN DATAFILES TO NEW
    FROM BACKUPSET '/net/oracle/restores/Oelmdipc_1_1';

関連項目:

クロス・プラットフォーム・バックアップのリストアに関するその他の例は、「RESTORE」を参照してください