Перейти к основному содержимому
Перейти к основному содержимому

Настройки формата

Эти настройки сгенерированы автоматически из source.

bool_false_representation​

Тип: Строка

Значение по умолчанию: false

Текст для представления ложного значения типа bool в форматах TSV/CSV/Vertical/Pretty.

bool_true_representation​

Тип: Строка

Значение по умолчанию: true

Текст для представления истинного значения типа bool в форматах TSV/CSV/Vertical/Pretty.

column_names_for_schema_inference​

Тип: Строка

Значение по умолчанию:

Список имен столбцов, которые будут использоваться для вывода схемы для форматов без имен столбцов. Формат: 'column1,column2,column3,...'

cross_to_inner_join_rewrite​

Тип: UInt64

Значение по умолчанию: 1

Используйте внутреннее соединение вместо запятой/перекрестного соединения, если в разделе WHERE есть соединительные выражения. Значения: 0 - без переписывания, 1 - применить, если возможно, для запятой/перекрестного, 2 - принудительно переписать все запятие, перекрестное - если это возможно

date_time_64_output_format_cut_trailing_zeros_align_to_groups_of_thousands​

Тип: Bool

Значение по умолчанию: 0

Динамически обрезать десятичные нули у значений datetime64, чтобы скорректировать масштаб вывода на [0, 3, 6], соответствующий 'секундам', 'миллисекундам' и 'микросекундам'.

date_time_input_format​

Тип: DateTimeInputFormat

Значение по умолчанию: basic

Разрешает выбрать парсер текстового представления даты и времени.

Настройка не применяется к функциям даты и времени.

Возможные значения:

  • 'best_effort' — Включает расширенный разбор.

    ClickHouse может разбирать базовый формат YYYY-MM-DD HH:MM:SS и все форматы даты и времени ISO 8601. Например, '2018-06-08T01:02:03.000Z'.

  • 'basic' — Использовать базовый парсер.

    ClickHouse может разбирать только базовый формат YYYY-MM-DD HH:MM:SS или YYYY-MM-DD. Например, 2019-08-20 10:18:56 или 2019-08-20.

Значение по умолчанию в облаке: 'best_effort'.

Смотрите также:

date_time_output_format​

Тип: DateTimeOutputFormat

Значение по умолчанию: simple

Разрешает выбирать различные форматы вывода текстового представления даты и времени.

Возможные значения:

  • simple - Простой формат вывода.

    ClickHouse выводит дату и время в формате YYYY-MM-DD hh:mm:ss. Например, 2019-08-20 10:18:56. Расчет выполняется в соответствии с временной зоной типа данных (если присутствует) или временной зоной сервера.

  • iso - ISO формат вывода.

    ClickHouse выводит дату и время в формате ISO 8601 YYYY-MM-DDThh:mm:ssZ. Например, 2019-08-20T10:18:56Z. Обратите внимание, что вывод в UTC (Z означает UTC).

  • unix_timestamp - Формат вывода Unix timestamp.

    ClickHouse выводит дату и время в формате Unix timestamp. Например 1566285536.

Смотрите также:

date_time_overflow_behavior​

Тип: DateTimeOverflowBehavior

Значение по умолчанию: ignore

Определяет поведение при преобразовании Date, Date32, DateTime, DateTime64 или целых чисел в Date, Date32, DateTime или DateTime64, но значение не может быть представлено в результирующем типе.

Возможные значения:

  • ignore — Безмолвно игнорировать переполнения. Результаты неопределены.
  • throw — Генерировать исключение в случае переполнения.
  • saturate — Насыщать результат. Если значение меньше наименьшего значения, которое может быть представлено целевым типом, результат выбирается как наименьшее представимое значение. Если значение больше наибольшего значения, которое может быть представлено целевым типом, результат выбирается как наибольшее представимое значение.

Значение по умолчанию: ignore.

dictionary_use_async_executor​

Тип: Bool

Значение по умолчанию: 0

Выполнить конвейер для чтения источника словаря в нескольких потоках. Поддерживается только словарями с локальным источником CLICKHOUSE.

errors_output_format​

Тип: Строка

Значение по умолчанию: CSV

Метод для записи ошибок в текстовый вывод.

exact_rows_before_limit​

Тип: Bool

Значение по умолчанию: 0

При включении ClickHouse будет предоставлять точное значение для статистики rows_before_limit_at_least, но с затратами на полное чтение данных перед ограничением.

format_avro_schema_registry_url​

Тип: URI

Значение по умолчанию:

Для AvroConfluent формата: URL реестра схем Confluent.

format_binary_max_array_size​

Тип: UInt64

Значение по умолчанию: 1073741824

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

format_binary_max_string_size​

Тип: UInt64

Значение по умолчанию: 1073741824

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

format_capn_proto_enum_comparising_mode​

Тип: CapnProtoEnumComparingMode

Значение по умолчанию: by_values

Как сопоставить Enum ClickHouse и Enum CapnProto.

format_capn_proto_use_autogenerated_schema​

Тип: Bool

Значение по умолчанию: 1

Использовать сгенерированную автоматически схему CapnProto, когда format_schema не задан.

format_csv_allow_double_quotes​

Тип: Bool

Значение по умолчанию: 1

Если установлено в true, разрешает строки в двойных кавычках.

format_csv_allow_single_quotes​

Тип: Bool

Значение по умолчанию: 0

Если установлено в true, разрешает строки в одинарных кавычках.

format_csv_delimiter​

Тип: Символ

Значение по умолчанию: ,

Символ, который будет считаться разделителем в данных CSV. Если настройка с строкой, строка должна иметь длину 1.

format_csv_null_representation​

Тип: Строка

Значение по умолчанию: \N

Пользовательское представление NULL в формате CSV.

format_custom_escaping_rule​

Тип: EscapingRule

Значение по умолчанию: Escaped

Правило экранирования поля (для формата CustomSeparated).

format_custom_field_delimiter​

Тип: Строка

Значение по умолчанию:

Разделитель между полями (для формата CustomSeparated).

format_custom_result_after_delimiter​

Тип: Строка

Значение по умолчанию:

Суффикс после набора результатов (для формата CustomSeparated).

format_custom_result_before_delimiter​

Тип: Строка

Значение по умолчанию:

