RECAP

RECAPコマンドは、現行セッション中に以前に入力した文を現行の出力ファイルまたは指定したファイルに送信するコマンドです。この文は、現在のセッション中の最後に入力した最大256の文のリストであるコマンド・ログからコピーされます。

注意:

RECAP文は、コマンド・ログには含まれません。

構文

RECAP [number|ALL] [ 'search-text' ] [ FILE file-name ]

引数

number

送信される文の数を示す正のINTEGER。search-textを指定した場合、search-text文字列が含まれるサブセットからこの数の文が送信されます。search-textを指定しなかった場合、コマンド・ログのうち最近実行された部分からこの数の文が送信されます。デフォルトの数は10です。

ALL

search-textを指定した場合、ALLを指定すると検索要件を満たす文がすべて要求されます。search-textを指定しなかった場合、ALLを指定するとコマンド・ログ内のすべての文が要求されます。

search-text

引用符で囲まれたテキスト・リテラル。この引数を指定すると、search-textが含まれる文がコマンド・ログ内の文の中から検索されます。この検索では大文字と小文字は区別されません。これらの文はサブセットを構成し、そこからRECAPはnumberまたはALLに指定される数の文を送信します。

FILE file-name

RECAP文の出力を指定のファイルに書き込みます。file-nameは出力が書き込まれるファイルの名前を表すテキスト式を指定します。そのファイルがカレント・ディレクトリにない場合、ファイルの名前にディレクトリ・オブジェクトの名前を含める必要があります。

注意:

ディレクトリ・オブジェクトはデータベースで定義され、ディレクトリおよびディレクトリ内のファイルへのアクセスを制御します。CDA文を使用して、カレント・ディレクトリ・オブジェクトを特定および指定できます。使用するデータベース・ユーザー名で読取りおよび書込み可能なファイルがあるディレクトリ・オブジェクトへのアクセス権については、Oracle DBAに問い合せてください。

注意

search-text引数の順序

search-text引数に加えてALL引数またはnumber引数を使用する場合、search-textは2番目に指定する必要があります。

引数を指定しないRECAP

引数のないRECAPを指定した場合、最近の10の文が送信されます。

文の再実行

以前に実行した文をREEDITによって編集するため、または以前に実行した文をREDOによって再実行するため、RECAPの出力を使用できます。

ファイルとディレクトリの指定

OLAP DML文でファイルやディレクトリを指定する場合、必ず一重引用符で囲むことをお薦めします。

例

例10-89 「actual」を含む最新の3つの文の取得

次のRECAP文は、テキスト・リテラル「actual」を含む最新の3つの文を要求します。

RECAP 3 'actual'

この文によって生成される出力は、次のとおりです。

       COMMAND LOG
    3: dsc actual
    5: report total(actual)
    8: report average(actual)