1 Recovery Managerコマンドの概要

この章の内容は、次のとおりです。

• Recovery Managerコマンド・エントリの構造

• Recovery Managerの構文図

• Recovery Managerコマンドの形式

• Recovery Managerの予約語

• Recovery Managerコマンドの概要

• Recovery Manager副次句の概要

Recovery Managerコマンド・エントリの構造

第2章「Recovery Managerコマンド」では、すべてのRecovery Managerコマンドを、次の項目構成で説明しています。

用途

コマンドの簡単な説明と、コマンドが使用される最も一般的な状況を示します。

前提条件

コマンドを使用するための前提条件を示します。

使用上の注意

コマンドを使用するための一般的な注意事項を示します（この項はオプションです）。コマンド・オプションに固有の注意事項は、そのオプションの説明に含まれています。

構文

文を構成するキーワードとパラメータを構文図で示します。

注意: キーワードとパラメータは、常に有効とは限りません。構文の制約については、必ず各文および各句の「セマンティクス」の項を参照してください。

セマンティクス

構文を構成するキーワード、パラメータおよび句の用途を説明し、該当する制約事項と使用上の注意を示します。この章で使用されているキーワードおよびパラメータに関する表記規則は、「表記規則」で説明します。

例

文の各句と各パラメータの使用例を示します。

例の次の項では、文の使用方法と使用時期を説明します（この項はオプションです）。

Recovery Managerの構文図

このマニュアルでは、Recovery Managerのコマンドライン構成の構文記述に図形式またはバッカス正規形（BNF）を使用しています。構文図およびBNF記法についての基本的な情報は、『Oracle Database SQL言語リファレンス』を参照してください。この項では、Recovery Managerの表記規則についてのみ説明します。

次のCATALOGコマンドの例で示すように、Recovery Managerの構文図は、線と矢印で構文の構造を表します。

catalog::=

画像の説明

この項では、構文図の構成要素を説明し、Recovery Managerコマンドの書式の例を示します。構文図の構成要素は、次のとおりです。

• Recovery Manager構文内のキーワード

• Recovery Manager構文内のプレースホルダ

• Recovery Manager構文内の引用符

Recovery Manager構文内のキーワード

キーワードは、Recovery Managerの構文で特殊な意味を持ちます。キーワードは、構文図では、図の例にあるワードCATALOGのように長方形で囲まれた大文字で表されます。本文とコード例で使用されている場合、Recovery Managerキーワードは CATALOG DATAFILECOPYのように固定幅フォントの大文字で表されます。Recovery Manager文でのキーワードは、構文図に示すとおりに使用する必要があります。ただし、大文字と小文字は区別しません。

Recovery Manager構文内のプレースホルダ

構文図でのプレースホルダは、キーワード以外を示します。構文図では、図の例にあるワードintegerのように楕円で囲まれて表されます。説明文の中では、Recovery Managerのプレースホルダは小文字のイタリック体で表されます。たとえば、'filename'となります。通常、プレースホルダは次の内容を示します。

• データベース・オブジェクト名（tablespace_name）

• Oracleデータ型名（date_string）

• 副次句（datafileSpec）

構文図にプレースホルダがあるときは、Recovery Manager文中では、適切な型のオブジェクトまたは式に置き換えます。たとえば、DUPLICATE TARGET DATABASE TO 'database_name'コマンドを記述する場合は、構文図のdatabase_nameプレースホルダを、dupdbなどの作成する複製データベースの名前に置き換えて使用します。

Recovery Managerの引用符付き文字列の場合、システムに依存しない有効な環境変数は、Oracleホームに使用する疑問符（?）とSIDに使用するアットマーク（@）のみです。ただし、ターゲット・システム上では、引用符付き文字列にオペレーティング・システム固有の環境変数を使用できます。環境変数は、Recovery Managerクライアントではなくデータベース・サーバーによって解析されます。

次の表に、構文図に表されるプレースホルダと、構文中でそれに代入する値の例を示します。

プレースホルダ	説明	例
'filename'、'tablespace_name'、'channel_name'、'channel_parms'など、引用符付き文字列。	一重引用符または二重引用符で囲まれた文字列。引用符で囲んだ文字列には、空白文字、句読点、Recovery ManagerキーワードおよびSQLキーワードも含まれています。	"?/dbs/cf.f" 'dev1'
channel_id、tag_name、date_stringなど、引用符なしの文字列。	アルファベット文字で開始し、空白および句読点のない文字列。	ch1
integer	数値のみを含む文字列。	67843