Префикс перед набором результатов (для формата CustomSeparated).

format_custom_row_after_delimiter​

Тип: Строка

Значение по умолчанию:

Разделитель после поля последнего столбца (для формата CustomSeparated).

format_custom_row_before_delimiter​

Тип: Строка

Значение по умолчанию:

Разделитель перед полем первого столбца (для формата CustomSeparated).

format_custom_row_between_delimiter​

Тип: Строка

Значение по умолчанию:

Разделитель между строками (для формата CustomSeparated).

format_display_secrets_in_show_and_select​

Тип: Bool

Значение по умолчанию: 0

Включает или отключает отображение секретов в запросах SHOW и SELECT для таблиц, баз данных, табличных функций и словарей.

Пользователь, который хочет видеть секреты, должен также иметь display_secrets_in_show_and_select серверная настройка включенной и привилегию displaySecretsInShowAndSelect.

Возможные значения:

  • 0 — Отключено.
  • 1 — Включено.

format_json_object_each_row_column_for_object_name​

Тип: Строка

Значение по умолчанию:

Имя столбца, которое будет использоваться для хранения/записи имен объектов в формате JSONObjectEachRow. Тип столбца должен быть String. Если значение пустое, будут использоваться имена по умолчанию row_{i} для имен объектов.

format_protobuf_use_autogenerated_schema​

Тип: Bool

Значение по умолчанию: 1

Использовать сгенерированный автоматически Protobuf, когда format_schema не задан.

format_regexp​

Тип: Строка

Значение по умолчанию:

Регулярное выражение (для формата Regexp).

format_regexp_escaping_rule​

Тип: EscapingRule

Значение по умолчанию: Raw

Правило экранирования поля (для формата Regexp).

format_regexp_skip_unmatched​

Тип: Bool

Значение по умолчанию: 0

Пропустить строки, которые не соответствуют регулярному выражению (для формата Regexp).

format_schema​

Тип: Строка

Значение по умолчанию:

Этот параметр полезен, когда вы используете форматы, которые требуют определения схемы, такие как Cap'n Proto или Protobuf. Значение зависит от формата.

format_template_resultset​

Тип: Строка

Значение по умолчанию:

Путь к файлу, содержащему строку формата для набора результатов (для формата Template).

format_template_resultset_format​

Тип: Строка

Значение по умолчанию:

Строка формата для набора результатов (для формата Template).

format_template_row​

Тип: Строка

Значение по умолчанию:

Путь к файлу, содержащему строку формата для строк (для формата Template).

format_template_row_format​

Тип: Строка

Значение по умолчанию:

Строка формата для строк (для формата Template).

format_template_rows_between_delimiter​

Тип: Строка

Значение по умолчанию:

Разделитель между строками (для формата Template).

format_tsv_null_representation​

Тип: Строка

Значение по умолчанию: \N

Пользовательское представление NULL в формате TSV.

input_format_allow_errors_num​

Тип: UInt64

Значение по умолчанию: 0

Устанавливает максимальное количество приемлемых ошибок при чтении из текстовых форматов (CSV, TSV и др.).

Значение по умолчанию: 0.

Всегда сочетается с input_format_allow_errors_ratio.

Если ошибка произошла во время чтения строк, но счетчик ошибок все еще меньше input_format_allow_errors_num, ClickHouse игнорирует строку и переходит к следующей.

Если и input_format_allow_errors_num, и input_format_allow_errors_ratio превышены, ClickHouse выбрасывает исключение.

input_format_allow_errors_ratio​

Тип: Float

Значение по умолчанию: 0

Устанавливает максимальный процент ошибок, допустимый при чтении из текстовых форматов (CSV, TSV и др.). Процент ошибок устанавливается как число с плавающей точкой от 0 до 1.

Значение по умолчанию: 0.

Всегда сочетается с input_format_allow_errors_num.

Если ошибка произошла во время чтения строк, но счетчик ошибок все еще меньше input_format_allow_errors_ratio, ClickHouse игнорирует строку и переходит к следующей.

Если и input_format_allow_errors_num, и input_format_allow_errors_ratio превышены, ClickHouse выбрасывает исключение.

input_format_allow_seeks​

Тип: Bool

Значение по умолчанию: 1

Разрешить поиск при чтении в форматах ввода ORC/Parquet/Arrow.

Включено по умолчанию.

input_format_arrow_allow_missing_columns​

Тип: Bool

Значение по умолчанию: 1

Разрешить пропущенные столбцы при чтении форматов ввода Arrow.

input_format_arrow_case_insensitive_column_matching​

Тип: Bool

Значение по умолчанию: 0

Игнорировать регистр при сопоставлении столбцов Arrow с столбцами CH.

input_format_arrow_skip_columns_with_unsupported_types_in_schema_inference​

Тип: Bool

Значение по умолчанию: 0

Пропустить столбцы с неподдерживаемыми типами при выводе схемы для формата Arrow.

input_format_avro_allow_missing_fields​

Тип: Bool

Значение по умолчанию: 0

Для формата Avro/AvroConfluent: когда поле не найдено в схеме, использовать значение по умолчанию вместо ошибки.

input_format_avro_null_as_default​

Тип: Bool

Значение по умолчанию: 0

Для формата Avro/AvroConfluent: вставить значение по умолчанию в случае null и не Nullable столбца.

