CATALOG

用途

CATALOGコマンドは、次の目的に使用します。

ディスク上のバックアップ・ピースおよびイメージ・コピーをRMANリポジトリに追加します。
データファイルのコピーをレベル0の増分バックアップとしてRMANリポジトリに記録し、このコピーを増分バックアップ計画の一部分として使用します。

関連項目:

カタログに格納されているターゲット・データベース・レコードを管理する方法は、『Oracle Databaseバックアップおよびリカバリ・ユーザーズ・ガイド』を参照してください

前提条件

ターゲット・データベースに接続していて、そのデータベースがマウントまたはオープン状態である必要があります。RMANがリカバリ・カタログに接続されている場合は、カタログ・データベースをオープンする必要があります。

カタログ化するファイルは、次の条件を満たしている必要があります。

SBTのデバイスに存在していないこと。
ファイルがユーザー管理コピーの場合は、データファイルのコピー、制御ファイルのコピー、アーカイブREDOログまたはバックアップ・ピースであること。

使用上の注意

RMANでは、すべてのユーザー管理バックアップがイメージ・コピーとみなされます。カタログ化中は、ファイルがオペレーティング・システム・ユーティリティにより正常にコピーされたかどうかがRMANではチェックされず、ヘッダーのみがチェックされます。

Data Guard環境でRMANを使用する場合は、リカバリ・カタログが必要です。リカバリ・カタログは、DBIDが同じ(ただし、DB_UNIQUE_NAME値は異なる)すべてのプライマリ・データベースおよびスタンバイ・データベースに対して、統一されたファイルの名前空間をサポートしています。したがって、リカバリ・カタログでは、すべてのプライマリ・データベースまたはスタンバイ・データベースのデータベース・ファイル名に加え、オンラインREDOログ、スタンバイREDOログ、一時ファイル、アーカイブREDOログ・ファイル、バックアップ・セットおよびイメージ・コピーが作成された場所も追跡されます。

異なるプライマリ・データベースおよびスタンバイ・データベースで作成されたバックアップがRMANでどのように処理されるかについては、「Data Guard環境でのRMANのバックアップ」を参照してください。通常、1つのデータベースで作成されたテープ・バックアップはその環境のすべてのデータベースにアクセス可能ですが、ディスク・バックアップは作成元であるデータベースにのみアクセス可能です。

接続されているターゲット・データベースにバックアップからアクセス可能であればRESTOREおよびRECOVERなどのRMANコマンドは、異なるデータベース間で透過的に動作します。ディスク・バックアップを環境内のホスト間で手動で転送して、そのバックアップをカタログ化することができます。バックアップが共有ディスク上に作成されている場合は、CHANGE RESET DB_UNIQUE_NAMEを使用すると、バックアップを新しいデータベースに関連付けることができます。

構文

catalog::=

GUID-2FA8469C-45C6-4F3B-8181-799283B690ED-print.epsの説明が続きます

図GUID-2FA8469C-45C6-4F3B-8181-799283B690ED-print.epsの説明

セマンティクス

