> ## 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. > Documentación del formato BSONEachRow # BSONEachRow | Entrada | Salida | Alias | | ------- | ------ | ----- | | ✔ | ✔ | |
## Descripción
El formato `BSONEachRow` interpreta los datos como una secuencia de documentos Binary JSON (BSON) sin ningún separador entre ellos. Cada fila se representa como un único documento y cada columna como un único campo de documento BSON, con el nombre de la columna como clave.
## Correspondencia de tipos de datos
Para la salida, se utiliza la siguiente correspondencia entre los tipos de ClickHouse y los tipos BSON: | Tipo de ClickHouse | Tipo BSON | | --------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- | | [Bool](/es/reference/data-types/boolean) | `\x08` boolean | | [Int8/UInt8](/es/reference/data-types/int-uint)/[Enum8](/es/reference/data-types/enum) | `\x10` int32 | | [Int16/UInt16](/es/reference/data-types/int-uint)/[Enum16](/es/reference/data-types/enum) | `\x10` int32 | | [Int32](/es/reference/data-types/int-uint) | `\x10` int32 | | [UInt32](/es/reference/data-types/int-uint) | `\x12` int64 | | [Int64/UInt64](/es/reference/data-types/int-uint) | `\x12` int64 | | [Float32/Float64](/es/reference/data-types/float) | `\x01` double | | [Date](/es/reference/data-types/date)/[Date32](/es/reference/data-types/date32) | `\x10` int32 | | [DateTime](/es/reference/data-types/datetime) | `\x12` int64 | | [DateTime64](/es/reference/data-types/datetime64) | `\x09` datetime | | [Decimal32](/es/reference/data-types/decimal) | `\x10` int32 | | [Decimal64](/es/reference/data-types/decimal) | `\x12` int64 | | [Decimal128](/es/reference/data-types/decimal) | `\x05` binary, `\x00` binary subtype, tamaño = 16 | | [Decimal256](/es/reference/data-types/decimal) | `\x05` binary, `\x00` binary subtype, tamaño = 32 | | [Int128/UInt128](/es/reference/data-types/int-uint) | `\x05` binary, `\x00` binary subtype, tamaño = 16 | | [Int256/UInt256](/es/reference/data-types/int-uint) | `\x05` binary, `\x00` binary subtype, tamaño = 32 | | [String](/es/reference/data-types/string)/[FixedString](/es/reference/data-types/fixedstring) | `\x05` binary, `\x00` binary subtype o \x02 string si la configuración output\_format\_bson\_string\_as\_string está habilitada | | [UUID](/es/reference/data-types/uuid) | `\x05` binary, `\x04` uuid subtype, tamaño = 16 | | [Array](/es/reference/data-types/array) | `\x04` array | | [Tuple](/es/reference/data-types/tuple) | `\x04` array | | [Named Tuple](/es/reference/data-types/tuple) | `\x03` document | | [Map](/es/reference/data-types/map) | `\x03` document | | [IPv4](/es/reference/data-types/ipv4) | `\x10` int32 | | [IPv6](/es/reference/data-types/ipv6) | `\x05` binary, `\x00` binary subtype | Para la entrada, se utiliza la siguiente correspondencia entre los tipos BSON y los tipos de ClickHouse: | Tipo BSON | Tipo de ClickHouse | | ---------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `\x01` doble | [Float32/Float64](/es/reference/data-types/float) | | `\x02` string | [String](/es/reference/data-types/string)/[FixedString](/es/reference/data-types/fixedstring) | | `\x03` documento | [Map](/es/reference/data-types/map)/[Tupla con nombre](/es/reference/data-types/tuple) | | `\x04` array | [Array](/es/reference/data-types/array)/[Tuple](/es/reference/data-types/tuple) | | `\x05` binario, subtipo binario `\x00` | [String](/es/reference/data-types/string)/[FixedString](/es/reference/data-types/fixedstring)/[IPv6](/es/reference/data-types/ipv6) | | `\x05` binario, subtipo binario antiguo `\x02` | [String](/es/reference/data-types/string)/[FixedString](/es/reference/data-types/fixedstring) | | `\x05` binario, subtipo uuid antiguo `\x03` | [UUID](/es/reference/data-types/uuid) | | `\x05` binario, subtipo uuid `\x04` | [UUID](/es/reference/data-types/uuid) | | `\x07` ObjectId | [String](/es/reference/data-types/string)/[FixedString](/es/reference/data-types/fixedstring) | | `\x08` boolean | [Bool](/es/reference/data-types/boolean) | | `\x09` datetime | [DateTime64](/es/reference/data-types/datetime64) | | `\x0A` valor NULL | [NULL](/es/reference/data-types/nullable) | | `\x0D` código JavaScript | [String](/es/reference/data-types/string)/[FixedString](/es/reference/data-types/fixedstring) | | `\x0E` símbolo | [String](/es/reference/data-types/string)/[FixedString](/es/reference/data-types/fixedstring) | | `\x10` int32 | [Int32/UInt32](/es/reference/data-types/int-uint)/[Decimal32](/es/reference/data-types/decimal)/[IPv4](/es/reference/data-types/ipv4)/[Enum8/Enum16](/es/reference/data-types/enum) | | `\x12` int64 | [Int64/UInt64](/es/reference/data-types/int-uint)/[Decimal64](/es/reference/data-types/decimal)/[DateTime64](/es/reference/data-types/datetime64) | No se admiten otros tipos BSON. Además, realiza conversiones entre distintos tipos enteros. Por ejemplo, es posible insertar un valor BSON `int32` en ClickHouse como [`UInt8`](/es/reference/data-types/int-uint). Los enteros grandes y decimales, como `Int128`/`UInt128`/`Int256`/`UInt256`/`Decimal128`/`Decimal256`, se pueden analizar a partir de un valor BSON Binary con el subtipo binario `\x00`. En este caso, el formato validará que el tamaño de los datos binarios coincida con el tamaño del valor esperado. Este formato no funciona correctamente en plataformas Big-Endian.
## Ejemplo de uso
### Inserción de datos
Utiliza un archivo BSON con los siguientes datos, llamado `football.bson`: ```text theme={null} ┌───────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 │ └────────────┴────────┴───────────────────────┴─────────────────────┴─────────────────┴─────────────────┘ ``` Inserta los datos: ```sql theme={null} INSERT INTO football FROM INFILE 'football.bson' FORMAT BSONEachRow; ```
### Lectura de datos
Lea datos con el formato `BSONEachRow`: ```sql theme={null} SELECT * FROM football INTO OUTFILE 'docs_data/bson/football.bson' FORMAT BSONEachRow ``` BSON es un formato binario que no se puede ver en la terminal de forma legible para humanos. Use `INTO OUTFILE` para generar archivos BSON.
## Configuración del formato
| Configuración | Descripción | Predeterminado | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- | -------------- | | [`output_format_bson_string_as_string`](/es/reference/settings/formats#output_format_bson_string_as_string) | Usa el tipo String de BSON en lugar de Binary para las columnas String. | `false` | | [`input_format_bson_skip_fields_with_unsupported_types_in_schema_inference`](/es/reference/settings/formats#input_format_bson_skip_fields_with_unsupported_types_in_schema_inference) | Permite omitir columnas con tipos no compatibles durante la inferencia de esquema para el formato BSONEachRow. | `false` |