INTO OUTFILE 句

INTO OUTFILE 句は、SELECT クエリの結果を クライアント 側のファイルにリダイレクトします。

圧縮ファイルがサポートされています。圧縮の種類はファイル名の拡張子によって検出されます（デフォルトではモード 'auto' が使用されます）。また、COMPRESSION 句で明示的に指定することもできます。特定の圧縮タイプの圧縮レベルは LEVEL 句で指定できます。

構文

file_name および type は文字列リテラルです。サポートされている圧縮タイプは次のとおりです: 'none'、'gzip'、'deflate'、'br'、'xz'、'zstd'、'lz4'、'bz2'。

level は数値リテラルです。次の範囲の正の整数がサポートされています: lz4 タイプ用は 1-12、zstd タイプ用は 1-22、その他の圧縮タイプ用は 1-9。

実装の詳細

• この機能は、コマンドラインクライアント および clickhouse-local で利用可能です。そのため、HTTP インターフェース を介して送信されたクエリは失敗します。
• 同じファイル名のファイルがすでに存在する場合、クエリは失敗します。
• デフォルトの 出力形式 は TabSeparated です（コマンドラインクライアントのバッチモードと同様）。これを変更するには FORMAT 句を使用してください。
• クエリに AND STDOUT が含まれている場合、ファイルに書き込まれた出力は標準出力にも表示されます。圧縮が使用される場合、プレーンテキストが標準出力に表示されます。
• クエリに APPEND が含まれている場合、出力は既存のファイルに追加されます。圧縮が使用されている場合、追加は使用できません。
• 既存のファイルに書き込む場合は、APPEND または TRUNCATE を使用する必要があります。

例

次のクエリを コマンドラインクライアント を使用して実行します:

結果: