CAPTURE

CQLクエリー結果をファイルに追加書き込みします。

CQLクエリー出力を捕捉し、指定したファイルに出力を追加します。エラー・メッセージおよびcqlshコマンドは、標準端末出力に表示されます。他のすべてのcqlsh出力がファイルに追加されます。現在の捕捉ステータスを表示するには、オプションなしで「CAPTURE」と入力します。

構文

CAPTURE [ 'file_name' | OFF ]

表 1. 凡例
構文規則	説明
大文字	リテラル・キーワード。
小文字	リテラル以外。
`イタリック体`	変数値。ユーザー定義値と置き換えます。
`[]`	任意。角かっこ（ `[]` ）で任意指定のコマンド引数を囲みます。角かっこは入力しないでください。
`( )`	グループ。丸かっこ（`( )`）は、選択肢を含むグループを示します。丸かっこは入力しないでください。
`\|`	または。縦棒（ `\|` ）で代替要素を区切ります。要素のいずれかを入力してください。縦棒は入力しないでください。
`...`	繰り返し可能。省略記号（`...`）は、構文要素を必要な回数だけ繰り返すことができることを示します。
`'Literal string'`	単一引用符（ `'` ）でCQL文内のリテラル文字を囲みます。大文字を維持するには、単一引用符を使用します。
`{ key : value }`	マップ・コレクション。中かっこ（ `{ }` ）でマップ・コレクションまたはキーと値のペアを囲みます。コロンでキーと値を区切ります。
`<datatype1,datatype2>`	セット、リスト、マップ、またはタプル。山かっこ（`< >`）で、セット、リスト、マップまたはタプル内のデータ型を囲みます。データ型はコンマで区切ります。
`cql_statement;`	CQL文の終了。セミコロン（ `;` ）ですべてのCQL文を終了します。
`[--]`	コマンドライン・オプションとコマンド引数は、2つのハイフン（`--`）。この構文は、引数がコマンドライン・オプションと間違われる可能性がある場合に役立ちます。
`' <schema> ... </schema> '`	検索CQLのみ：単一引用符（ `'` ）でXMLスキーマ宣言全体を囲みます。
`@xml_entity='xml_entity_type'`	検索CQLのみ：スキーマ・ファイルおよびsolrConfigファイル内のXML要素を上書きするための実体とリテラル値を示します。

file_name: クエリー出力を書き込むファイル。捕捉開始後の最初のクエリーを実行する際にファイルが存在しない場合は、ファイルが作成されます。現在の作業ディレクトリーからの相対パスを使用するか、ホーム・ディレクトリーを示すチルダ（~）を指定します。絶対パスはサポートされていません。
OFF: 捕捉を停止します。

例

結果をwinnersテキスト・ファイルに捕捉します。

CAPTURE '~/results/winners.txt'

注: 結果ディレクトリーはホーム・ディレクトリーに存在していなければなりません。winnersテキスト・ファイルが存在しない場合は作成されます。

Now capturing query output to '/Users/local_system_user/results/winners.txt'.

すべてのサイクリング・レースの受賞者を選択するクエリーを実行します。

SELECT *
FROM cycling.race_winners;

結果は捕捉ファイルの末尾に追加されます。結果は端末に表示されません。