Recovery Manager構文内の引用符

Recovery Manager構文図で示すプレースホルダの値には、引用符で囲むことが必要なものと任意のものがあります。構文図では一重引用符を使用していますが、Recovery Manager構文では、二重引用符も使用できます。たとえば、'filename'も"filename"も指定できます。SQLコマンドの場合は、SQL文自体に引用符が含まれる場合があり、SQL文で最も一般的な引用符が一重引用符であるため、二重引用符を使用することをお薦めします。SQLでは、Recovery Managerの場合と異なり、一重引用符と二重引用符が別の意味を持ちます。

Recovery Managerコマンドの形式

Recovery Managerの言語は自由区分形式です。複数のキーワードは、少なくとも1つの空白文字（空白、タブ、改行など）で区切る必要があります。Recovery Managerコマンドは、構文図で示すように、第2章「Recovery Managerコマンド」で説明するコマンドのいずれかに対応するキーワードで始まり、引数がその後に続き、セミコロンで終了します。次の例は、Recovery Managerのバックアップ・コマンドを示しています。

BACKUP DATABASE;

コマンドは、複数行になることがあります。たとえば、前述のコマンドの各キーワードを次のように別々の行に書き直すことができます。

BACKUP
  DATABASE
;

コメントは行の任意の場所で番号記号（#）文字を使用して挿入することができます。#文字に後続する行の部分は無視されます。次に例を示します。

# run this command once each day
BACKUP INCREMENTAL LEVEL 1 
  FOR RECOVER OF COPY      # using incrementally updated backups
  WITH TAG "DAILY_BACKUP"  # daily backup routine
  DATABASE;

Recovery Managerの予約語

Recovery Manager言語にはいくつかの予約語があり、Recovery Managerコマンドで使用されていたか、現在も使用されているものがあります。表1-1に、現在予約されているすべての予約語を示します。

表1-1    Recovery Managerの予約語 

