Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

BSONEachRow

View as MarkdownEdit this pageReport an issueSet up docs MCP
输入 输出 别名
✔ ✔

描述

BSONEachRow 格式会将数据解析为一系列彼此之间没有任何分隔符的二进制 JSON (BSON) 文档。 每一行会被格式化为一个单独的文档，而每一列会被格式化为 BSON 文档中的一个独立字段，并以列名作为键。

数据类型匹配

对于输出，使用以下 ClickHouse 类型与 BSON 类型之间的对应关系：

ClickHouse 类型 BSON 类型
Bool \x08 boolean
Int8/UInt8/Enum8 \x10 int32
Int16/UInt16/Enum16 \x10 int32
Int32 \x10 int32
UInt32 \x12 int64
Int64/UInt64 \x12 int64
Float32/Float64 \x01 double
Date/Date32 \x10 int32
DateTime \x12 int64
DateTime64 \x09 datetime
Decimal32 \x10 int32
Decimal64 \x12 int64
Decimal128 \x05 binary, \x00 二进制子类型, size = 16
Decimal256 \x05 binary, \x00 二进制子类型, size = 32
Int128/UInt128 \x05 binary, \x00 二进制子类型, size = 16
Int256/UInt256 \x05 binary, \x00 二进制子类型, size = 32
String/FixedString \x05 binary、\x00 二进制子类型；如果启用了 output_format_bson_string_as_string 设置，则为 \x02 string
UUID \x05 binary, \x04 uuid subtype, size = 16
Array \x04 数组
Tuple \x04 数组
命名元组 \x03 文档
Map \x03 文档
IPv4 \x10 int32
IPv6 \x05 binary, \x00 二进制子类型

对于输入，使用以下 BSON 类型与 ClickHouse 类型之间的对应关系：

BSON 类型 ClickHouse 类型
\x01 double Float32/Float64
\x02 string String/FixedString
\x03 文档 Map/命名元组
\x04 数组 Array/Tuple
\x05 binary, \x00 二进制子类型 String/FixedString/IPv6
\x05 binary, \x02 旧二进制子类型 String/FixedString
\x05 binary, \x03 旧 UUID 子类型 UUID
\x05 binary, \x04 UUID 子类型 UUID
\x07 ObjectId String/FixedString
\x08 boolean Bool
\x09 datetime DateTime64
\x0A NULL 值 NULL
\x0D JavaScript 代码 String/FixedString
\x0E symbol String/FixedString
\x10 int32 Int32/UInt32/Decimal32/IPv4/Enum8/Enum16
\x12 int64 Int64/UInt64/Decimal64/DateTime64

不支持其他 BSON 类型。此外，它还会在不同整数类型之间进行转换。 例如，可以将 BSON int32 值作为 UInt8 插入 ClickHouse。

Int128/UInt128/Int256/UInt256/Decimal128/Decimal256 等大整数和 Decimal，可从二进制子类型为 \x00 的 BSON Binary 值中解析。 在这种情况下，该格式会验证二进制数据的大小是否与预期值的大小一致。

示例用法

插入数据

使用一个名为 football.bson、包含以下数据的 BSON 文件：

    ┌───────date─┬─season─┬─home_team─────────────┬─away_team───────────┬─home_team_goals─┬─away_team_goals─┐
 1. │ 2022-04-30 │   2021 │ Sutton United         │ Bradford City       │               1 │               4 │
 2. │ 2022-04-30 │   2021 │ Swindon Town          │ Barrow              │               2 │               1 │
 3. │ 2022-04-30 │   2021 │ Tranmere Rovers       │ Oldham Athletic     │               2 │               0 │
 4. │ 2022-05-02 │   2021 │ Port Vale             │ Newport County      │               1 │               2 │
 5. │ 2022-05-02 │   2021 │ Salford City          │ Mansfield Town      │               2 │               2 │
 6. │ 2022-05-07 │   2021 │ Barrow                │ Northampton Town    │               1 │               3 │
 7. │ 2022-05-07 │   2021 │ Bradford City         │ Carlisle United     │               2 │               0 │
 8. │ 2022-05-07 │   2021 │ Bristol Rovers        │ Scunthorpe United   │               7 │               0 │
 9. │ 2022-05-07 │   2021 │ Exeter City           │ Port Vale           │               0 │               1 │
10. │ 2022-05-07 │   2021 │ Harrogate Town A.F.C. │ Sutton United       │               0 │               2 │
11. │ 2022-05-07 │   2021 │ Hartlepool United     │ Colchester United   │               0 │               2 │
12. │ 2022-05-07 │   2021 │ Leyton Orient         │ Tranmere Rovers     │               0 │               1 │
13. │ 2022-05-07 │   2021 │ Mansfield Town        │ Forest Green Rovers │               2 │               2 │
14. │ 2022-05-07 │   2021 │ Newport County        │ Rochdale            │               0 │               2 │
15. │ 2022-05-07 │   2021 │ Oldham Athletic       │ Crawley Town        │               3 │               3 │
16. │ 2022-05-07 │   2021 │ Stevenage Borough     │ Salford City        │               4 │               2 │
17. │ 2022-05-07 │   2021 │ Walsall               │ Swindon Town        │               0 │               3 │
    └────────────┴────────┴───────────────────────┴─────────────────────┴─────────────────┴─────────────────┘

插入数据：

INSERT INTO football FROM INFILE 'football.bson' FORMAT BSONEachRow;

读取数据

使用 BSONEachRow 格式读取数据：

SELECT *
FROM football INTO OUTFILE 'docs_data/bson/football.bson'
FORMAT BSONEachRow

格式设置

设置 描述 默认值
output_format_bson_string_as_string 对 String 列使用 BSON String 类型，而不是 Binary。 false
input_format_bson_skip_fields_with_unsupported_types_in_schema_inference 在对 BSONEachRow 格式进行 schema 推断时，允许跳过类型不受支持的列。 false
Navigation