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 を使用する必要があります。

例

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

結果: