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

Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

42 lines
2.5 KiB
Markdown
Raw Normal View History

---
2022-08-26 17:37:11 +00:00
slug: /ru/sql-reference/statements/select/into-outfile
sidebar_label: INTO OUTFILE
---
# Секция INTO OUTFILE {#into-outfile-clause}
2021-11-28 19:18:06 +00:00
Секция `INTO OUTFILE` перенаправляет результат запроса `SELECT` в файл на стороне **клиента**.
2022-07-07 08:31:55 +00:00
Поддерживаются сжатые файлы. Формат сжатия определяется по расширению файла (по умолчанию используется режим `'auto'`), либо он может быть задан явно в секции `COMPRESSION`. Уровень сжатия для конкретного алгоритма может быть задан в секции `LEVEL`.
2021-11-28 19:18:06 +00:00
**Синтаксис**
```sql
2022-07-07 01:59:00 +00:00
SELECT <expr_list> INTO OUTFILE file_name [COMPRESSION type [LEVEL level]]
2021-11-28 19:18:06 +00:00
```
2021-11-30 08:36:03 +00:00
`file_name` и `type` задаются в виде строковых литералов. Поддерживаются форматы сжатия: `'none`', `'gzip'`, `'deflate'`, `'br'`, `'xz'`, `'zstd'`, `'lz4'`, `'bz2'`.
2022-07-07 01:59:00 +00:00
`level` задается в виде числового литерала. Поддерживаются положительные значения в следующих диапазонах: `1-12` для формата `lz4`, `1-22` для формата `zstd` и `1-9` для остальных форматов.
## Детали реализации {#implementation-details}
- Эта функция доступна только в следующих интерфейсах: [клиент командной строки](../../../interfaces/cli.md) и [clickhouse-local](../../../operations/utilities/clickhouse-local.md). Таким образом, запрос, отправленный через [HTTP интерфейс](../../../interfaces/http.md) вернет ошибку.
- Запрос завершится ошибкой, если файл с тем же именем уже существует.
2021-11-28 19:18:06 +00:00
- По умолчанию используется [выходной формат](../../../interfaces/formats.md) `TabSeparated` (как в пакетном режиме клиента командной строки). Его можно изменить в секции [FORMAT](format.md).
**Пример**
2021-11-30 08:36:03 +00:00
Выполните следующий запрос, используя [клиент командной строки](../../../interfaces/cli.md):
2021-11-28 19:18:06 +00:00
```bash
clickhouse-client --query="SELECT 1,'ABC' INTO OUTFILE 'select.gz' FORMAT CSV;"
zcat select.gz
```
Результат:
```text
1,"ABC"
```