| 输入 | 输出 | 别名 |
|---|---|---|
| ✔ | ✔ |
描述
BSONEachRow 格式会将数据解析为一系列彼此之间没有任何分隔符的二进制 JSON (BSON) 文档。
每一行会被格式化为一个单独的文档，而每一列会被格式化为 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 类型 |
|---|---|
\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 |
int32 值作为 UInt8 插入 ClickHouse。
Int128/UInt128/Int256/UInt256/Decimal128/Decimal256 等大整数和 Decimal，可从二进制子类型为 \x00 的 BSON Binary 值中解析。
在这种情况下，该格式会验证二进制数据的大小是否与预期值的大小一致。
此格式在 Big-Endian 平台上无法正常工作。
示例用法
插入数据
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
BSON 是一种二进制格式，无法在终端中以人类可读的形式显示。请使用
INTO OUTFILE 将其输出为 BSON 文件。格式设置
| 设置 | 描述 | 默认值 |
|---|---|---|
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 |