= value`. |
| `data type` | [type de données](/fr/reference/data-types/index) du paramètre.
Par exemple, une structure de données comme `(integer, ('string', integer))` peut avoir pour type de données `Tuple(UInt8, Tuple(String, UInt8))` (vous pouvez également utiliser d’autres types [entier](/fr/reference/data-types/int-uint)).
Il est également possible de transmettre en paramètres le nom de la table, le nom de la base de données et les noms des colonnes ; dans ce cas, vous devrez utiliser `Identifier` comme type de données. |
### Exemples
```bash theme={null}
$ clickhouse-client --param_tuple_in_tuple="(10, ('dt', 10))" \
--query "SELECT * FROM table WHERE val = {tuple_in_tuple:Tuple(UInt8, Tuple(String, UInt8))}"
$ clickhouse-client --param_tbl="numbers" --param_db="system" --param_col="number" --param_alias="top_ten" \
--query "SELECT {col:Identifier} as {alias:Identifier} FROM {db:Identifier}.{tbl:Identifier} LIMIT 10"
```
## Génération SQL assistée par IA
ClickHouse Client inclut une assistance IA intégrée pour générer des requêtes SQL à partir de descriptions en langage naturel. Cette fonctionnalité permet aux utilisateurs de rédiger des requêtes complexes sans avoir besoin de connaissances approfondies en SQL.
L'assistance IA fonctionne immédiatement si la variable d'environnement `OPENAI_API_KEY` ou `ANTHROPIC_API_KEY` est définie. Pour une configuration plus avancée, consultez la section [Configuration](#ai-sql-generation-configuration).
### Utilisation
Pour utiliser la génération SQL par IA, faites précéder votre requête en langage naturel de `??` :
```bash theme={null}
:) ?? show all users who made purchases in the last 30 days
```
L’IA va :
1. Explorer automatiquement le schéma de votre base de données
2. Générer une requête SQL adaptée en fonction des tables et des colonnes détectées
3. Exécuter immédiatement la requête générée
### Exemple
```bash theme={null}
:) ?? count orders by product category
Starting AI SQL generation with schema discovery...
──────────────────────────────────────────────────
🔍 list_databases
➜ system, default, sales_db
🔍 list_tables_in_database
database: sales_db
➜ orders, products, categories
🔍 get_schema_for_table
database: sales_db
table: orders
➜ CREATE TABLE orders (order_id UInt64, product_id UInt64, quantity UInt32, ...)
✨ SQL query generated successfully!
──────────────────────────────────────────────────
SELECT
c.name AS category,
COUNT(DISTINCT o.order_id) AS order_count
FROM sales_db.orders o
JOIN sales_db.products p ON o.product_id = p.product_id
JOIN sales_db.categories c ON p.category_id = c.category_id
GROUP BY c.name
ORDER BY order_count DESC
```
### Configuration
La génération SQL par IA nécessite de configurer un fournisseur d’IA dans le fichier de configuration de votre client ClickHouse. Vous pouvez utiliser OpenAI, Anthropic ou tout service d’API compatible avec OpenAI.
#### Bascule de secours via l’environnement
Si aucune configuration d’IA n’est spécifiée dans le fichier de configuration, ClickHouse Client essaiera automatiquement d’utiliser les variables d’environnement :
1. Vérifie d’abord la variable d’environnement `OPENAI_API_KEY`
2. Si elle n’est pas trouvée, vérifie la variable d’environnement `ANTHROPIC_API_KEY`
3. Si aucune des deux n’est trouvée, les fonctionnalités d’IA seront désactivées
Cela permet une configuration rapide sans fichier de configuration :
```bash theme={null}
# Using OpenAI
export OPENAI_API_KEY=your-openai-key
clickhouse-client
# Using Anthropic
export ANTHROPIC_API_KEY=your-anthropic-key
clickhouse-client
```
#### Fichier de configuration
Pour mieux maîtriser les paramètres de l’IA, configurez-les dans le fichier de configuration de votre ClickHouse Client, situé à l’un des emplacements suivants :
* `$XDG_CONFIG_HOME/clickhouse/config.xml` (ou `~/.config/clickhouse/config.xml` si `XDG_CONFIG_HOME` n’est pas défini) (format XML)
* `$XDG_CONFIG_HOME/clickhouse/config.yaml` (ou `~/.config/clickhouse/config.yaml` si `XDG_CONFIG_HOME` n’est pas défini) (format YAML)
* `~/.clickhouse-client/config.xml` (format XML, emplacement legacy)
* `~/.clickhouse-client/config.yaml` (format YAML, emplacement legacy)
* Ou indiquez un emplacement personnalisé avec `--config-file`
```xml theme={null}
{/* Requis : votre clé API (ou définie via une variable d’environnement) */}
your-api-key-here
{/* Requis : type de fournisseur (openai, anthropic) */}
openai
{/* Modèle à utiliser (les valeurs par défaut varient selon le fournisseur) */}
gpt-4o
{/* Facultatif : point de terminaison d’API personnalisé pour les services compatibles OpenAI */}
{/* https://openrouter.ai/api */}
{/* Paramètres d’exploration du schéma */}
true
{/* Paramètres de génération */}
0.0
1000
30
10
{/* Facultatif : prompt système personnalisé */}
{/* You are an expert ClickHouse SQL assistant... */}
```
```yaml theme={null}
ai:
# Requis : votre clé API (ou définie via une variable d’environnement)
api_key: your-api-key-here
# Requis : type de fournisseur (openai, anthropic)
provider: openai
# Modèle à utiliser
model: gpt-4o
# Facultatif : point de terminaison d’API personnalisé pour les services compatibles OpenAI
# base_url: https://openrouter.ai/api
# Active l’accès au schéma - permet à l’IA d’interroger les informations sur les bases de données et les tables
enable_schema_access: true
# Paramètres de génération
temperature: 0.0 # Contrôle le niveau d’aléa (0.0 = déterministe)
max_tokens: 1000 # Longueur maximale de la réponse
timeout_seconds: 30 # Délai d’expiration de la requête
max_steps: 10 # Nombre maximal d’étapes d’exploration du schéma
# Facultatif : prompt système personnalisé
# system_prompt: |
# You are an expert ClickHouse SQL assistant. Convert natural language to SQL.
# Focus on performance and use ClickHouse-specific optimizations.
# Always return executable SQL without explanations.
```
**Utilisation d’API compatibles OpenAI (par ex. OpenRouter) :**
```yaml theme={null}
ai:
provider: openai # Use 'openai' for compatibility
api_key: your-openrouter-api-key
base_url: https://openrouter.ai/api/v1
model: anthropic/claude-3.5-sonnet # Use OpenRouter model naming
```
**Exemples de configuration minimale :**
```yaml theme={null}
# Minimal config - uses environment variable for API key
ai:
provider: openai # Will use OPENAI_API_KEY env var
# No config at all - automatic fallback
# (Empty or no ai section - will try OPENAI_API_KEY then ANTHROPIC_API_KEY)
# Only override model - uses env var for API key
ai:
provider: openai
model: gpt-3.5-turbo
```
### Paramètres
* `api_key` - Votre clé API pour le service d’IA. Peut être omise si elle est définie via une variable d’environnement :
* OpenAI : `OPENAI_API_KEY`
* Anthropic : `ANTHROPIC_API_KEY`
* Remarque : la clé API du fichier de configuration prévaut sur la variable d’environnement
* `provider` - Le fournisseur d’IA : `openai` ou `anthropic`
* S’il est omis, le système utilise automatiquement les variables d’environnement disponibles
* `model` - Le modèle à utiliser (par défaut : selon le fournisseur)
* OpenAI : `gpt-4o`, `gpt-4`, `gpt-3.5-turbo`, etc.
* Anthropic : `claude-3-5-sonnet-20241022`, `claude-3-opus-20240229`, etc.
* OpenRouter : utilisez leur convention de nommage des modèles, par exemple `anthropic/claude-3.5-sonnet`
* `base_url` - point de terminaison de l’API personnalisé pour les services compatibles OpenAI (facultatif)
* `timeout_seconds` - Délai d’expiration de la requête, en secondes (par défaut : `30`)
* `enable_schema_access` - Autoriser l’IA à explorer les schémas de la base de données (par défaut : `true`)
* `max_steps` - Nombre maximal d’étapes d’appel d’outils pour l’exploration du schéma (par défaut : `10`)
* `temperature` - Contrôle le niveau d’aléa, 0.0 = déterministe, 1.0 = créatif (par défaut : `0.0`)
* `max_tokens` - Longueur maximale de la réponse en tokens (par défaut : `1000`)
* `system_prompt` - Instructions personnalisées pour l’IA (facultatif)
### Fonctionnement
Le générateur SQL par IA suit un processus en plusieurs étapes :
1. **Découverte du schéma**
L’IA utilise des outils intégrés pour explorer votre base de données
* Répertorie les bases de données disponibles
* Identifie les tables dans les bases de données pertinentes
* Examine la structure des tables à l’aide d’instructions `CREATE TABLE`
2. **Génération de requêtes**
À partir du schéma découvert, l’IA génère du SQL qui :
* Correspond à votre intention exprimée en langage naturel
* Utilise les noms de tables et de colonnes corrects
* Applique les jointures et agrégations appropriées
3. **Exécution**
Le SQL généré est exécuté automatiquement et les résultats sont affichés
### Limitations
* Nécessite une connexion Internet active
* L'utilisation de l'API est soumise aux limites de requêtes et aux coûts du fournisseur d'IA
* Les requêtes complexes peuvent nécessiter plusieurs ajustements
* L'IA a un accès en lecture seule aux informations de schéma, et non aux données elles-mêmes
### Sécurité
* Les clés API ne sont jamais envoyées aux serveurs ClickHouse
* L’IA n’a accès qu’aux informations de schéma (noms des tables/colonnes et types), pas aux données elles-mêmes
* Toutes les requêtes générées respectent les permissions existantes de votre base de données
## Chaîne de connexion
### Utilisation
ClickHouse Client prend également en charge la connexion à un serveur ClickHouse au moyen d’une chaîne de connexion semblable à celles de [MongoDB](https://www.mongodb.com/docs/manual/reference/connection-string/), [PostgreSQL](https://www.postgresql.org/docs/current/libpq-connect.html#LIBPQ-CONNSTRING) et [MySQL](https://dev.mysql.com/doc/refman/8.0/en/connecting-using-uri-or-key-value-pairs.html#connecting-using-uri). La syntaxe est la suivante :
```text theme={null}
clickhouse:[//[user[:password]@][hosts_and_ports]][/database][?query_parameters]
```
| Composant (tous facultatifs) | Description | Par défaut |
| ---------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------- |
| `user` | Nom d’utilisateur de la base de données. | `default` |
| `password` | Mot de passe de l’utilisateur de la base de données. Si `:` est spécifié et que le mot de passe est vide, le client invitera l’utilisateur à saisir son mot de passe. | - |
| `hosts_and_ports` | Liste d’hôtes et, éventuellement, de ports `host[:port] [, host:[port]], ...`. | `localhost:9000` |
| `database` | Nom de la base de données. | `default` |
| `query_parameters` | Liste de paires clé-valeur `param1=value1[,¶m2=value2], ...`. Pour certains paramètres, aucune valeur n’est requise. Les noms et les valeurs des paramètres sont sensibles à la casse. | - |
### Remarques
Si le nom d'utilisateur, le mot de passe ou la base de données sont spécifiés dans la chaîne de connexion, ils ne peuvent pas l'être avec `--user`, `--password` ou `--database` (et inversement).
La composante host peut être soit un nom d'hôte, soit une adresse IPv4 ou IPv6.
Les adresses IPv6 doivent être entre `[]` :
```text theme={null}
clickhouse://[2001:db8::1234]
```
Les chaînes de connexion peuvent contenir plusieurs hôtes.
ClickHouse Client essaiera de se connecter à ces hôtes dans l'ordre (de gauche à droite).
Une fois la connexion établie, il n'essaiera pas de se connecter aux hôtes restants.
La chaîne de connexion doit être spécifiée comme premier argument de `clickHouse-client`.
La chaîne de connexion peut être combinée avec n'importe quel nombre d'autres [options de ligne de commande](#command-line-options), à l'exception de `--host` et `--port`.
Les clés suivantes sont autorisées pour `query_parameters` :
| Key | Description |
| ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `secure` (or `s`) | Si elle est spécifiée, le client se connectera au serveur via une connexion sécurisée (TLS). Voir `--secure` dans les [options de ligne de commande](#command-line-options). |
**Encodage en pourcentage**
Les caractères non ASCII, les espaces et les caractères spéciaux dans les paramètres suivants doivent être [encodés en pourcentage](https://en.wikipedia.org/wiki/URL_encoding) :
* `user`
* `password`
* `hosts`
* `database`
* `query parameters`
### Exemples
Connectez-vous à `localhost` sur le port 9000 et exécutez la requête `SELECT 1`.
```bash theme={null}
clickhouse-client clickhouse://localhost:9000 --query "SELECT 1"
```
Connectez-vous à `localhost` avec l’utilisateur `john`, le mot de passe `secret`, l’hôte `127.0.0.1` et le port `9000`
```bash theme={null}
clickhouse-client clickhouse://john:secret@127.0.0.1:9000
```
Connectez-vous à `localhost` avec l’utilisateur `default`, à l’hôte ayant l’adresse IPv6 `[::1]` et sur le port `9000`.
```bash theme={null}
clickhouse-client clickhouse://[::1]:9000
```
Connectez-vous à `localhost` sur le port 9000 en mode multiligne.
```bash theme={null}
clickhouse-client clickhouse://localhost:9000 '-m'
```
Connectez-vous à `localhost` sur le port 9000 en tant qu’utilisateur `default`.
```bash theme={null}
clickhouse-client clickhouse://default@localhost:9000
# equivalent to:
clickhouse-client clickhouse://localhost:9000 --user default
```
Connectez-vous à `localhost` sur le port 9000 et utilisez la base de données `my_database` par défaut.
```bash theme={null}
clickhouse-client clickhouse://localhost:9000/my_database
# equivalent to:
clickhouse-client clickhouse://localhost:9000 --database my_database
```
Connectez-vous à `localhost` sur le port 9000, utilisez par défaut la base de données `my_database` spécifiée dans la chaîne de connexion et activez une connexion sécurisée à l’aide du paramètre abrégé `s`.
```bash theme={null}
clickhouse-client clickhouse://localhost/my_database?s
# equivalent to:
clickhouse-client clickhouse://localhost/my_database -s
```
Connectez-vous à l’hôte par défaut à l’aide du port par défaut, de l’utilisateur default et de la base de données par défaut.
```bash theme={null}
clickhouse-client clickhouse:
```
Connectez-vous à l’hôte par défaut via le port par défaut, avec l’utilisateur `my_user` et sans mot de passe.
```bash theme={null}
clickhouse-client clickhouse://my_user@
# Using a blank password between : and @ means to asking the user to enter the password before starting the connection.
clickhouse-client clickhouse://my_user:@
```
Connectez-vous à `localhost` en utilisant l’adresse e-mail comme nom d’utilisateur. Le symbole `@` est encodé au format pourcentage sous la forme `%40`.
```bash theme={null}
clickhouse-client clickhouse://some_user%40some_mail.com@localhost:9000
```
Connectez-vous à l’une de ces deux adresses IP : `192.168.1.15`, `192.168.1.25`.
```bash theme={null}
clickhouse-client clickhouse://192.168.1.15,192.168.1.25
```
## Format de l’identifiant de requête
En mode interactif, ClickHouse Client affiche l’identifiant de requête pour chaque requête. Par défaut, l’identifiant se présente ainsi :
```sql theme={null}
Query id: 927f137d-00f1-4175-8914-0dd066365e96
```
Un format personnalisé peut être défini dans un fichier de configuration, à l’intérieur d’une balise `query_id_formats`. Le marqueur `{query_id}` dans la chaîne de format est remplacé par l’ID de la requête. Plusieurs chaînes de format sont autorisées à l’intérieur de la balise.
Cette fonctionnalité peut être utilisée pour générer des URL afin de faciliter le profiling des requêtes.
**Exemple**
```xml theme={null}
http://speedscope-host/#profileURL=qp%3Fid%3D{query_id}
```
Avec la configuration ci-dessus, l’identifiant d’une requête s’affiche au format suivant :
```response theme={null}
speedscope:http://speedscope-host/#profileURL=qp%3Fid%3Dc8ecc783-e753-4b38-97f1-42cddfb98b7d
```
## Fichiers de configuration
ClickHouse Client utilise le premier fichier existant dans la liste suivante :
* Un fichier défini avec le paramètre `-c [ -C, --config, --config-file ]`.
* `./clickhouse-client.[xml|yaml|yml]`
* `$XDG_CONFIG_HOME/clickhouse/config.[xml|yaml|yml]` (ou `~/.config/clickhouse/config.[xml|yaml|yml]` si `XDG_CONFIG_HOME` n’est pas défini)
* `~/.clickhouse-client/config.[xml|yaml|yml]`
* `/etc/clickhouse-client/config.[xml|yaml|yml]`
Consultez l’exemple de fichier de configuration dans le dépôt ClickHouse : [`clickhouse-client.xml`](https://github.com/ClickHouse/ClickHouse/blob/master/programs/client/clickhouse-client.xml)
```xml theme={null}
username
password
true
/etc/ssl/cert.pem
```
```yaml theme={null}
user: username
password: 'password'
secure: true
openSSL:
client:
caConfig: '/etc/ssl/cert.pem'
```
## Options des variables d’environnement
Le nom d’utilisateur, le mot de passe et l’hôte peuvent être définis à l’aide des variables d’environnement `CLICKHOUSE_USER`, `CLICKHOUSE_PASSWORD` et `CLICKHOUSE_HOST`.
Les arguments de ligne de commande `--user`, `--password` ou `--host`, ou une [chaîne de connexion](#connection_string) (si elle est spécifiée), sont prioritaires sur les variables d’environnement.
## Options en ligne de commande
Toutes les options en ligne de commande peuvent être spécifiées directement sur la ligne de commande ou définies par défaut dans le [fichier de configuration](#configuration_files).
### Options générales
| Option | Description | Par défaut |
| --------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------- |
| `-c [ -C, --config, --config-file ] ` | Emplacement du fichier de configuration du client, s’il ne se trouve pas dans l’un des emplacements par défaut. Voir [Fichiers de configuration](#configuration_files). | - |
| `--help` | Affiche un résumé de l’utilisation puis quitte. Combinez avec `--verbose` pour afficher toutes les options possibles, y compris les paramètres de requête. | - |
| `--history_file ` | Chemin vers un fichier contenant l’historique des commandes. | - |
| `--history_max_entries` | Nombre maximal d’entrées dans le fichier d’historique. | `1000000` (1 million) |
| `--prompt ` | Spécifie une invite personnalisée. | Le `display_name` du serveur |
| `--verbose` | Augmente le niveau de verbosité de la sortie. | - |
| `-V [ --version ]` | Affiche la version puis quitte. | - |
### Options de connexion
| Option | Description | Par défaut |
| ------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| `--connection ` | Le nom des informations de connexion préconfigurées issues du fichier de configuration. Voir [Identifiants de connexion](#connection-credentials). | - |
| `-d [ --database ] ` | Sélectionne la base de données utilisée par défaut pour cette connexion. | La base de données actuelle issue des paramètres du serveur (`default` par défaut) |
| `-h [ --host ] ` | Le nom d’hôte du serveur ClickHouse auquel se connecter. Il peut s’agir d’un nom d’hôte, d’une adresse IPv4 ou d’une adresse IPv6. Plusieurs hôtes peuvent être fournis à l’aide de plusieurs arguments. | `localhost` |
| `--jwt ` | Utilise un JSON Web Token (JWT) pour l’authentification.
L’autorisation JWT côté serveur est disponible uniquement dans ClickHouse Cloud. | - |
| `login` | Lance le flux OAuth de type device grant afin de s’authentifier via un IdP.
Pour les hôtes ClickHouse Cloud, les variables OAuth sont inférées ; sinon, elles doivent être fournies avec `--oauth-url`, `--oauth-client-id` et `--oauth-audience`. | - |
| `--no-warnings` | Désactive l’affichage des avertissements de `system.warnings` lorsque le client se connecte au serveur. | - |
| `--no-server-client-version-message` | Supprime le message d’incompatibilité de version entre le serveur et le client lorsque le client se connecte au serveur. | - |
| `--password ` | Le mot de passe de l’utilisateur de la base de données. Vous pouvez également définir le mot de passe d’une connexion dans le fichier de configuration. Si vous ne spécifiez pas le mot de passe, le client vous le demandera. | - |
| `--port ` | Le port sur lequel le serveur accepte les connexions. Les ports par défaut sont 9440 (TLS) et 9000 (sans TLS).
Remarque : le client utilise le protocole natif, et non HTTP(S). | `9440` si `--secure` est spécifié, `9000` sinon. Utilise toujours `9440` par défaut si le nom d’hôte se termine par `.clickhouse.cloud`. |
| `-s [ --secure ]` | Indique s’il faut utiliser TLS.
Activé automatiquement lors d’une connexion au port 9440 (le port sécurisé par défaut) ou à ClickHouse Cloud.
Vous devrez peut-être configurer vos certificats CA dans le [fichier de configuration](#configuration_files). Les paramètres de configuration disponibles sont les mêmes que pour la [configuration TLS côté serveur](/fr/reference/settings/server-settings/settings#openssl). | Activé automatiquement lors d’une connexion au port 9440 ou à ClickHouse Cloud |
| `--ssh-key-file ` | Fichier contenant la clé privée SSH permettant de s’authentifier auprès du serveur. | - |
| `--ssh-key-passphrase ` | Phrase secrète de la clé privée SSH spécifiée dans `--ssh-key-file`. | - |
| `--tls-sni-override ` | Si TLS est utilisé, le nom de serveur (SNI) à transmettre lors de la négociation initiale. | L’hôte fourni via `-h` ou `--host`. |
| `-u [ --user ] ` | L’utilisateur de la base de données avec lequel se connecter. | `default` |
Au lieu des options `--host`, `--port`, `--user` et `--password`, le client prend également en charge les [chaînes de connexion](#connection_string).
### Options de requête
| Option | Description |
| ------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `--param_=` | Valeur de substitution pour un paramètre d’une [requête avec paramètres](#cli-queries-with-parameters). |
| `-q [ --query ] ` | Requête à exécuter en mode batch. Peut être spécifiée plusieurs fois (`--query "SELECT 1" --query "SELECT 2"`) ou une seule fois avec plusieurs requêtes séparées par des points-virgules (`--query "SELECT 1; SELECT 2;"`). Dans ce dernier cas, les requêtes `INSERT` utilisant des formats autres que `VALUES` doivent être séparées par des lignes vides.
Une requête unique peut aussi être spécifiée sans paramètre : `clickhouse-client "SELECT 1"`
Ne peut pas être utilisée avec `--queries-file`. |
| `--queries-file ` | Chemin vers un fichier contenant des requêtes. `--queries-file` peut être spécifiée plusieurs fois, par exemple `--queries-file queries1.sql --queries-file queries2.sql`.
Ne peut pas être utilisée avec `--query`. |
| `-m [ --multiline ]` | Si cette option est spécifiée, autorise les requêtes sur plusieurs lignes (la requête n’est pas envoyée lorsque vous appuyez sur Entrée). Les requêtes ne sont envoyées qu’une fois terminées par un point-virgule. |
| `--inline-insert-data` | Envoie `INSERT ... VALUES` (et les autres formats intégrés) tels quels dans le texte de la requête au lieu de convertir les données en blocs au format natif. Le serveur analyse lui-même les données intégrées, ce qui évite l’aller-retour nécessaire pour renvoyer au client la structure de la table et les valeurs par défaut des colonnes. Cela peut améliorer les performances lors de nombreuses petites insertions via le protocole natif. Définit automatiquement [`send_table_structure_on_insert_with_inline_data`](/fr/reference/settings/session-settings#send_table_structure_on_insert_with_inline_data) sur `0`. Ne peut pas être combiné avec des données intégrées et des données externes (depuis stdin ou `INFILE`). |
### Paramètres de requête
Les paramètres de requête peuvent être définis à l’aide d’options de ligne de commande dans le client, par exemple :
```bash theme={null}
$ clickhouse-client --max_threads 1
```
Voir [Paramètres](/fr/reference/settings/session-settings) pour la liste des paramètres.
### Options de formatage
| Option | Description | Valeur par défaut |
| --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------- |
| `-f [ --format ] ` | Utilisez le format spécifié pour afficher le résultat.
Consultez [Formats des données d’entrée et de sortie](/fr/reference/formats/index) pour obtenir la liste des formats pris en charge. | `TabSeparated` |
| `--pager ` | Redirigez toute la sortie vers cette commande. Généralement `less` (par ex. `less -S` pour afficher des jeux de résultats très larges) ou une commande similaire. | - |
| `-E [ --vertical ]` | Utilisez le [format Vertical](/fr/reference/formats/Vertical) pour afficher le résultat. Cela équivaut à `–-format Vertical`. Dans ce format, chaque valeur est affichée sur une ligne distincte, ce qui est utile pour afficher des tables avec de nombreuses colonnes. | - |
| `--echo [ ]` | Affiche chaque requête avant son exécution. Accepte une valeur booléenne facultative. | `true` en mode interactif, `false` en mode non interactif (batch) |
| `--echo-formatted [ ]` | Met en forme les requêtes affichées. Accepte une valeur booléenne facultative. | `true` en mode interactif, `false` en mode non interactif (batch) |
| `--echo-query-id [ ]` | Affiche l’ID de la requête avant son exécution. Accepte une valeur booléenne facultative. | `true` en mode interactif, `false` en mode non interactif (batch) |
| `--highlight [ --hilite ] ` | Active ou désactive la coloration syntaxique de l’invite de commande et des requêtes affichées. | `true` |
### Détails d’exécution
| Option | Description | Par défaut |
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------- |
| `--chime [N]` | Écrit le caractère de contrôle `BEL` sur `stderr` lorsqu’une requête se termine (qu’elle réussisse ou échoue) après avoir duré au moins `N` secondes. N’est émis que lorsque `stderr` est connecté à un terminal (TTY) ; la redirection de `stderr` (par ex. `2>err.log`) le supprime, tandis que la redirection de `stdout` (par ex. `> result.tsv`) ne le supprime pas. Passer `--chime` sans valeur utilise le seuil par défaut. Définissez `--chime 0` pour le désactiver. | `5` secondes |
| `--enable-progress-table-toggle` | Active l’affichage/masquage du tableau de progression en appuyant sur la touche de contrôle (Espace). S’applique uniquement en mode interactif lorsque l’affichage du tableau de progression est activé. | `activé` |
| `--hardware-utilization` | Affiche les informations d’utilisation du matériel dans la barre de progression. | - |
| `--memory-usage` | Si spécifié, affiche l’utilisation de la mémoire sur `stderr` en mode non interactif.
Valeurs possibles :
• `none` - n’affiche pas l’utilisation de la mémoire
• `default` - affiche le nombre d’octets
• `readable` - affiche l’utilisation de la mémoire dans un format lisible par l’humain | - |
| `--print-profile-events` | Affiche les paquets `ProfileEvents`. | - |
| `--progress` | Affiche la progression de l’exécution de la requête.
Valeurs possibles :
• `tty\|on\|1\|true\|yes` - sortie vers le terminal en mode interactif
• `err` - sortie vers `stderr` en mode non interactif
• `off\|0\|false\|no` - désactive l’affichage de la progression | `tty` en mode interactif, `off` en mode non interactif (`batch`) |
| `--progress-table` | Affiche un tableau de progression avec des métriques mises à jour pendant l’exécution de la requête.
Valeurs possibles :
• `tty\|on\|1\|true\|yes` - sortie vers le terminal en mode interactif
• `err` - sortie vers `stderr` en mode non interactif
• `off\|0\|false\|no` - désactive le tableau de progression | `tty` en mode interactif, `off` en mode non interactif (`batch`) |
| `--stacktrace` | Affiche les stack traces des exceptions. | - |
| `-t [ --time ]` | Affiche le temps d’exécution de la requête sur `stderr` en mode non interactif (pour les benchmarks). | - |