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

> Documentation sur le format ODBCDriver2

# ODBCDriver2

| Entrée | Sortie | Alias |
| ------ | ------ | ----- |
| ✗      | ✔      |       |

<div id="description">
  ## Description
</div>

Le format `ODBCDriver2` est un format binaire destiné uniquement à la sortie, utilisé pour transférer les résultats de requête via HTTP au
[pilote ClickHouse pour `ODBC`](/fr/concepts/features/interfaces/odbc). Le pilote le demande en définissant `default_format` sur
`ODBCDriver2` ; les utilisateurs ne le sélectionnent généralement pas directement.

Tous les entiers du flux sont des valeurs signées sur 32 bits encodées selon l’ordre des octets little-endian. Une chaîne est encodée sous la forme de sa longueur en octets,
suivie de ses octets. La sortie présente la structure suivante :

1. La valeur `2`, indiquant que deux lignes d’en-tête suivent.
2. Un en-tête de noms contenant la valeur `number_of_columns + 1`, la chaîne `name` et le nom de chaque colonne.
3. Un en-tête de types contenant la valeur `number_of_columns + 1`, la chaîne `type` et le nom de chaque type de données ClickHouse.
   Les wrappers `LowCardinality` sont supprimés de ces noms de types.
4. Les lignes de données. Chaque ligne contient, pour chaque colonne de résultat, une valeur sérialisée au format texte et précédée de sa longueur. Les lignes de données n’incluent pas
   leur propre nombre de lignes ou de colonnes, et le flux se termine par `EOF`.

Une valeur `NULL` est encodée avec une longueur de `-1` ; une chaîne non nulle vide a une longueur de `0`. Les totaux, lorsqu’ils sont présents, utilisent le
même encodage de ligne et suivent les lignes ordinaires.

<div id="example-usage">
  ## Exemple d’utilisation
</div>

La requête suivante est représentative des valeurs couvertes par les tests du format :

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

Le résultat étant binaire, redirigez-le vers un fichier plutôt que vers un 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
```

En utilisation normale, le pilote ajoute `default_format=ODBCDriver2` à ses requêtes HTTP et décode la réponse.

<div id="format-settings">
  ## Paramètres de format
</div>

`ODBCDriver2` utilise les paramètres standard de sérialisation textuelle pour les valeurs individuelles. Il ne possède aucun paramètre spécifique au format lui-même.