input_format_binary_decode_types_in_binary_format {#input_format_binary_decode_types_in_binary_format​

Тип: Bool

Значение по умолчанию: 0

Читать типы данных в бинарном формате вместо имен типов в формате входных данных RowBinaryWithNamesAndTypes.

input_format_binary_read_json_as_string​

Тип: Bool

Значение по умолчанию: 0

Читать значения типа JSON как значения типа JSON String в формате RowBinary.

input_format_bson_skip_fields_with_unsupported_types_in_schema_inference​

Тип: Bool

Значение по умолчанию: 0

Пропуск полей с неподдерживаемыми типами при выводе схемы для формата BSON.

input_format_capn_proto_skip_fields_with_unsupported_types_in_schema_inference​

Тип: Bool

Значение по умолчанию: 0

Пропустить столбцы с неподдерживаемыми типами при выводе схемы для формата CapnProto.

input_format_csv_allow_cr_end_of_line​

Тип: Bool

Значение по умолчанию: 0

Если установлено в true, \r будет разрешен в конце строки, не сопровождаемый \n.

input_format_csv_allow_variable_number_of_columns​

Тип: Bool

Значение по умолчанию: 0

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

input_format_csv_allow_whitespace_or_tab_as_delimiter​

Тип: Bool

Значение по умолчанию: 0

Разрешить использовать пробелы и табуляции (\t) в качестве разделителя полей в строках CSV.

input_format_csv_arrays_as_nested_csv​

Тип: Bool

Значение по умолчанию: 0

При чтении массива из CSV ожидается, что его элементы будут сериализованы в вложенный CSV и затем помещены в строку. Пример: "[""Hello"", ""world"", ""42"""" TV""]". Скобки вокруг массива можно опустить.

input_format_csv_deserialize_separate_columns_into_tuple​

Тип: Bool

Значение по умолчанию: 1

Если установлено в true, то отдельные столбцы, записанные в формате CSV, могут быть десериализованы в столбец кортежа.

input_format_csv_detect_header​

Тип: Bool

Значение по умолчанию: 1

Автоматически обнаружить заголовок с именами и типами в формате CSV.

input_format_csv_empty_as_default​

Тип: Bool

Значение по умолчанию: 1

Рассматривать пустые поля во входных данных CSV как значения по умолчанию.

input_format_csv_enum_as_number​

Тип: Bool

Значение по умолчанию: 0

Рассматривать введенные значения enum в форматах CSV как индексы enum.

input_format_csv_skip_first_lines​

Тип: UInt64

Значение по умолчанию: 0

Пропустить указанное количество строк в начале данных в формате CSV.

input_format_csv_skip_trailing_empty_lines​

Тип: Bool

Значение по умолчанию: 0

Пропустить конечные пустые строки в формате CSV.

input_format_csv_trim_whitespaces​

Тип: Bool

Значение по умолчанию: 1

Обрезать пробелы и символы табуляции (\t) в начале и конце строк в формате CSV.

input_format_csv_try_infer_numbers_from_strings​

Тип: Bool

Значение по умолчанию: 0

Если включено, во время вывода схемы ClickHouse попытается вывести числа из строковых полей. Это может быть полезно, если данные CSV содержат заключенные в кавычки числа UInt64.

Отключено по умолчанию.

input_format_csv_try_infer_strings_from_quoted_tuples​

Тип: Bool

Значение по умолчанию: 1

Интерпретировать заключенные в кавычки кортежи во входных данных как значение типа String.

input_format_csv_use_best_effort_in_schema_inference​

Тип: Bool

Значение по умолчанию: 1

Используйте некоторые настройки и эвристики для вывода схемы в формате CSV.

input_format_csv_use_default_on_bad_values​

Тип: Bool

Значение по умолчанию: 0

Разрешить установить значение по умолчанию для столбца, когда десериализация поля CSV завершилась ошибкой из-за неверного значения.

input_format_custom_allow_variable_number_of_columns​

Тип: Bool

Значение по умолчанию: 0

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

input_format_custom_detect_header​

Тип: Bool

Значение по умолчанию: 1

Автоматически обнаружить заголовок с именами и типами в формате CustomSeparated.

input_format_custom_skip_trailing_empty_lines​

Тип: Bool

Значение по умолчанию: 0

Пропустить конечные пустые строки в формате CustomSeparated.

input_format_defaults_for_omitted_fields​

Тип: Bool

Значение по умолчанию: 1

При выполнении запросов INSERT заменять пропущенные значения столбцов значениями по умолчанию соответствующих столбцов. Эта опция применяется к форматам JSONEachRow (и другим JSON форматам), CSV, TabSeparated, TSKV, Parquet, Arrow, Avro, ORC, Native и форматам с суффиксами WithNames/WithNamesAndTypes.

примечание

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

Возможные значения:

  • 0 — Отключено.
  • 1 — Включено.

input_format_force_null_for_omitted_fields​

Тип: Bool

Значение по умолчанию: 0

Принудительно инициализировать пропущенные поля значениями null.

input_format_hive_text_allow_variable_number_of_columns​

Тип: Bool

Значение по умолчанию: 1

Игнорировать дополнительные столбцы при вводе Hive Text (если файл имеет больше столбцов, чем ожидается) и рассматривать отсутствующие поля в Hive Text как значения по умолчанию.

input_format_hive_text_collection_items_delimiter​

Тип: Символ

Значение по умолчанию: 

Разделитель между элементами коллекции (массив или карта) в файле Hive Text.

input_format_hive_text_fields_delimiter​

Тип: Символ

Значение по умолчанию: 

Разделитель между полями в файле Hive Text.

input_format_hive_text_map_keys_delimiter​

Тип: Символ

Значение по умолчанию: 

Разделитель между парой ключ/значение в файле Hive Text.

input_format_import_nested_json​

Тип: Bool

Значение по умолчанию: 0

Включает или отключает вставку JSON данных с вложенными объектами.

Поддерживаемые форматы:

Возможные значения:

  • 0 — Отключено.
  • 1 — Включено.

Смотрите также:

input_format_ipv4_default_on_conversion_error​

Тип: Bool

Значение по умолчанию: 0

Десериализация IPv4 будет использовать значения по умолчанию вместо выбрасывания исключения на ошибку преобразования.

Отключено по умолчанию.

input_format_ipv6_default_on_conversion_error​

Тип: Bool

Значение по умолчанию: 0

Десериализация IPV6 будет использовать значения по умолчанию вместо выбрасывания исключения на ошибку преобразования.

Отключено по умолчанию.

input_format_json_compact_allow_variable_number_of_columns​

Тип: Bool

Значение по умолчанию: 0

Разрешить переменное количество столбцов в строках в форматах JSONCompact/JSONCompactEachRow. Игнорировать дополнительные столбцы в строках с большим количеством столбцов, чем ожидалось, и рассматривать отсутствующие столбцы как значения по умолчанию.

Отключено по умолчанию.

input_format_json_defaults_for_missing_elements_in_named_tuple​

Тип: Bool

Значение по умолчанию: 1

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

Включено по умолчанию.

input_format_json_empty_as_default​

Тип: Bool

Значение по умолчанию: 0

При включении заменять пустые входные поля в JSON значениями по умолчанию. Для сложных значений по умолчанию также необходимо включить input_format_defaults_for_omitted_fields.

Возможные значения:

  • 0 — Отключить.
  • 1 — Включить.

input_format_json_ignore_unknown_keys_in_named_tuple​

Тип: Bool

Значение по умолчанию: 1

Игнорировать неизвестные ключи в объекте json для именованных кортежей.

Включено по умолчанию.

input_format_json_ignore_unnecessary_fields​

Тип: Bool

Значение по умолчанию: 1

Игнорировать ненужные поля и не парсить их. Включение этого может не выбрасывать исключения на строках json неверного формата или с дублирующимися полями.

input_format_json_infer_incomplete_types_as_strings​

Тип: Bool

Значение по умолчанию: 1

Разрешить использовать тип строки для ключей JSON, которые содержат только Null/{}/[] в образце данных во время вывода схемы. В форматах JSON любое значение можно прочитать как строку, и мы можем избежать ошибок, таких как Не удается определить тип для столбца 'column_name' по первым 25000 строкам данных, скорее всего, этот столбец содержит только Nulls или пустые массивы/карты, во время вывода схемы, используя тип строки для ключей с неясными типами.

Пример:

Результат:

Включено по умолчанию.

input_format_json_max_depth​

Тип: UInt64

Значение по умолчанию: 1000

Максимальная глубина поля в JSON. Это не строгий лимит, он не обязательно должен быть применен точно.

input_format_json_named_tuples_as_objects​

Тип: Bool

Значение по умолчанию: 1

Парсить именованные столбцы кортежа как объекты JSON.

Включено по умолчанию.

input_format_json_read_arrays_as_strings​

Тип: Bool

Значение по умолчанию: 1

Разрешить парсинг массивов JSON как строк в форматах ввода JSON.

Пример:

Результат:

Включено по умолчанию.

input_format_json_read_bools_as_numbers​

Тип: Bool

Значение по умолчанию: 1

Разрешить парсинг булевых значений как чисел в форматах ввода JSON.

Включено по умолчанию.

input_format_json_read_bools_as_strings​

Тип: Bool

Значение по умолчанию: 1

Разрешить парсинг булевых значений как строк в форматах ввода JSON.

Включено по умолчанию.

input_format_json_read_numbers_as_strings​

Тип: Bool

Значение по умолчанию: 1

Разрешить парсинг чисел как строк в форматах ввода JSON.

Включено по умолчанию.

input_format_json_read_objects_as_strings​

Тип: Bool

Значение по умолчанию: 1

Разрешить парсинг объектов JSON как строк в форматах ввода JSON.

Пример:

Результат:

Включено по умолчанию.

input_format_json_throw_on_bad_escape_sequence​

Тип: Bool

Значение по умолчанию: 1

Выбросить исключение, если строка JSON содержит неверную последовательность экранирования в форматах ввода JSON. Если отключено, неверные последовательности экранирования останутся неизменными в данных.

Включено по умолчанию.

input_format_json_try_infer_named_tuples_from_objects​

Тип: Bool

Значение по умолчанию: 1

Если включено, во время вывода схемы ClickHouse попытается вывести именованный кортеж из объектов JSON. Результирующий именованный кортеж будет содержать все элементы всех соответствующих объектов JSON из образца данных.

Пример:

Результат:

Включено по умолчанию.

input_format_json_try_infer_numbers_from_strings​

Тип: Bool

Значение по умолчанию: 0

Если включено, во время вывода схемы ClickHouse попытается вывести числа из строковых полей. Это может быть полезно, если данные JSON содержат заключенные в кавычки числа UInt64.

Отключено по умолчанию.

input_format_json_use_string_type_for_ambiguous_paths_in_named_tuples_inference_from_objects {#input_format_json_use_string_type_for_ambiguous_paths_in_named_tuples_inference_from_objects.​

Тип: Bool

Значение по умолчанию: 0

Использовать тип строки вместо исключения в случае неоднозначных путей в объектах JSON во время вывода именованных кортежей.

input_format_json_validate_types_from_metadata​

Тип: Bool

Значение по умолчанию: 1

Для input форматов JSON/JSONCompact/JSONColumnsWithMetadata, если эта настройка установлена в 1, типы из метаданных входных данных будут сопоставляться с типами соответствующих столбцов из таблицы.

Включено по умолчанию.

input_format_max_bytes_to_read_for_schema_inference​

Тип: UInt64

Значение по умолчанию: 33554432

Максимальное количество данных в байтах, которое можно прочитать для автоматического вывода схемы.

input_format_max_rows_to_read_for_schema_inference​

Тип: UInt64

Значение по умолчанию: 25000

Максимальное количество строк данных, которые можно прочитать для автоматического вывода схемы.

input_format_msgpack_number_of_columns​

Тип: UInt64

Значение по умолчанию: 0

Количество столбцов в добавленных данных MsgPack. Используется для автоматического вывода схемы из данных.

input_format_mysql_dump_map_column_names​

Тип: Bool

Значение по умолчанию: 1

Сопоставлять столбцы из таблицы в дампе MySQL и столбцы из таблицы ClickHouse по именам.

input_format_mysql_dump_table_name​

Тип: String

Значение по умолчанию:

Имя таблицы в дампе MySQL, из которой следует читать данные.

input_format_native_allow_types_conversion​

Тип: Bool

Значение по умолчанию: 1

Разрешить преобразование типов данных в формате Native.

input_format_native_decode_types_in_binary_format​

Тип: Bool

Значение по умолчанию: 0

Читать типы данных в двоичном формате вместо имен типов в формате Native.

input_format_null_as_default​

Тип: Bool

Значение по умолчанию: 1

Включает или отключает инициализацию полей NULL значениями по умолчанию, если тип данных этих полей не nullable. Если тип столбца не nullable и эта настройка отключена, то вставка NULL вызовет исключение. Если тип столбца nullable, то значения NULL вставляются как есть, независимо от этой настройки.

Эта настройка применима для большинства форматов ввода.

Для сложных выражений по умолчанию также должен быть включен параметр input_format_defaults_for_omitted_fields.

Возможные значения:

  • 0 — Вставка NULL в не nullable столбец вызывает исключение.
  • 1 — Поля NULL инициализируются значениями по умолчанию.

input_format_orc_allow_missing_columns​

Тип: Bool

Значение по умолчанию: 1

Разрешить отсутствующие столбцы при чтении ORC форматов ввода.

input_format_orc_case_insensitive_column_matching​

Тип: Bool

Значение по умолчанию: 0

Игнорировать регистры при сопоставлении столбцов ORC со столбцами CH.

input_format_orc_dictionary_as_low_cardinality​

Тип: Bool

Значение по умолчанию: 1

Обрабатывать закодированные словарем столбцы ORC как столбцы LowCardinality при чтении ORC файлов.

input_format_orc_filter_push_down​

Тип: Bool

Значение по умолчанию: 1

При чтении ORC файлов пропускать целые полосы или группы строк на основе выражений WHERE/PREWHERE, минимальной/максимальной статистики или фильтра Блума в метаданных ORC.

input_format_orc_reader_time_zone_name​

Тип: String

Значение по умолчанию: GMT

Имя временной зоны для чтения строк ORC, временная зона по умолчанию для чтения строк ORC — GMT.

input_format_orc_row_batch_size​

Тип: Int64

Значение по умолчанию: 100000

Размер пакета при чтении полос ORC.

input_format_orc_skip_columns_with_unsupported_types_in_schema_inference​

Тип: Bool

Значение по умолчанию: 0

Пропускать столбцы с неподдерживаемыми типами при выводе схемы для формата ORC.

input_format_orc_use_fast_decoder​

Тип: Bool

Значение по умолчанию: 1

Использовать более быструю реализацию декодера ORC.

input_format_parquet_allow_missing_columns​

Тип: Bool

Значение по умолчанию: 1

Разрешить отсутствующие столбцы при чтении Parquet форматов ввода.

input_format_parquet_bloom_filter_push_down​

Тип: Bool

Значение по умолчанию: 0

При чтении Parquet файлов пропускать целые группы строк на основе выражений WHERE и фильтра Блума в метаданных Parquet.

input_format_parquet_case_insensitive_column_matching​

Тип: Bool

Значение по умолчанию: 0

Игнорировать регистры при сопоставлении столбцов Parquet со столбцами CH.

input_format_parquet_enable_row_group_prefetch​

Тип: Bool

Значение по умолчанию: 1

Включить предварительную выборку групп строк при парсинге Parquet. В настоящее время только однопоточный парсинг может выполняться с предварительной выборкой.

input_format_parquet_filter_push_down​

Тип: Bool

Значение по умолчанию: 1

При чтении Parquet файлов пропускать целые группы строк на основе выражений WHERE/PREWHERE и минимальной/максимальной статистики в метаданных Parquet.

input_format_parquet_local_file_min_bytes_for_seek​

Тип: UInt64

Значение по умолчанию: 8192

Минимальные байты, необходимые для локального чтения (файла) для выполнения поиска, вместо чтения с игнорированием в формате Parquet.

input_format_parquet_max_block_size​

Тип: UInt64

Значение по умолчанию: 65409

Максимальный размер блока для Parquet reader.

input_format_parquet_prefer_block_bytes​

Тип: UInt64

Значение по умолчанию: 16744704

Средний размер блока в байтах, выводимый Parquet reader.

input_format_parquet_preserve_order​

Тип: Bool

Значение по умолчанию: 0

Избегать перестановки строк при чтении из Parquet файлов. Обычно значительно замедляет процесс.

input_format_parquet_skip_columns_with_unsupported_types_in_schema_inference​

Тип: Bool

Значение по умолчанию: 0

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

input_format_parquet_use_native_reader​

Тип: Bool

Значение по умолчанию: 0

При чтении Parquet файлов использовать нативный reader вместо Arrow reader.

input_format_protobuf_flatten_google_wrappers​

Тип: Bool

Значение по умолчанию: 0

Включить обертки Google для обычных не вложенных столбцов, например, google.protobuf.StringValue 'str' для столбца String 'str'. Для Nullable столбцов пустые обертки распознаются как значения по умолчанию, а отсутствующие как null.

input_format_protobuf_skip_fields_with_unsupported_types_in_schema_inference​

Тип: Bool

Значение по умолчанию: 0

Пропускать поля с неподдерживаемыми типами при выводе схемы для формата Protobuf.

input_format_record_errors_file_path​

Тип: String

Значение по умолчанию:

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

input_format_skip_unknown_fields​

Тип: Bool

Значение по умолчанию: 1

Включает или отключает пропуск вставки дополнительных данных.

При записи данных ClickHouse выдает исключение, если входные данные содержат столбцы, которые отсутствуют в целевой таблице. Если пропуск включен, ClickHouse не вставляет дополнительные данные и не вызывает исключения.

Поддерживаемые форматы:

Возможные значения:

  • 0 — Отключен.
  • 1 — Включен.

input_format_try_infer_dates​

Тип: Bool

Значение по умолчанию: 1

Если включено, ClickHouse попытается вывести тип Date из строковых полей в выводе схемы для текстовых форматов. Если все поля из столбца во входных данных были успешно распознаны как даты, то результирующий тип будет Date, если хотя бы одно поле не было распознано как дата, то результирующий тип будет String.

Включено по умолчанию.

input_format_try_infer_datetimes​

Тип: Bool

Значение по умолчанию: 1

Если включено, ClickHouse попытается вывести тип DateTime64 из строковых полей в выводе схемы для текстовых форматов. Если все поля из столбца во входных данных были успешно распознаны как даты и времена, то результирующий тип будет DateTime64, если хотя бы одно поле не было распознано как дата и время, то результирующий тип будет String.

Включено по умолчанию.

input_format_try_infer_datetimes_only_datetime64​

Тип: Bool

Значение по умолчанию: 0

Когда input_format_try_infer_datetimes включен, выводить только DateTime64, но не DateTime типы.

input_format_try_infer_exponent_floats​

Тип: Bool

Значение по умолчанию: 0

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

input_format_try_infer_integers​

Тип: Bool

Значение по умолчанию: 1

Если включено, ClickHouse попытается вывести целые числа вместо чисел с плавающей запятой при выводе схемы для текстовых форматов. Если все числа в столбце во входных данных являются целыми, то результирующий тип будет Int64, если хотя бы одно число является числом с плавающей запятой, то результирующий тип будет Float64.

Включено по умолчанию.

input_format_try_infer_variants​

Тип: Bool

Значение по умолчанию: 0

Если включено, ClickHouse попытается вывести тип Variant в выводе схемы для текстовых форматов, когда для элементов столбца/массива существует более одного возможного типа.

Возможные значения:

  • 0 — Отключен.
  • 1 — Включен.

input_format_tsv_allow_variable_number_of_columns​

Тип: Bool

Значение по умолчанию: 0

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

input_format_tsv_crlf_end_of_line​

Тип: Bool

Значение по умолчанию: 0

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

input_format_tsv_detect_header​

Тип: Bool

Значение по умолчанию: 1

Автоматически обнаруживать заголовок с именами и типами в формате TSV.

input_format_tsv_empty_as_default​

Тип: Bool

Значение по умолчанию: 0

Рассматривать пустые поля в входных данных TSV как значения по умолчанию.

input_format_tsv_enum_as_number​

Тип: Bool

Значение по умолчанию: 0

Рассматривать вставленные значения enum в форматах TSV как индексы enum.

input_format_tsv_skip_first_lines​

Тип: UInt64

Значение по умолчанию: 0

Пропускать указанное количество строк в начале данных в формате TSV.

input_format_tsv_skip_trailing_empty_lines​

Тип: Bool

Значение по умолчанию: 0

Пропускать лишние пустые строки в формате TSV.

input_format_tsv_use_best_effort_in_schema_inference​

Тип: Bool

Значение по умолчанию: 1

Использовать некоторые настройки и эвристику для вывода схемы в формате TSV.

input_format_values_accurate_types_of_literals​

Тип: Bool

Значение по умолчанию: 1

Для формата Values: при парсинге и интерпретации выражений с использованием шаблона проверять фактический тип литерала, чтобы избежать возможных переполнений и проблем с точностью.

input_format_values_deduce_templates_of_expressions​

Тип: Bool

Значение по умолчанию: 1

Для формата Values: если поле не удалось разобрать с помощью потокового парсера, запустить SQL парсер, вывести шаблон SQL выражения, попытаться разобрать все строки с использованием шаблона, а затем интерпретировать выражение для всех строк.

input_format_values_interpret_expressions​

Тип: Bool

Значение по умолчанию: 1

Для формата Values: если поле не удалось разобрать с помощью потокового парсера, запустить SQL парсер и попытаться интерпретировать его как SQL выражение.

input_format_with_names_use_header​

Тип: Bool

Значение по умолчанию: 1

Включает или отключает проверку порядка столбцов при вставке данных.

Чтобы улучшить производительность вставки, мы рекомендуем отключить эту проверку, если вы уверены, что порядок столбцов входных данных совпадает с порядком в целевой таблице.

Поддерживаемые форматы:

Возможные значения:

  • 0 — Отключен.
  • 1 — Включен.

input_format_with_types_use_header​

Тип: Bool

Значение по умолчанию: 1

Контролирует, должен ли парсер формата проверять, соответствуют ли типы данных из входных данных типам данных из целевой таблицы.

Поддерживаемые форматы:

Возможные значения:

  • 0 — Отключен.
  • 1 — Включен.

insert_distributed_one_random_shard​

Тип: Bool

Значение по умолчанию: 0

Включает или отключает вставку в случайный шард в Distributed таблицу, когда отсутствует распределенный ключ.

По умолчанию, при вставке данных в Distributed таблицу с более чем одним шардом, сервер ClickHouse отклоняет любой запрос на вставку, если отсутствует распределенный ключ. Когда insert_distributed_one_random_shard = 1, вставки разрешены, и данные случайным образом передаются между всеми шардом.

Возможные значения:

  • 0 — Вставка отклоняется, если есть несколько шардов и не указан распределенный ключ.
  • 1 — Вставка выполняется случайным образом между всеми доступными шардами, когда не указан распределенный ключ.

interval_output_format​

Тип: IntervalOutputFormat

Значение по умолчанию: numeric

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

Возможные значения:

  • kusto - Выходной формат в стиле KQL.

    ClickHouse выводит интервалы в формате KQL. Например, toIntervalDay(2) будет отформатирован как 2.00:00:00. Обратите внимание, что для типов интервалов переменной длины (например, IntervalMonth и IntervalYear) учитывается среднее количество секунд на интервал.

  • numeric - Числовой выходной формат.

    ClickHouse выводит интервалы как их базовое числовое представление. Например, toIntervalDay(2) будет отформатирован как 2.

См. также:

output_format_arrow_compression_method​

Тип: ArrowCompression

Значение по умолчанию: lz4_frame

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

output_format_arrow_fixed_string_as_fixed_byte_array​

Тип: Bool

Значение по умолчанию: 1

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

output_format_arrow_low_cardinality_as_dictionary​

Тип: Bool

Значение по умолчанию: 0

Включить вывод типа LowCardinality как типа словаря Arrow.

output_format_arrow_string_as_string​

Тип: Bool

Значение по умолчанию: 1

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

output_format_arrow_use_64_bit_indexes_for_dictionary​

Тип: Bool

Значение по умолчанию: 0

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

output_format_arrow_use_signed_indexes_for_dictionary​

Тип: Bool

Значение по умолчанию: 1

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

output_format_avro_codec​

Тип: String

Значение по умолчанию:

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

output_format_avro_rows_in_file​

Тип: UInt64

Значение по умолчанию: 1

Максимальное количество строк в файле (если это разрешено хранилищем).

output_format_avro_string_column_pattern​

Тип: String

Значение по умолчанию:

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

output_format_avro_sync_interval​

Тип: UInt64

Значение по умолчанию: 16384

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

output_format_binary_encode_types_in_binary_format​

Тип: Bool

Значение по умолчанию: 0

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

output_format_binary_write_json_as_string​

Тип: Bool

Значение по умолчанию: 0

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

output_format_bson_string_as_string​

Тип: Bool

Значение по умолчанию: 0

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

output_format_csv_crlf_end_of_line​

Тип: Bool

Значение по умолчанию: 0

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

output_format_csv_serialize_tuple_into_separate_columns​

Тип: Bool

Значение по умолчанию: 1

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

output_format_decimal_trailing_zeros​

Тип: Bool

Значение по умолчанию: 0

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

Отключено по умолчанию.

output_format_json_array_of_rows​

Тип: Bool

Значение по умолчанию: 0

Включает возможность выводить все строки в виде массива JSON в формате JSONEachRow.

Возможные значения:

  • 1 — ClickHouse выводит все строки в виде массива, каждая строка в формате JSONEachRow.
  • 0 — ClickHouse выводит каждую строку отдельно в формате JSONEachRow.

Пример запроса с включенной настройкой

Запрос:

Результат:

Пример запроса с отключенной настройкой

Запрос:

Результат:

output_format_json_escape_forward_slashes​

Тип: Bool

Значение по умолчанию: 1

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

Включено по умолчанию.

output_format_json_named_tuples_as_objects​

Тип: Bool

Значение по умолчанию: 1

Сериализовать названные кортежные столбцы как объекты JSON.

Включено по умолчанию.

output_format_json_pretty_print​

Тип: Bool

Значение по умолчанию: 1

Когда включено, значения сложных типов данных, таких как Tuple/Array/Map в формате JSON в разделе 'data', будут выводиться в красивом формате.

Включено по умолчанию.

output_format_json_quote_64bit_floats​

Тип: Bool

Значение по умолчанию: 0

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

Отключено по умолчанию.

output_format_json_quote_64bit_integers​

Тип: Bool

Значение по умолчанию: 1

Контролирует квотацию 64-битных или больших целых чисел (таких как UInt64 или Int128), когда они выводятся в формате JSON. Такие целые числа по умолчанию заключаются в кавычки. Это поведение совместимо с большинством реализаций JavaScript.

Возможные значения:

  • 0 — Целые числа выводятся без кавычек.
  • 1 — Целые числа заключены в кавычки.

output_format_json_quote_decimals​

Тип: Bool

Значение по умолчанию: 0

Контролирует квотацию десятичных значений в форматах JSON.

Отключено по умолчанию.

output_format_json_quote_denormals​

Тип: Bool

Значение по умолчанию: 0

Включает выводы +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​

Тип: Bool

Значение по умолчанию: 0

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

output_format_json_validate_utf8​

Тип: Bool

Значение по умолчанию: 0

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

Отключено по умолчанию.

output_format_markdown_escape_special_characters​

Тип: Bool

Значение по умолчанию: 0

Когда включено, экранируйте специальные символы в Markdown.

Common Mark определяет следующие специальные символы, которые могут быть экранированы с помощью :

Возможные значения:

  • 0 — Отключить.
  • 1 — Включить.

output_format_msgpack_uuid_representation​

Тип: MsgPackUUIDRepresentation

Значение по умолчанию: ext

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

output_format_native_encode_types_in_binary_format​

Тип: Bool

Значение по умолчанию: 0

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

output_format_native_write_json_as_string​

Тип: Bool

Значение по умолчанию: 0

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

output_format_orc_compression_method​

Тип: ORCCompression

Значение по умолчанию: zstd

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

output_format_orc_dictionary_key_size_threshold​

Тип: Double

Значение по умолчанию: 0

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

output_format_orc_row_index_stride​

Тип: UInt64

Значение по умолчанию: 10000

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

output_format_orc_string_as_string​

Тип: Bool

Значение по умолчанию: 1

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

output_format_orc_writer_time_zone_name​

Тип: String

Значение по умолчанию: GMT

Имя временной зоны для писателя ORC, временная зона по умолчанию для писателя ORC — GMT.

output_format_parquet_batch_size​

Тип: UInt64

Значение по умолчанию: 1024

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

output_format_parquet_bloom_filter_bits_per_value​

Тип: Double

Значение по умолчанию: 10.5

Приблизительное количество бит, которое следует использовать для каждого уникального значения в фильтрах Блума 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​

Тип: UInt64

Значение по умолчанию: 134217728

Где в файле parquet разместить фильтры Блума. Фильтры Блума будут записаны группами примерно такого размера. В частности:

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

output_format_parquet_compliant_nested_types​

Тип: Bool

Значение по умолчанию: 1

В схеме файла parquet использовать имя 'element' вместо 'item' для элементов списка. Это исторический артефакт реализации библиотеки Arrow. Обычно увеличивает совместимость, за исключением, возможно, со старыми версиями Arrow.

output_format_parquet_compression_method​

Тип: ParquetCompression

Значение по умолчанию: zstd

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

output_format_parquet_data_page_size​

Тип: UInt64

Значение по умолчанию: 1048576

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

output_format_parquet_datetime_as_uint32​

Тип: Bool

Значение по умолчанию: 0

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

output_format_parquet_fixed_string_as_fixed_byte_array​

Тип: Bool

Значение по умолчанию: 1

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

output_format_parquet_parallel_encoding​

Тип: Bool

Значение по умолчанию: 1

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

output_format_parquet_row_group_size​

Тип: UInt64

Значение по умолчанию: 1000000

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

output_format_parquet_row_group_size_bytes​

Тип: UInt64

Значение по умолчанию: 536870912

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

output_format_parquet_string_as_string​

Тип: Bool

Значение по умолчанию: 1

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

output_format_parquet_use_custom_encoder​

Тип: Bool

Значение по умолчанию: 1

Использовать более быструю реализацию кодировщика Parquet.

output_format_parquet_version​

Тип: ParquetVersion

Значение по умолчанию: 2.latest

Версия формата Parquet для формата вывода. Поддерживаемые версии: 1.0, 2.4, 2.6 и 2.latest (по умолчанию).

Результат:

Тип: UInt64

Значение по умолчанию: 50

Устанавливает минимальное количество строк, для которого будет отображаться подвал с названиями столбцов, если включена настройка output_format_pretty_display_footer_column_names.

output_format_pretty_fallback_to_vertical​

Тип: Bool

Значение по умолчанию: 1

Если включено, и таблица широкая, но короткая, формат 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​

Тип: UInt64

Значение по умолчанию: 10

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

output_format_pretty_fallback_to_vertical_min_columns​

Тип: UInt64

Значение по умолчанию: 5

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

output_format_pretty_fallback_to_vertical_min_table_width​

Тип: UInt64

Значение по умолчанию: 250

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

output_format_pretty_grid_charset​

Тип: String

Значение по умолчанию: UTF-8

Кодировка для печати границ сетки. Доступные кодировки: ASCII, UTF-8 (по умолчанию).

output_format_pretty_highlight_digit_groups​

Тип: Bool

Значение по умолчанию: 1

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

output_format_pretty_highlight_trailing_spaces​

Тип: Bool

Значение по умолчанию: 1

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

output_format_pretty_max_column_name_width_cut_to​

Тип: UInt64

Значение по умолчанию: 24

Если название столбца слишком длинное, обрезать его до этой длины. Столбец будет обрезан, если он длинее, чем 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​

Тип: UInt64

Значение по умолчанию: 4

Минимальное количество символов для обрезки, если название столбца слишком длинное. Столбец будет обрезан, если он длинее, чем 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​

Тип: UInt64

Значение по умолчанию: 250

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

output_format_pretty_max_rows​

Тип: UInt64

Значение по умолчанию: 1000

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

output_format_pretty_max_value_width​

Тип: UInt64

Значение по умолчанию: 10000

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

output_format_pretty_max_value_width_apply_for_single_value​

Тип: UInt64

Значение по умолчанию: 0

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

output_format_pretty_multiline_fields​

Тип: Bool

Значение по умолчанию: 1

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

output_format_pretty_row_numbers​

Тип: Bool

Значение по умолчанию: 1

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

output_format_pretty_single_large_number_tip_threshold​

Тип: UInt64

Значение по умолчанию: 1000000

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

output_format_pretty_squash_consecutive_ms​

Тип: UInt64

Значение по умолчанию: 50

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

output_format_pretty_squash_max_wait_ms​

Тип: UInt64

Значение по умолчанию: 1000

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

output_format_protobuf_nullables_with_google_wrappers​

Тип: Bool

Значение по умолчанию: 0

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

output_format_schema​

Тип: String

Значение по умолчанию:

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

output_format_sql_insert_include_column_names​

Тип: Bool

Значение по умолчанию: 1

Включить названия столбцов в запрос INSERT.

output_format_sql_insert_max_batch_size​

Тип: UInt64

Значение по умолчанию: 65409

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

output_format_sql_insert_quote_names​

Тип: Bool

Значение по умолчанию: 1

Оборачивать названия столбцов символами '`'.

output_format_sql_insert_table_name​

Тип: String

Значение по умолчанию: table

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

output_format_sql_insert_use_replace​

Тип: Bool

Значение по умолчанию: 0

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

output_format_tsv_crlf_end_of_line​

Тип: Bool

Значение по умолчанию: 0

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

output_format_values_escape_quote_with_quote​

Тип: Bool

Значение по умолчанию: 0

Если true, экранировать ' с '', в противном случае оборачивать \'

output_format_write_statistics​

Тип: Bool

Значение по умолчанию: 1

Записывать статистику о прочитанных строках, байтах, времени выполнения в подходящих выходных форматах.

Включено по умолчанию.

precise_float_parsing​

Тип: Bool

Значение по умолчанию: 0

Предпочитать более точный (но более медленный) алгоритм разбора чисел с плавающей запятой.

regexp_dict_allow_hyperscan​

Тип: Bool

Значение по умолчанию: 1

Разрешить словарю regexp_tree использовать библиотеку Hyperscan.

regexp_dict_flag_case_insensitive​

Тип: Bool

Значение по умолчанию: 0

Использовать нечувствительное к регистру сопоставление для словаря regexp_tree. Может быть переопределено в отдельных выражениях с помощью (?i) и (?-i).

regexp_dict_flag_dotall​

Тип: Bool

Значение по умолчанию: 0

Разрешить '.' соответствовать символам новой строки для словаря regexp_tree.

rows_before_aggregation​

Тип: Bool

Значение по умолчанию: 0

Когда включено, ClickHouse будет предоставлять точное значение для статистики rows_before_aggregation, представляющей количество строк, прочитанных перед агрегацией.

schema_inference_hints​

Тип: String

Значение по умолчанию:

Список названий столбцов и типов, которые будут использоваться как подсказки в выводе схемы для форматов без схемы.

Пример:

Запрос:

Результат:

примечание

Если schema_inference_hints не отформатирован правильно, или есть опечатка или неправильный тип данных и т.д., вся информация в schema_inference_hints будет проигнорирована.

schema_inference_make_columns_nullable​

Тип: UInt64Auto

Значение по умолчанию: 1

Управляет тем, чтобы выводимые типы были Nullable в выводе схемы. Если настройка включена, все выведенные типы будут Nullable, если отключена, выведенные типы никогда не будут Nullable, если установлено в auto, выведенный тип будет Nullable только если столбец содержит NULL в выборке, разбираемой во время вывода схемы, или метаданные файла содержат информацию о допустимости нулевых значений столбца.

schema_inference_make_json_columns_nullable​

Тип: Bool

Значение по умолчанию: 0

Управляет тем, чтобы выводимые JSON-тип в выводе схемы были Nullable. Если эта настройка включена вместе с schema_inference_make_columns_nullable, выведенный JSON-тип будет Nullable.

schema_inference_mode​

Тип: SchemaInferenceMode

Значение по умолчанию: default

Режим вывода схемы. 'default' - предполагается, что все файлы имеют одинаковую схему и схему можно вывести из любого файла, 'union' - файлы могут иметь разные схемы, и результирующая схема должна быть объединением схем всех файлов.

show_create_query_identifier_quoting_rule​

Тип: IdentifierQuotingRule

Значение по умолчанию: when_necessary

Установить правило оборачивания для идентификаторов в запросе SHOW CREATE.

show_create_query_identifier_quoting_style​

Тип: IdentifierQuotingStyle

Значение по умолчанию: Backticks

Установить стиль оборачивания для идентификаторов в запросе SHOW CREATE.

type_json_skip_duplicated_paths​

Тип: Bool

Значение по умолчанию: 0

Когда включено, при разборе JSON-объекта в тип JSON дублирующие пути будут игнорироваться, и вместо исключения будет вставлен только первый.

validate_experimental_and_suspicious_types_inside_nested_types​

Тип: Bool

Значение по умолчанию: 1

Проверить использование экспериментальных и подозрительных типов внутри вложенных типов, таких как Array/Map/Tuple.