跳到主要内容
跳到主要内容

JSONObjectEachRow

输入输出别名

描述

在此格式中,所有数据以单个 JSON 对象表示,每行作为该对象的单独字段,类似于 JSONEachRow 格式。

示例用法

基本示例

给定一些 JSON:

要使用对象名称作为列值,您可以使用特殊设置 format_json_object_each_row_column_for_object_name。 该设置的值为一个列名,用作结果对象中一行的 JSON 键。

输出

假设我们有一个名为 test 的表,包含两列:

让我们以 JSONObjectEachRow 格式输出,并使用 format_json_object_each_row_column_for_object_name 设置:

输入

假设我们将上一个示例的输出存储在名为 data.json 的文件中:

这对于模式推断也有效:

插入数据

ClickHouse 允许:

  • 对象中的键值对可以任意顺序。
  • 省略某些值。

ClickHouse 忽略元素之间的空格以及对象之后的逗号。您可以将所有对象放在一行中,不必用换行符分隔它们。

省略值处理

ClickHouse 用相应 数据类型 的默认值替代省略的值。

如果指定了 DEFAULT expr,ClickHouse 将根据 input_format_defaults_for_omitted_fields 设置使用不同的替代规则。

考虑以下表:

  • 如果 input_format_defaults_for_omitted_fields = 0,则 xa 的默认值等于 0(因为 UInt32 数据类型的默认值)。
  • 如果 input_format_defaults_for_omitted_fields = 1,则 x 的默认值等于 0,但 a 的默认值等于 x * 2
备注

input_format_defaults_for_omitted_fields = 1 时插入数据,ClickHouse 会比在 input_format_defaults_for_omitted_fields = 0 时消耗更多计算资源。

选择数据

UserActivity 表为例:

查询 SELECT * FROM UserActivity FORMAT JSONEachRow 返回:

JSON 格式不同,不会替换无效的 UTF-8 序列。值的转义方式与 JSON 相同。

信息

任何字节集都可以在字符串中输出。如果您确定表中的数据可以格式化为 JSON 而没有丢失任何信息,则使用 JSONEachRow 格式。

使用嵌套结构

如果您有一个带有 Nested 数据类型列的表,您可以插入具有相同结构的 JSON 数据。使用 input_format_import_nested_json 设置启用此功能。

例如,考虑以下表:

正如您在 Nested 数据类型描述中所看到的,ClickHouse 将嵌套结构的每个组件视为单独的列(我们的表中的 n.sn.i)。您可以以以下方式插入数据:

要将数据作为层次 JSON 对象插入,请设置 input_format_import_nested_json=1

如果没有此设置,ClickHouse 会抛出异常。

格式设置

设置描述默认值备注
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将命名元组列解析为 JSON 对象。true
input_format_json_try_infer_numbers_from_strings尝试在模式推断期间从字符串字段推断数字。false
input_format_json_try_infer_named_tuples_from_objects尝试在模式推断期间从 JSON 对象推断命名元组。true
input_format_json_infer_incomplete_types_as_strings在 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 字符串包含错误的转义序列,则抛出异常。如果禁用,错误的转义序列将保持原样。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 序列的验证(请注意,这不影响格式 JSON/JSONCompact/JSONColumnsWithMetadata,它们始终验证 utf8)。false