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

> Documentação do formato RowBinaryWithNamesAndTypesAndDefaults

# RowBinaryWithNamesAndTypesAndDefaults

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

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

Semelhante ao formato [`RowBinaryWithNamesAndTypes`](/pt-BR/reference/formats/RowBinary/RowBinaryWithNamesAndTypes), mas com um byte extra antes de cada célula que indica se o valor `DEFAULT` da coluna deve ser usado — exatamente como no formato [`RowBinaryWithDefaults`](/pt-BR/reference/formats/RowBinary/RowBinaryWithDefaults). Essa combinação oferece suporte a `INSERT`s com evolução de esquema: quem grava pode omitir colunas do cabeçalho (elas recebem o `DEFAULT` da coluna de destino) e, para qualquer coluna que enviar, pode marcar células individuais como "usar o `DEFAULT` da coluna" sem confundir isso com `NULL`.

Este formato é apenas de entrada.

<div id="wire-format">
  ## Formato de transmissão
</div>

O cabeçalho é idêntico ao de [`RowBinaryWithNamesAndTypes`](/pt-BR/reference/formats/RowBinary/RowBinaryWithNamesAndTypes):

1. Um `VarUInt` com o número de colunas `N`.
2. `N` `String`s prefixadas pelo comprimento com os nomes das colunas.
3. `N` tipos de coluna — nomes textuais ou codificação binária compacta, controlados pelas configurações `output_format_binary_encode_types_in_binary_format` / `input_format_binary_decode_types_in_binary_format`.

Após o cabeçalho, cada linha é composta por `N` células. Para cada célula:

* Um único byte marcador `UInt8`.
  * `0x01` — usa a expressão `DEFAULT` da coluna de destino. Nenhum byte de valor vem em seguida.
  * `0x00` — um valor vem em seguida, serializado pelo serializador `RowBinary` do tipo da coluna. Para `Nullable(T)`, os bytes do valor começam com o byte nulo de `Nullable` (`0` para não nulo, `1` para NULL) e, em seguida, vêm o valor interno, se não for nulo.

<div id="defaults-vs-null">
  ## Valores padrão vs NULL
</div>

O marcador de valor padrão por célula e o byte nulo interno de `Nullable` são independentes. Uma coluna `Nullable(UInt32) DEFAULT 42` pode ser enviada de três formas diferentes por linha:

| Bytes     | Significado                                            |
| --------- | ------------------------------------------------------ |
| `01`      | Use `DEFAULT 42`.                                      |
| `00 01`   | Caminho do valor, depois `NULL` via o tipo `Nullable`. |
| `00 00 …` | Caminho do valor, depois um valor interno não nulo.    |

<div id="schema-evolution">
  ## Evolução do esquema
</div>

| Caso                                                    | Comportamento                                                                                                                                                                          |
| ------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Coluna totalmente ausente do cabeçalho do arquivo       | Preenchida no destino via `insertDefaultsForNotSeenColumns`; condicionada por `defaults_for_omitted_fields`.                                                                           |
| Coluna presente no cabeçalho, marcador de célula `0x01` | `insertDefault` por linha.                                                                                                                                                             |
| Coluna presente no cabeçalho, marcador de célula `0x00` | O valor é processado normalmente.                                                                                                                                                      |
| Coluna extra no cabeçalho, ausente na tabela de destino | Descartada silenciosamente quando `input_format_skip_unknown_fields = 1` (o marcador é consumido primeiro; se `0x01`, nada mais; se `0x00`, o valor tipado é processado e descartado). |

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

```sql title="Query" theme={null}
SELECT * FROM format(
    'RowBinaryWithNamesAndTypesAndDefaults',
    'x Nullable(UInt32) DEFAULT 42',
    unhex('01' || '0178' || '10' || hex('Nullable(UInt32)') || '01')
);
```

```response title="Response" theme={null}
┌──x─┐
│ 42 │
└────┘
```

* O cabeçalho contém uma coluna chamada `x` do tipo `Nullable(UInt32)`.
* A única célula usa o marcador `0x01`, que significa "usar `DEFAULT 42`".

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

As configurações a seguir são comuns a todos os formatos do tipo `RowBinary`.

| Configuração                                                                                                                                | Descrição                                                                                                                                                                                                                                                                            | Padrão  |
| ------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------- |
| [`format_binary_max_string_size`](/pt-BR/reference/settings/formats#format_binary_max_string_size)                                          | O tamanho máximo permitido para String no formato RowBinary.                                                                                                                                                                                                                         | `1GiB`  |
| [`output_format_binary_encode_types_in_binary_format`](/pt-BR/reference/settings/formats#input_format_binary_decode_types_in_binary_format) | Permite escrever tipos no cabeçalho usando [`codificação binária`](/pt-BR/reference/data-types/data-types-binary-encoding), em vez de strings com nomes de tipos, no formato de saída [`RowBinaryWithNamesAndTypes`](/pt-BR/reference/formats/RowBinary/RowBinaryWithNamesAndTypes). | `false` |
| [`input_format_binary_decode_types_in_binary_format`](/pt-BR/reference/settings/formats#input_format_binary_decode_types_in_binary_format)  | Permite ler tipos no cabeçalho usando [`codificação binária`](/pt-BR/reference/data-types/data-types-binary-encoding), em vez de strings com nomes de tipos, no formato de entrada [`RowBinaryWithNamesAndTypes`](/pt-BR/reference/formats/RowBinary/RowBinaryWithNamesAndTypes).    | `false` |
| [`output_format_binary_write_json_as_string`](/pt-BR/reference/settings/formats#output_format_binary_write_json_as_string)                  | Permite escrever valores do tipo de dado [`JSON`](/pt-BR/reference/data-types/newjson) como valores `JSON` [String](/pt-BR/reference/data-types/string) no formato de saída [`RowBinary`](/pt-BR/reference/formats/RowBinary/RowBinary).                                             | `false` |
| [`input_format_binary_read_json_as_string`](/pt-BR/reference/settings/formats#input_format_binary_read_json_as_string)                      | Permite ler valores do tipo de dado [`JSON`](/pt-BR/reference/data-types/newjson) como valores `JSON` [String](/pt-BR/reference/data-types/string) no formato de entrada [`RowBinary`](/pt-BR/reference/formats/RowBinary/RowBinary).                                                | `false` |