A-C	C-D	D-L	L-P	P-S	S-W
,	CHANGE	DURATION	LOGSEQ	PARALLELMEDIARESTORE	SECTION
#	CHANNEL	ECHO	LOGS	PARALLEL	SEND
(	CHECKSYNTAX	ENCRYPTION	LOG	PARAMETER	SEQUENCE
)	CHECK	EXCLUDE	LOGSCN	PARAMETER_VALUE_CONVERT	SETLIMIT
\	CLEAR	EXECUTE	LOW	PARMS	SETSIZE
{	CLONENAME	EXIT	MAINTENANCE	PARTIAL	SET
}	CLONE	EXPIRED	MASK	PASSWORD	SHIPPED
<<<	CLONE_CF	EXPORT	MAXCORRUPT	PFILE	SHOW
>>>	CLOSED	FAILOVER	MAXDAYS	PIPE	SHUTDOWN
;	CMDFILE	FAILURE	MAXOPENFILES	PLATFORM	SINCE
&	COMMAND	FILESPERSET	MAXPIECESIZE	PLSQL	SIZE
_	COMMENT	FILES	MAXSEQ	PLUS	SKIP
'	COMPATIBLE	FILES	MAXSETSIZE	POINT	SLAXDEBUG
=	COMPLETED	FINAL	MAXSIZE	POLICY	SNAPSHOT
^	COMPRESSED	FLASHBACK	METHOD	POOL	SPFILE
@	COMPRESSION	FORCE	MINIMIZE	PREVIEW	SPOOL
.	CONFIGURE	FOREIGN	MISC	PRIMARY	SQL
:	CONNECT	FOREVER	MOUNT	PRINT	STANDBY
ABORT	CONSISTENT	FORMAT	MSGLOG	PRIORITY	STARTUP
ACCESSIBLE	CONTROLFILECOPY	FOR	MSGNO	PRIVILEGES	START
ACTIVE	CONTROLFILE	FROM	M	PROXY	STEP
ADVISEID	CONVERT	FULL	NAMES	PUT	SUMMARY
ADVISE	COPIES	GET	NAME	QUIT	SWITCH
AES128	COPY	GLOBAL	NEED	RATE	TABLESPACES
AES192	CORRUPTION	HIGH	NEW-LINE	RCVCAT	TABLESPACE
AES256	CREATE	GRANT	NEWNAME	RCVMAN	TAG
AFFINITY	CRITICAL	GROUP	NEW	READONLY	TARGET
AFTER	CROSSCHECK	GUARANTEE	NOCATALOG	READRATE	TDES168
ALGORITHM	CUMULATIVE	G	NOCFAU	RECALL	TEMPFILE
ALLOCATE	CURRENT	HEADER	NOCHECKSUM	RECOVERABLE	TEST
ALLOW	DATABASE	HIGH	NODEVALS	RECOVERY	THREAD
ALL	DATAFILECOPY	HOST	NODUPLICATES	RECOVER	TIMEOUT
ALTER	DATAFILE	IDENTIFIED	NOEXCLUDE	REDUNDANCY	TIMES
AND	DATAPUMP	IDENTIFIER	NOFILENAMECHECK	REGISTER	TIME
APPEND	DAYS	ID	NOFILEUPDATE	RELEASE	TO
APPLIED	DBA	IMMEDIATE	NOKEEP	RELOAD	TRACE
ARCHIVELOG	DBID	IMPORT	NOLOGS	REMOVE	TRANSACTIONAL
AREA	DB_FILE_NAME_CONVERT	INACCESSIBLE	NOMOUNT	RENORMALIZE	TRANSPORT
AS	DB_NAME	INCARNATION	NONE	REPAIRID	TYPE
AT	DB_RECOVERY_FILE_DEST	INCLUDE	NOPARALLEL	REPAIR	UNAVAILABLE
ATALL	DB_UNIQUE_NAME	INCLUDING	NOPROMPT	REPLACE	UNCATALOG
AUTOBACKUP	DEBUG	INCREMENTAL	NOREDO	REPLICATE	UNDO
AUTOLOCATE	DECRYPTION	INPUT	NORMAL	REPORT	UNLIMITED
AUXILIARY	DEFAULT	INSTANCE	NOT	RESETLOGS	UNRECOVERABLE
AUXNAME	DEFINE	IO	NO	RESET	UNREGISTER
AVAILABLE	DELETE	JOB	NULL	RESTART	UNTIL
BACKED	DELETION	KBYTES	OBSOLETE	RESTORE	UPGRADE
BACKUPPIECE	DESTINATION	KEEP	OFFLINE	RESTRICTED	UP
BACKUPSET	DETAIL	KRB	OFF	RESYNC	USING
BACKUPS	DEVICE	K	OF	RETENTION	VALIDATE
BACKUP	DIRECTORY	LEVEL	ONLY	REUSE	VERBOSE
BEFORE	DISKRATIO	LIBPARM	ON	REVOKE	VIRTUAL
BETWEEN	DISK	LIBRARY	OPEN	RPCTEST	WINDOW
BLOCKRECOVER	DISPLAY	LIKE	OPTIMIZATION	RPC	WITH
BLOCKS	DORECOVER	LIMIT	OPTION	RUN
BLOCK	DROP	LIST	ORPHAN	SAVE
BY	DUMP	LOAD	OR	SCHEMA
CANCEL	DUPLEX	LOGFILE	PACKAGES	SCN
CATALOG	DUPLICATE	LOGICAL	PARALLELISM	SCRIPT

予約語のいずれかをRecovery Managerコマンドの引数として使用する必要がある場合（たとえば、ファイル名、表領域名、タグ名など）は、予約語を一重引用符または二重引用符で囲んでください。そうしないと、Recovery Managerでコマンドが正しく解析されず、エラーが発生します。例1-1に、Recovery ManagerコマンドでRecovery Manager予約語を適切に使用している例と適切でない使用例を示します。

例1-1    予約語をRecovery Managerコマンドの引数に使用する例

ALLOCATE CHANNEL backup DEVICE TYPE DISK;         # incorrect
ALLOCATE CHANNEL "backup" DEVICE TYPE DISK;       # correct
BACKUP DATABASE TAG full;                         # incorrect
BACKUP DATABASE TAG 'full';                       # correct

通常、Recovery Managerコマンド言語の本来の意味と矛盾する方法で予約語を使用しないようにしてください。

Recovery Managerコマンドの概要

表1-2に、Recovery ManagerプロンプトまたはRUNコマンド、あるいはその両方で実行できるRecovery Managerコマンドの機能の概要を示します。使用できなくなっているコマンドとオプションもありますが、旧リリースのRecovery Managerのすべてのコマンドが、現行のリリースで動作します（付録A「使用不可になったRecovery Managerコマンド」を参照）。Recovery Managerクライアントのコマンドライン・オプションについては、「RMAN」を参照してください。

表1-2    Recovery Managerコマンド 

