Skip to main content
Эти настройки сгенерированы автоматически из исходного кода.

output_format_always_write_decimal_point_in_float_and_decimal

Всегда выводить десятичную точку для чисел с плавающей запятой и чисел типа Decimal в текстовых форматах, даже если значение является целым числом. Например, выводить 1. вместо 1. По умолчанию отключено.

output_format_arrow_compression_method

Метод сжатия для формата вывода Arrow. Поддерживаемые кодеки: lz4_frame, zstd, none (без сжатия)

output_format_arrow_date_as_uint16

Записывает значения Date как обычные 16-битные числа (при обратном чтении — как UInt16), а не преобразует их в 32-битный тип Arrow DATE32 (при обратном чтении — как Date32).

output_format_arrow_fixed_string_as_fixed_byte_array

Использовать тип Arrow FIXED_SIZE_BINARY вместо Binary для столбцов FixedString.

output_format_arrow_low_cardinality_as_dictionary

Включает вывод типа LowCardinality как типа Dictionary Arrow

output_format_arrow_string_as_string

Использовать тип Arrow String вместо Binary для столбцов String

output_format_arrow_unsupported_types_as_binary

Выводить типы, для которых нет преобразования, в виде необработанных двоичных данных. Если false — такие типы будут вызывать исключение UNKNOWN_TYPE.

output_format_arrow_use_64_bit_indexes_for_dictionary

Всегда использовать 64-битные целые числа для индексов словаря в формате Arrow

output_format_arrow_use_native_writer

Использовать собственный механизм записи ClickHouse для форматов Arrow и ArrowStream вместо варианта на основе библиотеки Apache Arrow.

output_format_arrow_use_signed_indexes_for_dictionary

Использовать знаковые целые числа для индексов словарей в формате Arrow

output_format_avro_codec

Кодек сжатия, используемый для вывода данных. Возможные значения: ‘null’, ‘deflate’, ‘snappy’, ‘zstd’.

output_format_avro_confluent_subject

Для формата вывода AvroConfluent: subject, под которым схема регистрируется в Confluent Schema Registry. Обязательно при записи вывода AvroConfluent.

output_format_avro_rows_in_file

Максимальное число строк в файле (если это поддерживается хранилищем)

output_format_avro_string_column_pattern

Для формата Avro: шаблон регулярного выражения для столбцов типа String, которые следует выбирать как строки AVRO.

output_format_avro_sync_interval

Интервал синхронизации, в байтах.

output_format_binary_encode_types_in_binary_format

Записывает типы данных в двоичном формате вместо имён типов в формате вывода RowBinaryWithNamesAndTypes

output_format_binary_write_json_as_string

Записывает значения типа данных JSON в виде значений JSON String в формате вывода RowBinary.

output_format_bson_string_as_string

Использовать тип BSON String вместо Binary для столбцов типа String.

output_format_compression_level

Уровень сжатия по умолчанию, если вывод запроса сжат. Эта настройка применяется, когда запрос SELECT содержит INTO OUTFILE или при записи в табличные функции file, url, hdfs, s3 или azureBlobStorage. Возможные значения: от 1 до 22

output_format_compression_zstd_window_log

Можно использовать, если для вывода выбран метод сжатия zstd. Если значение больше 0, этот параметр явно задаёт размер окна сжатия (степень 2) и включает для сжатия zstd режим дальнего диапазона. Это может помочь добиться более высокого коэффициента сжатия. Возможные значения: неотрицательные числа. Обратите внимание: если значение слишком маленькое или слишком большое, zstdlib сгенерирует исключение. Обычно используются значения от 20 (размер окна = 1MB) до 30 (размер окна = 1GB).

output_format_csv_crlf_end_of_line

Если задать значение true, в формате CSV в конце строки будет использоваться \r\n вместо \n.

output_format_csv_header_serialize_tuple_into_separate_columns

Когда включен output_format_csv_serialize_tuple_into_separate_columns, строки заголовка CSVWithNames и CSVWithNamesAndTypes раскрывают каждый столбец Tuple в его конечные поля (имена с точками, такие как t.a, t.b, и имена конечных типов), так что заголовок содержит столько же столбцов, сколько и данные. Для CustomSeparated* это раскрытие применяется только если format_custom_escaping_rule = 'CSV' и format_custom_field_delimiter — одиночный символ, совпадающий с format_csv_delimiter; в противном случае (например, при разделителе табуляции по умолчанию или format_custom_field_delimiter = '|') заголовок остается нераскрытым, чтобы по-прежнему соответствовать данным. Установите значение 0, чтобы сохранить прежнее поведение, при котором заголовок содержит одно имя и один тип Tuple верхнего уровня. Примечание: раскрытый заголовок не считывается обратно в Tuple по имени, когда input_format_with_names_use_header = 1. Чтобы прочитать такие данные обратно в Tuple, либо установите для этой настройки значение 0 при выводе, либо читайте с input_format_with_names_use_header = 0 (а для форматов *WithNamesAndTypesCSVWithNamesAndTypes и CustomSeparatedWithNamesAndTypes — также input_format_with_types_use_header = 0, поскольку иначе раскрытая строка типов будет проверяться на соответствие единственному входному полю Tuple верхнего уровня и будет отклонена).

