> ## 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.

> Документация по формату BSONEachRow

# BSONEachRow

| Ввод | Вывод | Псевдоним |
| ---- | ----- | --------- |
| ✔    | ✔     |           |

<div id="description">
  ## Описание
</div>

Формат `BSONEachRow` разбирает данные как последовательность документов Binary JSON (BSON) без каких-либо разделителей между ними.
Каждая строка представляется в виде отдельного документа, а каждый столбец — в виде отдельного поля BSON-документа, где ключом служит имя столбца.

<div id="data-types-matching">
  ## Соответствие типов данных
</div>

При выводе используется следующее соответствие между типами ClickHouse и типами BSON:

| Тип ClickHouse                                                                                | Тип BSON                                                                                                               |
| --------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| [Bool](/ru/reference/data-types/boolean)                                                      | `\x08` boolean                                                                                                         |
| [Int8/UInt8](/ru/reference/data-types/int-uint)/[Enum8](/ru/reference/data-types/enum)        | `\x10` int32                                                                                                           |
| [Int16/UInt16](/ru/reference/data-types/int-uint)/[Enum16](/ru/reference/data-types/enum)     | `\x10` int32                                                                                                           |
| [Int32](/ru/reference/data-types/int-uint)                                                    | `\x10` int32                                                                                                           |
| [UInt32](/ru/reference/data-types/int-uint)                                                   | `\x12` int64                                                                                                           |
| [Int64/UInt64](/ru/reference/data-types/int-uint)                                             | `\x12` int64                                                                                                           |
| [Float32/Float64](/ru/reference/data-types/float)                                             | `\x01` double                                                                                                          |
| [Date](/ru/reference/data-types/date)/[Date32](/ru/reference/data-types/date32)               | `\x10` int32                                                                                                           |
| [DateTime](/ru/reference/data-types/datetime)                                                 | `\x12` int64                                                                                                           |
| [DateTime64](/ru/reference/data-types/datetime64)                                             | `\x09` datetime                                                                                                        |
| [Decimal32](/ru/reference/data-types/decimal)                                                 | `\x10` int32                                                                                                           |
| [Decimal64](/ru/reference/data-types/decimal)                                                 | `\x12` int64                                                                                                           |
| [Decimal128](/ru/reference/data-types/decimal)                                                | `\x05` binary, `\x00` binary subtype, size = 16                                                                        |
| [Decimal256](/ru/reference/data-types/decimal)                                                | `\x05` binary, `\x00` binary subtype, size = 32                                                                        |
| [Int128/UInt128](/ru/reference/data-types/int-uint)                                           | `\x05` binary, `\x00` binary subtype, size = 16                                                                        |
| [Int256/UInt256](/ru/reference/data-types/int-uint)                                           | `\x05` binary, `\x00` binary subtype, size = 32                                                                        |
| [String](/ru/reference/data-types/string)/[FixedString](/ru/reference/data-types/fixedstring) | `\x05` binary, `\x00` binary subtype или `\x02` string, если включен параметр output\_format\_bson\_string\_as\_string |
| [UUID](/ru/reference/data-types/uuid)                                                         | `\x05` binary, `\x04` uuid subtype, size = 16                                                                          |
| [Array](/ru/reference/data-types/array)                                                       | `\x04` array                                                                                                           |
| [Tuple](/ru/reference/data-types/tuple)                                                       | `\x04` array                                                                                                           |
| [Named Tuple](/ru/reference/data-types/tuple)                                                 | `\x03` document                                                                                                        |
| [Map](/ru/reference/data-types/map)                                                           | `\x03` document                                                                                                        |
| [IPv4](/ru/reference/data-types/ipv4)                                                         | `\x10` int32                                                                                                           |
| [IPv6](/ru/reference/data-types/ipv6)                                                         | `\x05` binary, `\x00` binary subtype                                                                                   |

При вводе используется следующее соответствие между типами BSON и типами ClickHouse:

