> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-parallel-read-in-order-multi-part.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Documentación del formato BSONEachRow

# BSONEachRow

| Entrada | Salida | Alias |
| - | - | - |
| ✔ | ✔ | |

<div id="description">
  ## Descripción
</div>

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.

<div id="data-types-matching">
  ## Correspondencia de tipos de datos
</div>

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.

<Note>
  Este formato no funciona correctamente en plataformas Big-Endian.
</Note>

<div id="example-usage">
  ## Ejemplo de uso
</div>

<div id="inserting-data">
  ### Inserción de datos
</div>

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;
```

<div id="reading-data">
  ### Lectura de datos
</div>

Lea datos con el formato `BSONEachRow`:

```sql theme={null}
SELECT *
FROM football INTO OUTFILE 'docs_data/bson/football.bson'
FORMAT BSONEachRow
```

<Tip>
  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.
</Tip>

<div id="format-settings">
  ## Configuración del formato
</div>

| Configuración | Descripción | Predeterminado |
| - | - | - |
| [`output_format_bson_string_as_string`](/es/reference/settings/formats/output-format#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#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` |