output_format_csv_serialize_tuple_into_separate_columns

Если установлено значение true, то Tuple в формате CSV сериализуются в отдельные столбцы (то есть их вложенность теряется)

output_format_decimal_trailing_zeros

Выводить конечные нули при отображении значений Decimal. Например, 1.230000 вместо 1.23. По умолчанию отключено.

output_format_float_precision

Если значение не равно нулю, вывод чисел с плавающей запятой (Float32, Float64, BFloat16) форматируется максимум с таким количеством знаков после десятичной точки (конечные нули удаляются). Если значение равно 0 (по умолчанию), используется кратчайшее представление, допускающее точное восстановление значения. Значения, слишком большие для записи в фиксированном формате, а также значения, модуль которых настолько мал, что округление до запрошенной точности привело бы к потере всех значащих цифр (мантисса стала бы ±0), вместо этого выводятся в научной нотации. В этих случаях мантисса может содержать больше знаков дробной части, чем указано в запрошенной точности. Допустимый диапазон: от 0 до 100.

output_format_image_height

Высота выходного изображения в пикселях для форматов вывода изображений, таких как PNG. Значение по умолчанию: 1024.

output_format_image_terminal_mode

Для форматов вывода изображений, таких как PNG, выводить изображение прямо в терминал с помощью inline-протокола изображений вместо записи сырых байтов изображения. Возможные значения:
  • “ (пусто) — записывать сырые байты изображения (по умолчанию).
  • iterm — использовать inline-протокол изображений iTerm2.
  • kitty — использовать графический протокол Kitty.
  • sixel — использовать протокол Sixel.
  • auto — если вывод направлен в терминал, определить его возможности и использовать iterm, kitty или sixel (в этом порядке); в противном случае записывать сырые байты изображения.
Значение по умолчанию: “ (пусто).

output_format_image_width

Ширина выводимого изображения в пикселях для форматов вывода изображений, таких как PNG. Значение по умолчанию: 1024.

output_format_json_array_of_rows

Включает вывод всех строк в виде JSON-массива в формате JSONEachRow. Возможные значения:
  • 1 — ClickHouse выводит все строки в виде массива, где каждая строка представлена в формате JSONEachRow.
  • 0 — ClickHouse выводит каждую строку отдельно в формате JSONEachRow.
Пример запроса с включенной настройкой Запрос:
Результат:
Пример запроса при отключённой настройке Запрос:
Результат:

output_format_json_escape_forward_slashes

Управляет экранированием символов прямой косой черты в строковом выводе в формате JSON. Это нужно для совместимости с JavaScript. Не путайте с обратной косой чертой, которая экранируется всегда. Включено по умолчанию.

output_format_json_map_as_array_of_tuples

Сериализует столбцы типа Map в JSON-массивы кортежей. Отключено по умолчанию.

output_format_json_named_tuples_as_objects

Сериализует столбцы именованных кортежей как объекты JSON. Включено по умолчанию.

output_format_json_pretty_print

Этот параметр определяет, как вложенные структуры, такие как Tuples, Maps и Arrays, отображаются в массиве data при использовании формата вывода JSON. Например, вместо вывода:
Вывод будет представлен в следующем формате:
Включено по умолчанию.

output_format_json_quote_64bit_floats

Управляет тем, будут ли 64-битные числа с плавающей точкой заключаться в кавычки при выводе в форматах JSON*. По умолчанию отключено.

output_format_json_quote_64bit_integers

Управляет тем, будут ли 64-битные и более крупные целые числа (например, UInt64 или Int128) заключаться в кавычки при выводе в формате JSON. По умолчанию такие целые числа заключаются в кавычки. Такое поведение совместимо с большинством реализаций JavaScript. Возможные значения:
  • 0 — Целые числа выводятся без кавычек.
  • 1 — Целые числа заключаются в кавычки.

output_format_json_quote_decimals

Управляет выводом десятичных чисел в кавычках в формате вывода JSON. Отключено по умолчанию.

output_format_json_quote_denormals

Включает вывод значений +nan, -nan, +inf, -inf в формате вывода JSON. Возможные значения:
  • 0 — Отключено.
  • 1 — Включено.
Пример Рассмотрим следующую таблицу account_orders:
Когда output_format_json_quote_denormals = 0, запрос возвращает значения null в выводе:
Когда output_format_json_quote_denormals = 1, запрос возвращает:

output_format_json_skip_null_value_in_named_tuples

Пропускать пары ключ-значение со значением NULL при сериализации столбцов именованных кортежей в виде объектов JSON. Действует только если output_format_json_named_tuples_as_objects имеет значение true.

output_format_json_validate_utf8

Управляет проверкой последовательностей UTF-8 в формате вывода JSON и не влияет на форматы JSON/JSONCompact/JSONColumnsWithMetadata — в них проверка UTF-8 выполняется всегда. По умолчанию отключено.

output_format_markdown_escape_special_characters

Если включено, специальные символы в Markdown экранируются. Common Mark определяет следующие специальные символы, которые можно экранировать с помощью :
Возможные значения:
  • 0 — Отключено.
  • 1 — Включено.

output_format_msgpack_uuid_representation

Способ представления UUID в формате MsgPack при выводе.

output_format_native_encode_types_in_binary_format

Записывает типы данных в двоичном виде вместо имён типов в формате вывода Native

output_format_native_use_flattened_dynamic_and_json_serialization

Записывает данные из столбцов JSON и Dynamic в уплощенном формате (все типы/пути — как отдельные подстолбцы).

output_format_native_write_json_as_string

Записывает данные JSON столбца как столбец String, содержащий JSON-строки, вместо стандартной нативной JSON-сериализации.

output_format_orc_compression_block_size

Размер блока сжатия в байтах для формата вывода ORC.

output_format_orc_compression_method

Метод сжатия для выходного формата ORC. Поддерживаемые кодеки: lz4, snappy, zlib, zstd, none (без сжатия)

output_format_orc_dictionary_key_size_threshold

Для строкового столбца в формате вывода ORC: если число различных значений превышает эту долю от общего числа строк с не-NULL значениями, кодирование с использованием словаря отключается. В противном случае оно включается

output_format_orc_row_index_stride

Целевой шаг индекса строк для выходного формата ORC

output_format_orc_string_as_string

Использовать тип ORC String вместо Binary для столбцов String

output_format_orc_writer_time_zone_name

Название часового пояса для ORC writer; часовой пояс ORC writer по умолчанию — GMT.

output_format_parallel_formatting

Включает или отключает параллельное форматирование данных. Поддерживается только для форматов TSV, TSKV, CSV и JSONEachRow. Возможные значения:
  • 1 — Включено.
  • 0 — Отключено.

output_format_parquet_batch_size

Проверять размер страницы через каждые столько строк. Рассмотрите возможность уменьшить значение, если у вас есть столбцы, у которых средний размер значений превышает несколько КБ.

output_format_parquet_bloom_filter_bits_per_value

Приблизительное количество битов для каждого уникального значения в bloom-фильтрах Parquet. Оценочные уровни ложноположительных срабатываний:
  • 6 бит — 10%
  • 10.5 бита — 1%
  • 16.9 бита — 0.1%
  • 26.4 бита — 0.01%
  • 41 бит — 0.001%

output_format_parquet_bloom_filter_flush_threshold_bytes

Где в файле Parquet размещать bloom-фильтры. Bloom-фильтры будут записываться порциями примерно такого размера. В частности:
  • если значение равно 0, bloom-фильтры каждой группы строк записываются сразу после соответствующей группы строк,
    • если значение больше общего размера всех bloom-фильтров, bloom-фильтры для всех групп строк будут накапливаться в памяти, а затем записываться вместе ближе к концу файла,
    • в противном случае bloom-фильтры будут накапливаться в памяти и записываться, как только их общий размер превысит это значение.

output_format_parquet_compression_method

Метод сжатия для выходного формата Parquet. Поддерживаемые кодеки: snappy, lz4, brotli, zstd, gzip, none (без сжатия)

output_format_parquet_data_page_size

Целевой размер страницы в байтах до сжатия.

output_format_parquet_date_as_uint16

Записывать значения Date как простые 16-битные числа (при чтении возвращаются как UInt16) вместо преобразования в 32-битный тип DATE в Parquet (при чтении возвращается как Date32).

output_format_parquet_datetime_as_uint32

Записывает значения DateTime как исходную Unix-временную метку (при обратном чтении — как UInt32), а не преобразует их в миллисекунды (при обратном чтении — как DateTime64(3)).

output_format_parquet_enum_as_byte_array

Записывать enum с использованием физического типа Parquet: BYTE_ARRAY и логического типа: ENUM

output_format_parquet_fixed_string_as_fixed_byte_array

Использовать тип Parquet FIXED_LEN_BYTE_ARRAY вместо Binary для столбцов типа FixedString.

output_format_parquet_geometadata

Позволяет записывать информацию о геопространственных столбцах в метаданные Parquet и кодировать столбцы в формате WKB.

output_format_parquet_max_dictionary_size

Если размер словаря превышает указанное количество байт, используется кодирование без словаря. Установите значение 0, чтобы отключить кодирование с использованием словаря.

output_format_parquet_parallel_encoding

Выполняет кодирование Parquet в нескольких потоках.

output_format_parquet_row_group_size

Целевой размер группы строк в количестве строк.

output_format_parquet_row_group_size_bytes

Целевой размер группы строк в байтах, до сжатия.

output_format_parquet_string_as_string

Использовать тип String в Parquet вместо Binary для столбцов String.

output_format_parquet_write_bloom_filter

Записывать bloom-фильтры в файлы Parquet.

output_format_parquet_write_checksums

Добавляет контрольные суммы CRC32 в заголовки страниц Parquet.

output_format_parquet_write_page_index

Записывает индекс столбцов и индекс смещений (то есть статистику по каждой странице данных, которую можно использовать для pushdown фильтров при чтении) в файлы Parquet.

output_format_pretty_color

Использовать ANSI-последовательности экранирования в форматах Pretty. 0 — отключено, 1 — включено, ‘auto’ — включено, если вывод идёт в терминал. Отображает имена столбцов в нижнем колонтитуле, если в таблице много строк. Возможные значения:
  • 0 — Имена столбцов не отображаются в нижнем колонтитуле.
  • 1 — Имена столбцов отображаются в нижнем колонтитуле, если количество строк больше или равно пороговому значению, заданному в output_format_pretty_display_footer_column_names_min_rows (по умолчанию — 50).
Пример Запрос:
Результат:
Задает минимальное количество строк, при котором будет отображаться нижний колонтитул с именами столбцов, если включена настройка output_format_pretty_display_footer_column_names.

output_format_pretty_fallback_to_vertical

Если настройка включена и таблица широкая, но содержит мало строк, формат Pretty будет выводить её так же, как формат Vertical. Подробную настройку этого поведения см. в output_format_pretty_fallback_to_vertical_max_rows_per_chunk и output_format_pretty_fallback_to_vertical_min_table_width.

output_format_pretty_fallback_to_vertical_max_rows_per_chunk

Переключение на формат Vertical (см. output_format_pretty_fallback_to_vertical) будет выполняться только в том случае, если количество записей во фрагменте не превышает указанное значение.

output_format_pretty_fallback_to_vertical_min_columns

Переключение на формат Vertical (см. output_format_pretty_fallback_to_vertical) произойдёт только в том случае, если количество столбцов больше указанного значения.

output_format_pretty_fallback_to_vertical_min_table_width

Переход к формату Vertical (см. output_format_pretty_fallback_to_vertical) выполняется только если суммарная длина столбцов таблицы не меньше указанного значения либо хотя бы одно значение содержит символ перевода строки.

output_format_pretty_glue_chunks

Если данные, отображаемые в форматах Pretty, поступили в нескольких фрагментах, даже с задержкой, но следующий фрагмент имеет ту же ширину столбцов, что и предыдущий, используйте ANSI-последовательности экранирования, чтобы вернуться к предыдущей строке и перезаписать нижний колонтитул предыдущего фрагмента, продолжив его данными из нового фрагмента. Это делает результат визуально более приятным. 0 — отключено, 1 — включено, ‘auto’ — включено при выводе в терминал.

output_format_pretty_grid_charset

Набор символов для отображения границ таблицы. Доступные наборы символов: ASCII, UTF-8 (по умолчанию). В interactive mode clickhouse-client автоматически переключается на ASCII, если терминал не поддерживает UTF-8 (это определяется переменными окружения LC_ALL, LC_CTYPE и LANG), если только этот параметр не задан явно.

output_format_pretty_highlight_digit_groups

Если параметр включен и вывод осуществляется в терминал, цифры, соответствующие тысячам, миллионам и т. д., подчеркиваются.