構文要素	説明
`ARCHIVELOG` `'filename'`	RMANリポジトリに追加するアーカイブREDOログのファイル名を指定します。注意: このコマンドは、外部アーカイブREDOログ・ファイルをカタログ化しません。外部アーカイブREDOログ・ファイルは、LogMinerセッション中にロジカル・スタンバイ・データベースで受け取ったREDOログです。通常のアーカイブREDOログ・ファイルとは異なり、外部アーカイブREDOログ・ファイルには別のDBIDが使用されています。
`BACKUPPIECE` `'filename'`	RMANリポジトリに追加するバックアップ・ピースの名前を指定します(例2-39を参照)。バックアップ・ピースがディスクに存在している必要があります。RMANは、バックアップ・ピースのヘッダーを検証した後でカタログ化します。RMANは、以前のデータベース・インカネーションからのバックアップ・ピースをカタログ化できます。バックアップ・ピースは、次のような状況の場合にカタログ化します。オペレーティング・システムのユーティリティでコピーまたは移動したパックアップ・ピースを、RMANで使用できるようにする場合。バックアップ・ピースのRMANメタデータは削除されていても、バックアップ・ピースがまだ存在している場合。このような状況は、一時的に使用できなかったバックアップ・ピースに対して`DELETE`コマンドを実行すると発生します。 Data Guard環境のデータベース・ホストで`NOCATALOG`バックアップを作成し、そのバックアップ・ピースを別のデータベース・ホストの同じ場所に移動した場合。このような場合のリカバリ・カタログには、元のバックアップ・ピースのレコードは存在しません。リカバリ・カタログを使用していないときに制御ファイルの再作成が必要になり、その結果、すべてのRMANリポジトリ・データが消失する場合。バックアップをカタログ化すると、再度使用可能になります。制御ファイルの自動バックアップが無効になっているときに、制御ファイルをバックアップしてからアーカイブREDOログ・ファイルをバックアップした場合。制御ファイルのリストアとマウントは実行できますが、制御ファイルの後でバックアップされたアーカイブREDOログ・ファイルを含むバックアップ・ピースをカタログ化する必要があります。バックアップ・ピースのリストを指定すると、一部のバックアップ・ピースの処理で障害が発生した場合でも、RMANによって、すべてのピースのカタログ化が試行されます。バックアップ・ピースをカタログ化すると、`V$BACKUP_PIECE`に新しい行が作成されます。バックアップ・セットは、すべてのバックアップ・ピースがカタログ化された場合にのみ使用可能です。一部でもカタログ化が完了していない場合は、部分的に使用可能な状態であるにすぎません。注意: データベースの`COMPATIBLE`パラメータが11.0.0以上に設定されている場合、RMANでサーバー・パラメータ・ファイルのバックアップを作成すると、バックアップはこのデータベースに関連付けられます。この場合、RMANを別のデータベースに接続して、バックアップ・ピースを明示的にカタログ化しても、このバックアップに関連付けられている`DB_UNIQUE_NAME`は変更されません。たとえば、RMANでは、`COMPATIBLE`が11.0.0の場合に`DB_UNIQUE_NAME 'NEWYORK'`でデータベースのサーバー・パラメータ・ファイルのバックアップを作成すると、データベース`NEWYORK`で作成されたサーバー・パラメータ・ファイルのバックアップを使用して、データベース`BOSTON`のサーバー・パラメータ・ファイルをリストアすることはできません。
`CONTROLFILECOPY` `'filename'`	RMANリポジトリに追加する制御ファイルのコピーのファイル名を指定します。指定できる制御ファイル・コピーは、次のいずれかのコマンドで作成される、通常の制御ファイルまたはスタンバイ制御ファイルのコピーです。 RMAN: `BACKUP` `AS COPY CURRENT CONTROLFILE` SQL: `ALTER DATABASE BACKUP CONTROLFILE` SQL: `ALTER DATABASE CREATE STANDBY CONTROLFILE` 注意: RMANでは、プライマリ・データベースの制御ファイルのバックアップは、リストア操作時に自動的にスタンバイ制御ファイルに変換されます。
`DATAFILECOPY` `'filename'`	RMANリポジトリに追加するデータファイルのコピーのファイル名を指定します(例2-39を参照)。データファイルのコピーを作成するには、RMANの`BACKUP` `AS COPY`コマンドを使用する方法、またはオペレーティング・システムのユーティリティと`ALTER TABLESPACE BEGIN/END BACKUP`を併用する方法があります。
`LEVEL` `integer`	データファイル・コピーをレベル0の増分バックアップとして記録します(`LEVEL`の値として有効なのは`0`のみです)。このデータファイルのコピーを基本レベル0のバックアップとして使用して、増分バックアップを実行できます。
`TAG` `tagname`	データファイル・コピーのタグを指定します。
`RECOVERY AREA`	高速リカバリ領域内のすべての有効なバックアップ・セット、データファイルのコピーおよびアーカイブREDOログ・ファイルをカタログ化します(例2-41を参照)。 RMANは、`TARGET`としてデータベースに接続されている必要があります。ターゲット・データベースはマウントまたはオープン状態である必要があります。キーワード`RECOVERY AREA`と`DB_RECOVERY_FILE_DEST`は完全に同一のシノニムです。注意: 高速リカバリ領域に外部アーカイブREDOログ・ファイル(LogMinerセッション中にロジカル・スタンバイ・データベースで受け取るアーカイブREDOログ・ファイル)が存在する場合、このコマンドではそれらの外部アーカイブREDOログ・ファイルもカタログ化されます。
`DB_RECOVERY_FILE_DEST`	キーワード`RECOVERY AREA`と`DB_RECOVERY_FILE_DEST`は完全に同一のシノニムです。
`START WITH` `'string_pattern'`	名前が`string_pattern`で始まる有効なバックアップ・セット、データファイルと制御ファイルのコピー、およびアーカイブREDOログ・ファイルをすべてカタログ化します。文字列パターンには、ASMディスク・グループ、Oracle Managed Filesディレクトリまたはファイル名の一部分を指定できます(例2-40を参照)。 RMANでは、ディスクの場所にカタログ化できないファイルがある場合は、すべてレポートされます。RMANは、マウント済のターゲット・データベースに接続している必要があります。文字列パターンでファイル名を指定する場合、ファイル名のパターンの左側に一致します。たとえば、`/tmp/arc`は、ディレクトリ`/tmp/arc_dest`および`/tmp/archive/january`内のすべてのファイルと、ファイル`/tmp/arc.cpy`に一致します。注意: 文字列パターンにワイルド・カード文字は使用できません。正確な接頭辞のみを使用してください。
`NOPROMPT`	確認のプロンプトを抑止します。RMANでは、デフォルトで、一致するたびにプロンプトが表示されます。