コマンド	用途
@	コマンド・ファイルを実行します。
@@	現在実行中のコマンド・ファイルと同じディレクトリにあるコマンド・ファイルを実行します。@@コマンドが@コマンドと異なるのは、コマンド・ファイル内から実行される場合のみです。
ADVISE FAILURE	修復オプションを表示します。
ALLOCATE CHANNEL	チャネルを確立します。これは、Recovery Managerとデータベース・インスタンス間の接続です。
ALLOCATE CHANNEL FOR MAINTENANCE	DELETEコマンドなどのメンテナンス・コマンドの発行に備えてチャネルを割り当てます。
ALTER DATABASE	データベースをマウントまたはオープンします。
BACKUP	データベース・ファイル、データベース・ファイルのコピー、アーカイブ・ログまたはバックアップ・セットをバックアップします。
CATALOG	ファイル・コピーおよびユーザー管理バックアップに関する情報をレポジトリに追加します。
CHANGE	バックアップ・ピース、イメージ・コピーまたはアーカイブREDOログをステータスUNAVAILABLEまたはAVAILABLEを持つものとしてマークします。バックアップまたはコピーのリポジトリ・レコードを削除します。バックアップまたはコピーの保存方針をオーバーライドします。DB_UNIQUE_NAMEを使用してターゲット・データベースのリカバリ・カタログを更新します。
CONFIGURE	永続的なRecovery Manager設定を構成します。この設定は、明示的に変更または使用不可にするまで、すべてのRecovery Managerセッションに適用されます。
CONNECT	Recovery Managerとターゲット・データベース、補助データベースまたはリカバリ・カタログ・データベースとの接続を確立します。
CONVERT	プラットフォーム間で表領域とデータベースをトランスポートするために、データファイルの形式を変換します。
CREATE CATALOG	リカバリ・カタログのためのスキーマを作成します。
CREATE SCRIPT	ストアド・スクリプトを作成してリカバリ・カタログに格納します。
CROSSCHECK	アーカイブ・ログ、データファイルのコピーおよびバックアップ・ピースなど、Recovery Managerで管理されるファイルが、ディスクまたはテープに引き続き存在するかどうかを判断します。
DELETE	バックアップとコピーを削除し、その参照をリカバリ・カタログから削除し、その制御ファイル・レコードをステータスDELETEDに更新します。
DELETE SCRIPT	ストアド・スクリプトをリカバリ・カタログから削除します。
DROP CATALOG	リカバリ・カタログからスキーマを削除します。
DROP DATABASE	ディスクからターゲット・データベースを削除して登録を解除します。
DUPLICATE	ターゲット・データベースのバックアップを使用して、テストに使用できる複製データベースを作成するか、スタンバイ・データベースを作成します。
EXECUTE SCRIPT	Recovery Managerストアド・スクリプトを実行します。
EXIT	Recovery Manager実行可能ファイルを終了します。
FLASHBACK DATABASE	データベースを過去のある時点またはSCNでの状態に戻します。
GRANT	リカバリ・カタログのユーザーに権限を付与します。
HOST	Recovery Managerからオペレーティング・システムのコマンドライン・サブシェルをコールするか、特定のオペレーティング・システム・コマンドを実行します。
IMPORT CATALOG	あるリカバリ・カタログから別のリカバリ・カタログに、メタデータをインポートします。
LIST	バックアップ・セットまたはコピーの詳細リストを生成します。
PRINT SCRIPT	ストアド・スクリプトを表示します。
QUIT	Recovery Manager実行可能ファイルを終了します。
RECOVER	バックアップまたはデータファイルのコピーからリストアされたデータファイルまたはデータ・ブロックにREDOログおよび増分バックアップを適用して、その内容を特定の時点の状態に更新します。
REGISTER DATABASE	ターゲット・データベースをリカバリ・カタログに登録します。
RELEASE CHANNEL	ALLOCATE CHANNELコマンドまたはALLOCATE CHANNEL FOR MAINTENANCEコマンドで割り当てたチャネルを解放します。
REPAIR FAILURE	自動診断リポジトリに記録された1つ以上の障害を修復します。
REPLACE SCRIPT	リカバリ・カタログに格納されている既存のスクリプトを置換します。既存のスクリプトがない場合は、REPLACE SCRIPTによりスクリプトが作成されます。
REPORT	リカバリ・カタログの内容の詳細分析を行います。
RESET DATABASE	SQL文ALTER DATABASE OPEN RESETLOGSが実行され、ターゲット・データベースの新規インカネーションが作成されたことをRecovery Managerに通知するか、またはターゲット・データベースを以前のインカネーションに再設定します。
RESTORE	バックアップ・セットまたはディスク・コピーから、デフォルト位置または新規の位置にファイルをリストアします。
RESYNC CATALOG	完全再同期化を実行します。これにより、スナップショット制御ファイルが作成され、そのファイルから新規または変更後の情報がリカバリ・カタログにコピーされます。
REVOKE	リカバリ・カタログ・ユーザーから権限を取り消します。
RMAN	オペレーティング・システムのコマンドラインからRecovery Managerを起動します。
RUN	1つ以上の一連のRecovery Managerコマンドを実行します。これは、RUNの中カッコ内で実行される1つ以上の文です。
SEND	ベンダー固有の引用符付き文字列を1つ以上の特定チャネルに送信します。
SET	RUNブロックまたはセッションの実行時にRecovery Managerの動作に影響する様々な属性の値を設定します。
SHOW	現行のCONFIGURE設定を表示します。
SHUTDOWN	ターゲット・データベースを停止します。このコマンドは、SQL*PlusのSHUTDOWNコマンドと同じです。
SPOOL	Recovery Manager出力をログ・ファイルに書き込みます。
SQL	Recovery Manager内からSQL文を実行します。
STARTUP	ターゲット・データベースを起動します。このコマンドは、SQL*PlusのSTARTUPコマンドと同じです。
SWITCH	データファイルのコピーが現行のデータファイルであることを指定します。つまり、制御ファイルが指すデータファイルです。このコマンドは、データファイルに適用されるSQL文ALTER DATABASE RENAME FILEと同じです。
TRANSPORT TABLESPACE	1つ以上の表領域のバックアップからトランスポータブル表領域のセットを作成します。
UNREGISTER	リカバリ・カタログからデータベースを登録解除します。
UPGRADE CATALOG	リカバリ・カタログ・スキーマを、旧バージョンからRecovery Manager実行可能ファイルに必要なバージョンにアップグレードします。
VALIDATE	バックアップ・セットを調べて、データの損傷がないかどうかをレポートします。Recovery Managerは、指定したバックアップ・セットのバックアップ・ピースをすべてスキャンし、チェックサムを参照して、内容が正しくリストアされるかどうかを検証します。

