ClickHouse/docs/en/sql-reference/statements/select/into-outfile.md

toc_title
INTO OUTFILE

INTO OUTFILE Clause

INTO OUTFILE clause redirects the result of a SELECT query to a file on the client side.

Compressed files are supported. File compression is detected by the extension of the file name. Or it can be explicitly specified in a COMPRESSION clause.

Syntax

SELECT <expr_list> INTO OUTFILE file_name [COMPRESSION type]

file_name and type are string literals. Supported compression types are: 'gzip', 'deflate', 'br', 'xz', 'zstd', 'lz4', 'bz2'.

Implementation Details

• This functionality is available in the command-line client and clickhouse-local. Thus a query sent via HTTP interface will fail.
• The query will fail if a file with the same file name already exists.
• The default output format is TabSeparated (like in the command-line client batch mode). Use FORMAT clause to change it.

Example

Execute the following query in the command-line client:

clickhouse-client --query="SELECT 1,'ABC' INTO OUTFILE 'select.gz' FORMAT CSV;"
zcat select.gz 

Result:

1,"ABC"