例

例2-39 増分バックアップとしてのデータファイル・コピーのカタログ化

Linuxユーティリティを使用して、users01.dbfデータファイルを/disk2/backup/users01.bakにバックアップするとします。この例では、データファイル・コピーをレベル0の増分バックアップとしてカタログ化してから、すべてのコピーをリストします。

CATALOG DATAFILECOPY '/disk2/backup/users01.bak' LEVEL 0;
LIST COPY;

例2-40 ディレクトリ内の複数のコピーのカタログ化

この例では、オペレーティング・システムのユーティリティを使用して/disk2/archlogディレクトリにコピーされたアーカイブREDOログ・ファイルで一杯のディレクトリをカタログ化します。この例では、出力例も示します。

CATALOG START WITH '/disk2/archlog' NOPROMPT; 

searching for all files that match the pattern /disk2/archlog
 
List of Files Unknown to the Database
=====================================
File Name: /disk2/archlog/o1_mf_1_10_24trtc7s_.arc
File Name: /disk2/archlog/o1_mf_1_11_24trtg7s_.arc
File Name: /disk2/archlog/o1_mf_1_12_24trtk84_.arc
File Name: /disk2/archlog/o1_mf_1_13_24trtn85_.arc
File Name: /disk2/archlog/o1_mf_1_14_24trtq84_.arc
File Name: /disk2/archlog/o1_mf_1_15_24trtt84_.arc
File Name: /disk2/archlog/o1_mf_1_16_24trtx84_.arc
File Name: /disk2/archlog/o1_mf_1_17_24trv085_.arc
File Name: /disk2/archlog/o1_mf_1_18_24trv385_.arc
File Name: /disk2/archlog/o1_mf_1_19_24trv685_.arc
cataloging files...
cataloging done
 
List of Cataloged Files
=======================
File Name: /disk2/archlog/o1_mf_1_10_24trtc7s_.arc
File Name: /disk2/archlog/o1_mf_1_11_24trtg7s_.arc
File Name: /disk2/archlog/o1_mf_1_12_24trtk84_.arc
File Name: /disk2/archlog/o1_mf_1_13_24trtn85_.arc
File Name: /disk2/archlog/o1_mf_1_14_24trtq84_.arc
File Name: /disk2/archlog/o1_mf_1_15_24trtt84_.arc
File Name: /disk2/archlog/o1_mf_1_16_24trtx84_.arc
File Name: /disk2/archlog/o1_mf_1_17_24trv085_.arc
File Name: /disk2/archlog/o1_mf_1_18_24trv385_.arc
File Name: /disk2/archlog/o1_mf_1_19_24trv685_.arc

例2-41 高速リカバリ領域内のファイルのカタログ化

この例では、現在有効になっている高速リカバリ領域内のすべてのファイルを、ファイルごとにユーザーにプロンプトを表示せずにカタログ化します。出力例に示すとおり、RMANでは、タログ化するファイルが見つからない場合はメッセージが表示されます。

CATALOG RECOVERY AREA;
 
searching for all files in the recovery area
no files found to be unknown to the database

例2-42 バックアップ・ピースのカタログ化

オペレーティング・システムのユーティリティを使用して、ある場所のバックアップ・ピースを別の場所にコピーするとします。この例では、新しい場所のバックアップ・ピースがカタログ化されます(例には出力例も含まれます)。

CATALOG BACKUPPIECE '/disk1/c-874220581-20131128-01';

using target database control file instead of recovery catalog
cataloged backup piece
backup piece handle=/disk1/c-874220581-20131128-01 RECID=12 STAMP=607695990