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

> Documentação sobre o formato ODBCDriver2

# ODBCDriver2

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

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

O formato `ODBCDriver2` é um formato binário somente de saída, usado para transferir resultados de consultas por HTTP para o
[driver do ClickHouse para `ODBC`](/pt-BR/concepts/features/interfaces/odbc). O driver o solicita ao definir `default_format` como
`ODBCDriver2`; normalmente, os usuários não o selecionam diretamente.

Todos os inteiros no fluxo são valores assinados de 32 bits codificados em ordem de bytes little-endian. Uma string é codificada como seu comprimento em bytes
seguido de seus bytes. A saída tem a seguinte estrutura:

1. O valor `2`, indicando que duas linhas de cabeçalho vêm em seguida.
2. Um cabeçalho de nomes contendo o valor `number_of_columns + 1`, a string `name` e o nome de cada coluna.
3. Um cabeçalho de tipos contendo o valor `number_of_columns + 1`, a string `type` e o nome de cada tipo de dados do ClickHouse.
   Os wrappers `LowCardinality` são removidos desses nomes de tipo.
4. As linhas de dados. Cada linha contém, para cada coluna de resultado, um valor serializado como texto e prefixado pelo comprimento. As linhas de dados não
   incluem sua própria contagem de linhas ou colunas, e o fluxo termina em `EOF`.

Um valor `NULL` é codificado com o comprimento `-1`; uma string não nula vazia tem comprimento `0`. Os totais, quando presentes, usam a
mesma codificação de linha e seguem as linhas comuns.

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

A consulta a seguir é representativa dos valores testados pelo formato:

```sql theme={null}
SELECT
    1 AS x,
    [2, 3] AS y,
    'Hello' AS z,
    NULL AS a
FORMAT ODBCDriver2
```

Como o resultado é binário, redirecione-o para um arquivo em vez de exibi-lo no terminal:

```shell theme={null}
clickhouse-client --query \
    "SELECT 1 AS x, [2, 3] AS y, 'Hello' AS z, NULL AS a FORMAT ODBCDriver2" \
    > result.bin
```

Em condições normais de uso, o driver adiciona `default_format=ODBCDriver2` às requisições HTTP e decodifica a resposta.

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

`ODBCDriver2` usa as configurações padrão de serialização de texto para valores individuais. Ele não tem configurações específicas do próprio formato.