| Тип BSON                                 | Тип ClickHouse                                                                                                                                                                      |
| ---------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `\x01` double                            | [Float32/Float64](/ru/reference/data-types/float)                                                                                                                                   |
| `\x02` string                            | [String](/ru/reference/data-types/string)/[FixedString](/ru/reference/data-types/fixedstring)                                                                                       |
| `\x03` document                          | [Map](/ru/reference/data-types/map)/[Named Tuple](/ru/reference/data-types/tuple)                                                                                                   |
| `\x04` array                             | [Array](/ru/reference/data-types/array)/[Tuple](/ru/reference/data-types/tuple)                                                                                                     |
| `\x05` binary, `\x00` binary subtype     | [String](/ru/reference/data-types/string)/[FixedString](/ru/reference/data-types/fixedstring)/[IPv6](/ru/reference/data-types/ipv6)                                                 |
| `\x05` binary, `\x02` old binary subtype | [String](/ru/reference/data-types/string)/[FixedString](/ru/reference/data-types/fixedstring)                                                                                       |
| `\x05` binary, `\x03` old uuid subtype   | [UUID](/ru/reference/data-types/uuid)                                                                                                                                               |
| `\x05` binary, `\x04` uuid subtype       | [UUID](/ru/reference/data-types/uuid)                                                                                                                                               |
| `\x07` ObjectId                          | [String](/ru/reference/data-types/string)/[FixedString](/ru/reference/data-types/fixedstring)                                                                                       |
| `\x08` boolean                           | [Bool](/ru/reference/data-types/boolean)                                                                                                                                            |
| `\x09` datetime                          | [DateTime64](/ru/reference/data-types/datetime64)                                                                                                                                   |
| `\x0A` null value                        | [NULL](/ru/reference/data-types/nullable)                                                                                                                                           |
| `\x0D` JavaScript code                   | [String](/ru/reference/data-types/string)/[FixedString](/ru/reference/data-types/fixedstring)                                                                                       |
| `\x0E` symbol                            | [String](/ru/reference/data-types/string)/[FixedString](/ru/reference/data-types/fixedstring)                                                                                       |
| `\x10` int32                             | [Int32/UInt32](/ru/reference/data-types/int-uint)/[Decimal32](/ru/reference/data-types/decimal)/[IPv4](/ru/reference/data-types/ipv4)/[Enum8/Enum16](/ru/reference/data-types/enum) |
| `\x12` int64                             | [Int64/UInt64](/ru/reference/data-types/int-uint)/[Decimal64](/ru/reference/data-types/decimal)/[DateTime64](/ru/reference/data-types/datetime64)                                   |

Другие типы BSON не поддерживаются. Кроме того, формат выполняет преобразование между различными целочисленными типами.
Например, значение BSON `int32` можно вставить в ClickHouse как [`UInt8`](/ru/reference/data-types/int-uint).

Большие целые числа и десятичные значения, такие как `Int128`/`UInt128`/`Int256`/`UInt256`/`Decimal128`/`Decimal256`, можно разобрать из значения BSON Binary с бинарным подтипом `\x00`.
В этом случае формат проверяет, что размер бинарных данных соответствует размеру ожидаемого значения.

<Note>
  Этот формат не работает должным образом на платформах Big-Endian.
</Note>

<div id="example-usage">
  ## Пример использования
</div>

<div id="inserting-data">
  ### Вставка данных
</div>

Используя BSON-файл `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 │
    └────────────┴────────┴───────────────────────┴─────────────────────┴─────────────────┴─────────────────┘
```

Вставьте данные:

```sql theme={null}
INSERT INTO football FROM INFILE 'football.bson' FORMAT BSONEachRow;
```

<div id="reading-data">
  ### Чтение данных
</div>

Читайте данные в формате `BSONEachRow`:

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

<Tip>
  BSON — это бинарный формат, который не отображается в терминале в человекочитаемом виде. Используйте `INTO OUTFILE` для вывода файлов BSON.
</Tip>

<div id="format-settings">
  ## Настройки формата
</div>

| Настройка                                                                                                                                                                             | Описание                                                                                                              | По умолчанию |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- | ------------ |
| [`output_format_bson_string_as_string`](/ru/reference/settings/formats#output_format_bson_string_as_string)                                                                           | Использовать тип BSON String вместо Binary для столбцов типа String.                                                  | `false`      |
| [`input_format_bson_skip_fields_with_unsupported_types_in_schema_inference`](/ru/reference/settings/formats#input_format_bson_skip_fields_with_unsupported_types_in_schema_inference) | Разрешить пропускать столбцы с неподдерживаемыми типами при автоматическом определении схемы для формата BSONEachRow. | `false`      |