Recovery Manager副次句の概要

複数のコマンドで使用される副次句は、不要な重複を避けるために章を分けて説明しています。副次句を使用するコマンドの説明には、第3章「Recovery Manager副次句」の副次句の項目への相互参照が含まれています。表1-3に、Recovery Managerの副次句をまとめています。

表1-3    Recovery Managerの副次句 

副次句	指定内容. . .
allocOperandList	PARMS、FORMATなどのチャネル制御オプション。
archivelogRecordSpecifier	アーカイブREDOログ・ファイルの範囲。
completedTimeSpec	バックアップまたはコピーが完了した時刻の範囲。
connectStringSpec	ターゲット・データベース、リカバリ・カタログ・データベースまたは補助データベースに接続するための、ユーザー名、パスワードおよびネット・サービス名。この接続は、ユーザーの認証とデータベースの識別のために必要です。
datafileSpec	データファイル（ファイル名または絶対ファイル番号で指定）。
deviceSpecifier	バックアップまたはコピーに使用するストレージ・デバイスのタイプ。
fileNameConversionSpec	BACKUP AS COPY、CONVERTおよびDUPLICATEの実行時に、ソース・ファイル名からターゲット・ファイル名への変換に使用するパターン。
forDbUniqueNameOption	Data Guard環境のすべてのデータベース、または固有のDB_UNIQUE_NAMEを持つデータベース。
foreignlogRecordSpecifier	外部アーカイブREDOログ・ファイルの範囲。
formatSpec	バックアップまたはコピーに使用するファイル名の形式。
keepOption	バックアップまたはコピーを現行の保存方針から除外するかどうか。
listObjList	LISTコマンドで表示する項目。
maintQualifier	DELETEやCHANGEなどのメンテナンス・コマンドの追加オプション。
maintSpec	CHANGE、CROSSCHECKおよびDELETEなどのメンテナンス・コマンドで操作されるファイル。
obsOperandList	指定条件に従って不要となるバックアップ。
recordSpec	メンテナンス・コマンドで操作されるオブジェクト。
untilClause	上限（時刻、SCNまたはログ順序番号で指定）。通常、この句は不完全リカバリに必要な時点を指定するために使用します。