INTO OUTFILE Clause

INTO OUTFILE условие перенаправляет результат запроса SELECT в файл на стороне клиента.

Поддерживаются сжатые файлы. Тип сжатия определяется по расширению имени файла (по умолчанию используется режим 'auto'). Либо его можно явно указать в условии COMPRESSION. Уровень сжатия для определенного типа сжатия можно указать в условии LEVEL.

Синтаксис

file_name и type являются строковыми литералами. Поддерживаемые типы сжатия: 'none', 'gzip', 'deflate', 'br', 'xz', 'zstd', 'lz4', 'bz2'.

level является числовым литералом. Поддерживаются положительные целые числа в следующих диапазонах: 1-12 для типа lz4, 1-22 для типа zstd и 1-9 для других типов сжатия.

Implementation Details

• Эта функциональность доступна в клиенте командной строки и clickhouse-local. Таким образом, запрос, отправленный через HTTP интерфейс, завершится неудачно.
• Запрос завершится ошибкой, если файл с таким же именем уже существует.
• Формат вывода по умолчанию — TabSeparated (как в пакетном режиме клиентa командной строки). Используйте условие FORMAT, чтобы изменить его.
• Если в запросе упоминается AND STDOUT, то вывод, записанный в файл, также отображается на стандартном выходе. Если используется сжатие, текст отображается в открытом виде на стандартном выходе.
• Если в запросе упоминается APPEND, то вывод добавляется в существующий файл. Если используется сжатие, добавление не может быть использовано.
• При записи в файл, который уже существует, необходимо использовать APPEND или TRUNCATE.

Пример

Выполните следующий запрос, используя клиент командной строки:

Результат: