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

Настройки формата для JSON

На этой странице представлены настройки формата, общие для всех JSON-форматов.

ПараметрОписаниеПо умолчаниюПримечание
input_format_import_nested_jsonОтображает вложенные данные JSON во вложенные таблицы (работает для формата JSONEachRow).false
input_format_json_read_bools_as_numbersРазрешает интерпретировать булевы значения как числа во входных форматах JSON.true
input_format_json_read_bools_as_stringsПозволяет интерпретировать логические значения как строки во входных форматах JSON.true
input_format_json_read_numbers_as_stringsРазрешает интерпретировать числовые значения как строки во входных форматах JSON.true
input_format_json_read_arrays_as_stringsПозволяет разбирать JSON‑массивы как строки во входных форматах JSON.true
input_format_json_read_objects_as_stringsПозволяет разбирать JSON-объекты как строки во входных форматах JSON.true
input_format_json_named_tuples_as_objectsИнтерпретировать столбцы типа NamedTuple как объекты JSON.true
input_format_json_try_infer_numbers_from_stringsПри выводе схемы пытаться распознавать числовые значения в строковых полях.false
input_format_json_try_infer_named_tuples_from_objectsПытаться выводить тип NamedTuple из объектов JSON при выводе схемы.true
input_format_json_infer_incomplete_types_as_stringsИспользуйте тип String для ключей, которые при выводе схемы в форматах ввода JSON содержат только значения Null или пустые объекты/массивы.true
input_format_json_defaults_for_missing_elements_in_named_tupleВставлять значения по умолчанию для отсутствующих полей JSON-объекта при разборе именованного кортежа.true
input_format_json_ignore_unknown_keys_in_named_tupleИгнорировать неизвестные ключи JSON-объекта для именованных кортежей.false
input_format_json_compact_allow_variable_number_of_columnsРазрешить переменное количество столбцов в формате JSONCompact/JSONCompactEachRow, игнорировать лишние столбцы и использовать значения по умолчанию для отсутствующих столбцов.false
input_format_json_throw_on_bad_escape_sequenceВыбрасывать исключение, если строка JSON содержит некорректную escape-последовательность. Если опция отключена, некорректные escape-последовательности останутся в данных без изменений.true
input_format_json_empty_as_defaultСчитать пустые поля во входных данных JSON значениями по умолчанию.falseДля сложных выражений по умолчанию необходимо также включить настройку input_format_defaults_for_omitted_fields.
output_format_json_quote_64bit_integersОпределяет, заключать ли 64-битные целые числа в кавычки в формате вывода JSON.true
output_format_json_quote_64bit_floatsУправляет заключением 64-битных чисел с плавающей запятой в кавычки в выходном формате JSON.false
output_format_json_quote_denormalsВключает вывод '+nan', '-nan', '+inf', '-inf' в формате JSON.false
output_format_json_quote_decimalsУправляет заключением значений типа Decimal в кавычки при выводе в формате JSON.false
output_format_json_escape_forward_slashesОпределяет, нужно ли экранировать прямые слэши в строковых значениях в JSON-формате.true
output_format_json_named_tuples_as_objectsСериализовать столбцы именованных кортежей как объекты JSON.true
output_format_json_array_of_rowsВыведите JSON-массив со всеми строками в формате JSONEachRow(Compact).false
output_format_json_validate_utf8Включает проверку корректности последовательностей UTF-8 в выходных форматах JSONfalseОбратите внимание, что это не влияет на форматы JSON/JSONCompact/JSONColumnsWithMetadata — в них всегда выполняется проверка UTF-8.