mirror of
https://github.com/ClickHouse/ClickHouse.git
synced 2024-11-16 20:53:27 +00:00
45 lines
2.1 KiB
Markdown
45 lines
2.1 KiB
Markdown
---
|
|
slug: /en/sql-reference/statements/select/into-outfile
|
|
sidebar_label: 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. Compression type is detected by the extension of the file name (mode `'auto'` is used by default). Or it can be explicitly specified in a `COMPRESSION` clause. The compression level for a certain compression type can be specified in a `LEVEL` clause.
|
|
|
|
**Syntax**
|
|
|
|
```sql
|
|
SELECT <expr_list> INTO OUTFILE file_name [AND STDOUT] [APPEND | TRUNCATE] [COMPRESSION type [LEVEL level]]
|
|
```
|
|
|
|
`file_name` and `type` are string literals. Supported compression types are: `'none'`, `'gzip'`, `'deflate'`, `'br'`, `'xz'`, `'zstd'`, `'lz4'`, `'bz2'`.
|
|
|
|
`level` is a numeric literal. Positive integers in following ranges are supported: `1-12` for `lz4` type, `1-22` for `zstd` type and `1-9` for other compression types.
|
|
|
|
## Implementation Details
|
|
|
|
- This functionality is available in the [command-line client](../../../interfaces/cli.md) and [clickhouse-local](../../../operations/utilities/clickhouse-local.md). Thus a query sent via [HTTP interface](../../../interfaces/http.md) will fail.
|
|
- The query will fail if a file with the same file name already exists.
|
|
- The default [output format](../../../interfaces/formats.md) is `TabSeparated` (like in the command-line client batch mode). Use [FORMAT](format.md) clause to change it.
|
|
- If `AND STDOUT` is mentioned in the query then the output that is written to the file is also displayed on standard output. If used with compression, the plaintext is displayed on standard output.
|
|
- If `APPEND` is mentioned in the query then the output is appended to an existing file. If compression is used, append cannot be used.
|
|
- When writing to a file that already exists, `APPEND` or `TRUNCATE` must be used.
|
|
|
|
**Example**
|
|
|
|
Execute the following query using [command-line client](../../../interfaces/cli.md):
|
|
|
|
```bash
|
|
clickhouse-client --query="SELECT 1,'ABC' INTO OUTFILE 'select.gz' FORMAT CSV;"
|
|
zcat select.gz
|
|
```
|
|
|
|
Result:
|
|
|
|
```text
|
|
1,"ABC"
|
|
```
|