> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-8c05c8a2.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> JSON 格式设置列表

# JSON 格式设置

本页列出了所有 JSON 格式通用的格式设置。

| 设置项                                                                                                                                                               | 说明                                                                             | 默认值     | 备注                                                                                                                                           |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ | ------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| [`input_format_import_nested_json`](/zh/reference/settings/formats#input_format_import_nested_json)                                                               | 将嵌套的 JSON 数据映射到嵌套表中 (适用于 JSONEachRow 格式) 。                                     | `false` |                                                                                                                                              |
| [`input_format_json_read_bools_as_numbers`](/zh/reference/settings/formats#input_format_json_read_bools_as_numbers)                                               | 允许在 JSON 输入格式中将 Bool 解析为数值。                                                    | `true`  |                                                                                                                                              |
| [`input_format_json_read_bools_as_strings`](/zh/reference/settings/formats#input_format_json_read_bools_as_strings)                                               | 允许在 JSON 输入格式中将布尔值作为字符串解析。                                                     | `true`  |                                                                                                                                              |
| [`input_format_json_read_numbers_as_strings`](/zh/reference/settings/formats#input_format_json_read_numbers_as_strings)                                           | 允许在 JSON 输入格式中将数值作为字符串解析。                                                      | `true`  |                                                                                                                                              |
| [`input_format_json_read_arrays_as_strings`](/zh/reference/settings/formats#input_format_json_read_arrays_as_strings)                                             | 允许在 JSON 输入格式中将 JSON 数组作为字符串解析。                                                | `true`  |                                                                                                                                              |
| [`input_format_json_read_objects_as_strings`](/zh/reference/settings/formats#input_format_json_read_objects_as_strings)                                           | 允许在 JSON 输入格式中将 JSON 对象作为字符串解析。                                                | `true`  |                                                                                                                                              |
| [`input_format_json_named_tuples_as_objects`](/zh/reference/settings/formats#input_format_json_named_tuples_as_objects)                                           | 将命名元组列解析为 JSON 对象。                                                             | `true`  |                                                                                                                                              |
| [`input_format_json_try_infer_numbers_from_strings`](/zh/reference/settings/formats#input_format_json_try_infer_numbers_from_strings)                             | 在进行 schema 推断时，尝试从 String 字段中推断数值。                                             | `false` |                                                                                                                                              |
| [`input_format_json_try_infer_named_tuples_from_objects`](/zh/reference/settings/formats#input_format_json_try_infer_named_tuples_from_objects)                   | 在进行 schema 推断时，尝试从 JSON 对象中推断命名元组。                                             | `true`  |                                                                                                                                              |
| [`input_format_json_infer_incomplete_types_as_strings`](/zh/reference/settings/formats#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`](/zh/reference/settings/formats#input_format_json_defaults_for_missing_elements_in_named_tuple) | 解析命名元组时，为 JSON 对象中缺失的元素插入默认值。                                                  | `true`  |                                                                                                                                              |
| [`input_format_json_ignore_unknown_keys_in_named_tuple`](/zh/reference/settings/formats#input_format_json_ignore_unknown_keys_in_named_tuple)                     | 在命名元组中，忽略 JSON 对象里的未知键。                                                        | `false` |                                                                                                                                              |
| [`input_format_json_compact_allow_variable_number_of_columns`](/zh/reference/settings/formats#input_format_json_compact_allow_variable_number_of_columns)         | 允许在 JSONCompact/JSONCompactEachRow 格式中使用可变数量的列，忽略多余的列，并为缺失的列使用默认值。             | `false` |                                                                                                                                              |
| [`input_format_json_throw_on_bad_escape_sequence`](/zh/reference/settings/formats#input_format_json_throw_on_bad_escape_sequence)                                 | 如果 JSON 字符串包含错误的转义序列，则抛出异常。若禁用此项，错误的转义序列将在数据中保留原样。                             | `true`  |                                                                                                                                              |
| [`input_format_json_empty_as_default`](/zh/reference/settings/formats#input_format_json_empty_as_default)                                                         | 将 JSON 输入中的空字段按默认值处理。                                                          | `false` | 对于复杂的默认表达式，还必须同时启用 [input\_format\_defaults\_for\_omitted\_fields](/zh/reference/settings/formats#input_format_defaults_for_omitted_fields)。 |
| [`output_format_json_quote_64bit_integers`](/zh/reference/settings/formats#output_format_json_quote_64bit_integers)                                               | 控制 JSON 输出格式中的 64 位整数是否加引号。                                                    | `true`  |                                                                                                                                              |
| [`output_format_json_quote_64bit_floats`](/zh/reference/settings/formats#output_format_json_quote_64bit_floats)                                                   | 控制 JSON 输出格式中的 64 位浮点数是否加引号。                                                   | `false` |                                                                                                                                              |
| [`output_format_json_quote_denormals`](/zh/reference/settings/formats#output_format_json_quote_denormals)                                                         | 启用在 JSON 输出格式中输出 '+nan'、'-nan'、'+inf'、'-inf'。                                  | `false` |                                                                                                                                              |
| [`output_format_json_quote_decimals`](/zh/reference/settings/formats#output_format_json_quote_decimals)                                                           | 控制在 JSON 输出格式中是否为十进制数加引号。                                                      | `false` |                                                                                                                                              |
| [`output_format_json_escape_forward_slashes`](/zh/reference/settings/formats#output_format_json_escape_forward_slashes)                                           | 控制在 JSON 输出格式中是否对字符串输出中的正斜杠进行转义。                                               | `true`  |                                                                                                                                              |
| [`output_format_json_named_tuples_as_objects`](/zh/reference/settings/formats#output_format_json_named_tuples_as_objects)                                         | 将命名元组列序列化为 JSON 对象。                                                            | `true`  |                                                                                                                                              |
| [`output_format_json_array_of_rows`](/zh/reference/settings/formats#output_format_json_array_of_rows)                                                             | 以 JSONEachRow(Compact) 格式输出由所有行组成的 JSON 数组。                                    | `false` |                                                                                                                                              |
| [`output_format_json_validate_utf8`](/zh/reference/settings/formats#output_format_json_validate_utf8)                                                             | 启用对 JSON 输出格式中 UTF-8 序列的验证。                                                    | `false` | 请注意，这不会影响 JSON/JSONCompact/JSONColumnsWithMetadata 格式，它们始终会校验 UTF-8。                                                                         |