output_format_pretty_highlight_trailing_spaces

Если настройка включена и вывод идет в терминал, конечные пробелы подсвечиваются серым цветом и подчеркиваются.

output_format_pretty_max_column_name_width_cut_to

Если имя столбца слишком длинное, оно будет обрезано до этой длины. Имя столбца будет обрезано, если его длина превышает сумму output_format_pretty_max_column_name_width_cut_to и output_format_pretty_max_column_name_width_min_chars_to_cut.

output_format_pretty_max_column_name_width_min_chars_to_cut

Минимальное количество символов, на которое нужно сократить имя столбца, если оно слишком длинное. Имя столбца будет сокращено, если его длина превышает output_format_pretty_max_column_name_width_cut_to плюс output_format_pretty_max_column_name_width_min_chars_to_cut.

output_format_pretty_max_column_pad_width

Максимальная ширина заполнения для всех значений в столбце в форматах Pretty.

output_format_pretty_max_rows

Ограничение количества строк для форматов Pretty.

output_format_pretty_max_value_width

Максимальная ширина значения, отображаемого в форматах Pretty. Если ширина больше, значение будет обрезано. Значение 0 означает, что обрезка не выполняется.

output_format_pretty_max_value_width_apply_for_single_value

Обрезать значения (см. настройку output_format_pretty_max_value_width) только в том случае, если это не одиночное значение в блоке. В противном случае выводить его полностью, что особенно полезно для запроса SHOW CREATE TABLE.

output_format_pretty_multiline_fields

Если включено, форматы Pretty будут отображать многострочные поля внутри ячейки таблицы, благодаря чему сохранятся границы таблицы. Если нет, они будут отображаться как есть, что может исказить таблицу (при этом у отключения этой настройки есть и плюс: многострочные значения будет проще копировать и вставлять).

output_format_pretty_named_tuples_as_json

Определяет, выводятся ли именованные Tuple в формате Pretty в виде красиво отформатированных объектов JSON.

output_format_pretty_row_numbers

Добавляет номера перед каждой строкой в формате вывода Pretty

output_format_pretty_single_large_number_tip_threshold

Выводить справа от таблицы понятную числовую подсказку, если блок состоит из одного числа, превышающего это значение (кроме 0)

output_format_pretty_squash_consecutive_ms

Ожидает следующий блок в течение указанного количества миллисекунд и перед выводом объединяет его с предыдущим. Это позволяет избежать слишком частого вывода слишком маленьких блоков, сохраняя при этом возможность отображать данные в режиме стриминга.

output_format_pretty_squash_max_wait_ms

Выводить отложенный блок в форматах Pretty, если с момента предыдущего вывода прошло больше указанного количества миллисекунд.

output_format_pretty_use_nbsp_for_padding

Если включено, дополнение в форматах вывода Pretty отображается с помощью U+00A0 вместо пробела ASCII. В моноширинном шрифте вывод визуально остается тем же, но дополнение сохраняется при использовании инструментов, которые сжимают или обрезают последовательности обычных пробелов. Действует только если output_format_pretty_grid_charset имеет значение UTF-8.

output_format_protobuf_nullables_with_google_wrappers

При сериализации столбцов с типом Nullable с помощью обёрток Google значения по умолчанию сериализуются как пустые обёртки. Если этот параметр отключён, значения по умолчанию и значения NULL не сериализуются

output_format_schema

Путь к файлу, в который будет сохранена автоматически сгенерированная схема в формате Cap’n Proto или Protobuf.

output_format_sql_insert_include_column_names

Добавлять имена столбцов в запрос INSERT

output_format_sql_insert_max_batch_size

Максимальное количество строк в одном операторе INSERT.

output_format_sql_insert_quote_names

Заключать имена столбцов в символы «`»

output_format_sql_insert_table_name

Название таблицы в выводимом запросе INSERT

output_format_sql_insert_use_replace

Использовать оператор REPLACE вместо оператора INSERT

output_format_trim_fixed_string

Удаляет завершающие null-байты из значений FixedString в текстовых форматах вывода. Например, toFixedString('John', 8) выводится как John, а не John\0\0\0\0.

output_format_tsv_crlf_end_of_line

Если установлено значение true, в формате TSV в качестве конца строки будет использоваться \r\n вместо \n.

output_format_values_escape_quote_with_quote

Если true, экранировать ’ как ”, иначе использовать \‘

output_format_write_statistics

Записывает статистику о количестве прочитанных строк, байтов и затраченном времени в подходящих форматах вывода. Включено по умолчанию
Последнее изменение 23 июля 2026 г.