> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Documentação do formato MsgPack

# MsgPack

| Entrada | Saída | Alias |
| ------- | ----- | ----- |
| ✔       | ✔     |       |

<div id="description">
  ## Descrição
</div>

O ClickHouse oferece suporte à leitura e à gravação de arquivos de dados [MessagePack](https://msgpack.org/).

<div id="data-types-matching">
  ## Correspondência entre tipos de dados
</div>

| Tipo de dado do MessagePack (`INSERT`)                             | Tipo de dado do ClickHouse                                                                | Tipo de dado do MessagePack (`SELECT`) |
| ------------------------------------------------------------------ | ----------------------------------------------------------------------------------------- | -------------------------------------- |
| `uint N`, `positive fixint`                                        | [`UIntN`](/pt-BR/reference/data-types/int-uint)                                           | `uint N`                               |
| `int N`, `negative fixint`                                         | [`IntN`](/pt-BR/reference/data-types/int-uint)                                            | `int N`                                |
| `bool`                                                             | [`UInt8`](/pt-BR/reference/data-types/int-uint)                                           | `uint 8`                               |
| `fixstr`, `str 8`, `str 16`, `str 32`, `bin 8`, `bin 16`, `bin 32` | [`String`](/pt-BR/reference/data-types/string)                                            | `bin 8`, `bin 16`, `bin 32`            |
| `fixstr`, `str 8`, `str 16`, `str 32`, `bin 8`, `bin 16`, `bin 32` | [`FixedString`](/pt-BR/reference/data-types/fixedstring)                                  | `bin 8`, `bin 16`, `bin 32`            |
| `float 32`                                                         | [`Float32`](/pt-BR/reference/data-types/float)                                            | `float 32`                             |
| `float 64`                                                         | [`Float64`](/pt-BR/reference/data-types/float)                                            | `float 64`                             |
| `uint 16`                                                          | [`Date`](/pt-BR/reference/data-types/date)                                                | `uint 16`                              |
| `int 32`                                                           | [`Date32`](/pt-BR/reference/data-types/date32)                                            | `int 32`                               |
| `uint 32`                                                          | [`DateTime`](/pt-BR/reference/data-types/datetime)                                        | `uint 32`                              |
| `uint 64`                                                          | [`DateTime64`](/pt-BR/reference/data-types/datetime)                                      | `uint 64`                              |
| `fixarray`, `array 16`, `array 32`                                 | [`Array`](/pt-BR/reference/data-types/array)/[`Tuple`](/pt-BR/reference/data-types/tuple) | `fixarray`, `array 16`, `array 32`     |
| `fixmap`, `map 16`, `map 32`                                       | [`Map`](/pt-BR/reference/data-types/map)                                                  | `fixmap`, `map 16`, `map 32`           |
| `uint 32`                                                          | [`IPv4`](/pt-BR/reference/data-types/ipv4)                                                | `uint 32`                              |
| `bin 8`                                                            | [`String`](/pt-BR/reference/data-types/string)                                            | `bin 8`                                |
| `int 8`                                                            | [`Enum8`](/pt-BR/reference/data-types/enum)                                               | `int 8`                                |
| `bin 8`                                                            | [`(U)Int128`/`(U)Int256`](/pt-BR/reference/data-types/int-uint)                           | `bin 8`                                |
| `int 32`                                                           | [`Decimal32`](/pt-BR/reference/data-types/decimal)                                        | `int 32`                               |
| `int 64`                                                           | [`Decimal64`](/pt-BR/reference/data-types/decimal)                                        | `int 64`                               |
| `bin 8`                                                            | [`Decimal128`/`Decimal256`](/pt-BR/reference/data-types/decimal)                          | `bin 8 `                               |

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

Escrevendo em um arquivo ".msgpk":

```sql theme={null}
$ clickhouse-client --query="CREATE TABLE msgpack (array Array(UInt8)) ENGINE = Memory;"
$ clickhouse-client --query="INSERT INTO msgpack VALUES ([0, 1, 2, 3, 42, 253, 254, 255]), ([255, 254, 253, 42, 3, 2, 1, 0])";
$ clickhouse-client --query="SELECT * FROM msgpack FORMAT MsgPack" > tmp_msgpack.msgpk;
```

<div id="format-settings">
  ## Configurações de formato
</div>

| Configuração                                                                                                               | Descrição                                                                                                        | Padrão |
| -------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------- | ------ |
| [`input_format_msgpack_number_of_columns`](/pt-BR/reference/settings/formats#input_format_msgpack_number_of_columns)       | o número de colunas nos dados MsgPack inseridos. Usado para inferência automática de esquema com base nos dados. | `0`    |
| [`output_format_msgpack_uuid_representation`](/pt-BR/reference/settings/formats#output_format_msgpack_uuid_representation) | a forma de representar UUID na saída em formato MsgPack.                                                         | `EXT`  |
