BSONEachRow

Documentação do formato BSONEachRow

Entrada	Saída	Alias
✔	✔

​

Descrição

O formato BSONEachRow interpreta os dados como uma sequência de documentos Binary JSON (BSON), sem nenhum separador entre eles. Cada linha é formatada como um único documento, e cada coluna é formatada como um único campo do documento BSON, com o nome da coluna como chave.

​

Correspondência entre tipos de dados

Para a saída, é usada a seguinte correspondência entre os tipos ClickHouse e os tipos BSON:

Tipo ClickHouse	Tipo 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 subtipo binário, tamanho = 16
Decimal256	\x05 binary, \x00 subtipo binário, tamanho = 32
Int128/UInt128	\x05 binary, \x00 subtipo binário, tamanho = 16
Int256/UInt256	\x05 binary, \x00 subtipo binário, tamanho = 32
String/FixedString	\x05 binary, \x00 subtipo binário ou \x02 string se a configuração output_format_bson_string_as_string estiver ativada
UUID	\x05 binary, \x04 uuid subtipo binário, tamanho = 16
Array	\x04 array
Tuple	\x04 array
Named Tuple	\x03 documento
Map	\x03 documento
IPv4	\x10 int32
IPv6	\x05 binary, \x00 subtipo binário

Para a entrada, é usada a seguinte correspondência entre os tipos BSON e os tipos ClickHouse:

Tipo BSON	Tipo do ClickHouse
\x01 double	Float32/Float64
\x02 string	String/FixedString
\x03 documento	Map/Named Tuple
\x04 array	Array/Tuple
\x05 binário, subtipo binário \x00	String/FixedString/IPv6
\x05 binário, subtipo binário antigo \x02	String/FixedString
\x05 binário, subtipo UUID antigo \x03	UUID
\x05 binário, subtipo UUID \x04	UUID
\x07 ObjectId	String/FixedString
\x08 boolean	Bool
\x09 datetime	DateTime64
\x0A valor NULL	NULL
\x0D código JavaScript	String/FixedString
\x0E símbolo	String/FixedString
\x10 int32	Int32/UInt32/Decimal32/IPv4/Enum8/Enum16
\x12 int64	Int64/UInt64/Decimal64/DateTime64

Outros tipos BSON não são suportados. Além disso, o formato faz conversão entre diferentes tipos inteiros. Por exemplo, é possível inserir um valor BSON int32 no ClickHouse como UInt8.

Inteiros grandes e decimais, como Int128/UInt128/Int256/UInt256/Decimal128/Decimal256, podem ser convertidos de um valor BSON do tipo Binary com o subtipo binário \x00. Nesse caso, o formato valida se o tamanho dos dados binários é igual ao tamanho do valor esperado.

Este formato não funciona corretamente em plataformas Big-Endian.

​

Exemplo de uso

​

Inserção de dados

Usando um arquivo BSON com os dados a seguir, chamado football.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 │
    └────────────┴────────┴───────────────────────┴─────────────────────┴─────────────────┴─────────────────┘

Insira os dados:

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

​

Leitura de dados

Leia os dados usando o formato BSONEachRow:

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

BSON é um formato binário que não é exibido no terminal em um formato legível por humanos. Use INTO OUTFILE para gerar arquivos BSON.

​

Configurações de formato

Configuração	Descrição	Padrão
output_format_bson_string_as_string	Usa o tipo String do BSON em vez de Binary para colunas String.	false
input_format_bson_skip_fields_with_unsupported_types_in_schema_inference	Permite ignorar colunas com tipos não compatíveis durante a inferência de esquema do formato BSONEachRow.	false