跳转到主要内容
本页列出了所有 JSON 格式通用的格式设置。
设置项说明默认值备注
input_format_import_nested_json将嵌套的 JSON 数据映射到嵌套表中 (适用于 JSONEachRow 格式) 。false
input_format_json_read_bools_as_numbers允许在 JSON 输入格式中将 Bool 解析为数值。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将命名元组列解析为 JSON 对象。true
input_format_json_try_infer_numbers_from_strings在进行 schema 推断时,尝试从 String 字段中推断数值。false
input_format_json_try_infer_named_tuples_from_objects在进行 schema 推断时,尝试从 JSON 对象中推断命名元组。true
input_format_json_infer_incomplete_types_as_strings在 JSON input formats 中进行 schema inference 时,对于仅包含 NULL 或空对象/数组的键,使用 String 类型。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 字符串包含错误的转义序列,则抛出异常。若禁用此项,错误的转义序列将在数据中保留原样。true
input_format_json_empty_as_default将 JSON 输入中的空字段按默认值处理。false对于复杂的默认表达式,还必须同时启用 input_format_defaults_for_omitted_fields
output_format_json_quote_64bit_integers控制 JSON 输出格式中的 64 位整数是否加引号。true
output_format_json_quote_64bit_floats控制 JSON 输出格式中的 64 位浮点数是否加引号。false
output_format_json_quote_denormals启用在 JSON 输出格式中输出 ‘+nan’、‘-nan’、‘+inf’、‘-inf’。false
output_format_json_quote_decimals控制在 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以 JSONEachRow(Compact) 格式输出由所有行组成的 JSON 数组。false
output_format_json_validate_utf8启用对 JSON 输出格式中 UTF-8 序列的验证。false请注意,这不会影响 JSON/JSONCompact/JSONColumnsWithMetadata 格式,它们始终会校验 UTF-8。
最后修改于 2026年6月10日