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

> Documentation pour SHOW

# Instructions SHOW

<Note>
  `SHOW CREATE (TABLE|DATABASE|USER)` masque les secrets, sauf si les paramètres suivants sont activés :

  * [`display_secrets_in_show_and_select`](/fr/reference/settings/server-settings/settings#display_secrets_in_show_and_select) (paramètre serveur)
  * [`format_display_secrets_in_show_and_select` ](/fr/reference/settings/formats#format_display_secrets_in_show_and_select) (paramètre de format)

  De plus, l'utilisateur doit disposer du privilège [`displaySecretsInShowAndSelect`](/fr/reference/statements/grant#displaysecretsinshowandselect).
</Note>

<div id="show-create-table--dictionary--view--database">
  ## SHOW CREATE TABLE | DICTIONARY | VIEW | DATABASE
</div>

Ces instructions renvoient une unique colonne de type String,
contenant la requête `CREATE` utilisée pour créer l'objet indiqué.

<div id="syntax">
  ### Syntaxe
</div>

```sql title="Syntax" theme={null}
SHOW [CREATE] TABLE | TEMPORARY TABLE | DICTIONARY | VIEW | DATABASE [db.]table|view [INTO OUTFILE filename] [FORMAT format]
```

<Note>
  Si vous utilisez cette instruction pour obtenir la requête `CREATE` des tables système,
  vous obtiendrez une requête *factice*, qui ne fait que déclarer la structure de la table
  et ne peut pas être utilisée pour créer une table.
</Note>

<div id="show-databases">
  ## SHOW DATABASES
</div>

Cette instruction affiche la liste de toutes les bases de données.

<div id="syntax">
  ### Syntaxe
</div>

```sql title="Syntax" theme={null}
SHOW DATABASES [[NOT] LIKE | ILIKE '<pattern>'] [LIMIT <N>] [INTO OUTFILE filename] [FORMAT format]
```

Elle est identique à la requête :

```sql theme={null}
SELECT name FROM system.databases [WHERE name [NOT] LIKE | ILIKE '<pattern>'] [LIMIT <N>] [INTO OUTFILE filename] [FORMAT format]
```

<div id="examples">
  ### Exemples
</div>

Dans cet exemple, nous utilisons `SHOW` pour afficher les noms des bases de données contenant la séquence de caractères 'de' dans leur nom :

```sql title="Query" theme={null}
SHOW DATABASES LIKE '%de%'
```

```text title="Response" theme={null}
┌─name────┐
│ default │
└─────────┘
```

Nous pouvons également le faire sans tenir compte de la casse :

```sql title="Query" theme={null}
SHOW DATABASES ILIKE '%DE%'
```

```text title="Response" theme={null}
┌─name────┐
│ default │
└─────────┘
```

Ou obtenez les noms des bases de données qui ne contiennent pas 'de' :

```sql title="Query" theme={null}
SHOW DATABASES NOT LIKE '%de%'
```

```text title="Response" theme={null}
┌─name───────────────────────────┐
│ _temporary_and_external_tables │
│ system                         │
│ test                           │
│ tutorial                       │
└────────────────────────────────┘
```

Enfin, nous pouvons obtenir les noms des deux premières bases de données :

```sql title="Query" theme={null}
SHOW DATABASES LIMIT 2
```

```text title="Response" theme={null}
┌─name───────────────────────────┐
│ _temporary_and_external_tables │
│ default                        │
└────────────────────────────────┘
```

<div id="see-also">
  ### Voir aussi
</div>

* [`CREATE DATABASE`](/fr/reference/statements/create/database)

<div id="show-tables">
  ## SHOW TABLES
</div>

L’instruction `SHOW TABLES` affiche la liste des tables.

<div id="syntax">
  ### Syntaxe
</div>

```sql title="Syntax" theme={null}
SHOW [FULL] [TEMPORARY] TABLES [{FROM | IN} <db>] [[NOT] LIKE | ILIKE '<pattern>'] [LIMIT <N>] [INTO OUTFILE <filename>] [FORMAT <format>]
```

Si la clause `FROM` n'est pas spécifiée, la requête renvoie la liste des tables de la base de données courante.

Cette instruction est identique à la requête suivante :

```sql theme={null}
SELECT name FROM system.tables [WHERE name [NOT] LIKE | ILIKE '<pattern>'] [LIMIT <N>] [INTO OUTFILE <filename>] [FORMAT <format>]
```

<div id="examples">
  ### Exemples
</div>

Dans cet exemple, nous utilisons l’instruction `SHOW TABLES` pour répertorier toutes les tables contenant 'user' dans leur nom :

```sql title="Query" theme={null}
SHOW TABLES FROM system LIKE '%user%'
```

```text title="Response" theme={null}
┌─name─────────────┐
│ user_directories │
│ users            │
└──────────────────┘
```

Nous pouvons également le faire sans tenir compte de la casse :

```sql title="Query" theme={null}
SHOW TABLES FROM system ILIKE '%USER%'
```

```text title="Response" theme={null}
┌─name─────────────┐
│ user_directories │
│ users            │
└──────────────────┘
```

Ou, pour trouver des tables dont le nom ne contient pas la lettre 's' :

```sql title="Query" theme={null}
SHOW TABLES FROM system NOT LIKE '%s%'
```

```text title="Response" theme={null}
┌─name─────────┐
│ metric_log   │
│ metric_log_0 │
│ metric_log_1 │
└──────────────┘
```

Enfin, nous pouvons obtenir uniquement les noms des deux premières tables :

```sql title="Query" theme={null}
SHOW TABLES FROM system LIMIT 2
```

```text title="Response" theme={null}
┌─name───────────────────────────┐
│ aggregate_function_combinators │
│ asynchronous_metric_log        │
└────────────────────────────────┘
```

<div id="see-also">
  ### Voir aussi
</div>

* [`Create Tables`](/fr/reference/statements/create/table)
* [`SHOW CREATE TABLE`](#show-create-table--dictionary--view--database)

<div id="show_columns">
  ## SHOW COLUMNS
</div>

L’instruction `SHOW COLUMNS` affiche la liste des colonnes.

<div id="syntax">
  ### Syntaxe
</div>

```sql title="Syntax" theme={null}
SHOW [EXTENDED] [FULL] COLUMNS {FROM | IN} <table> [{FROM | IN} <db>] [{[NOT] {LIKE | ILIKE} '<pattern>' | WHERE <expr>}] [LIMIT <N>] [INTO
OUTFILE <filename>] [FORMAT <format>]
```

Le nom de la base de données et de la table peut être indiqué sous une forme abrégée, `<db>.<table>`,
ce qui signifie que `FROM tab FROM db` et `FROM db.tab` sont équivalents.
Si aucune base de données n'est indiquée, la requête renvoie la liste des colonnes de la base de données courante.

Il existe également deux mots-clés optionnels : `EXTENDED` et `FULL`. Le mot-clé `EXTENDED` n'a actuellement aucun effet
et existe pour la compatibilité avec MySQL. Le mot-clé `FULL` ajoute à la sortie les colonnes collation, commentaire et privilège.

L'instruction `SHOW COLUMNS` produit un tableau de résultats avec la structure suivante :

| Colonne     | Description                                                                                                                                | Type               |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------ | ------------------ |
| `field`     | Le nom de la colonne                                                                                                                       | `String`           |
| `type`      | Le type de données de la colonne. Si la requête a été effectuée via le MySQL wire protocol, le type équivalent dans MySQL est affiché.     | `String`           |
| `null`      | `YES` si le type de données de la colonne est Nullable, sinon `NO`                                                                         | `String`           |
| `key`       | `PRI` si la colonne fait partie de la clé primaire, `SOR` si la colonne fait partie de la clé de tri, vide sinon                           | `String`           |
| `default`   | Expression par défaut de la colonne si elle est de type `ALIAS`, `DEFAULT` ou `MATERIALIZED`, sinon `NULL`.                                | `Nullable(String)` |
| `extra`     | Informations supplémentaires, actuellement inutilisées                                                                                     | `String`           |
| `collation` | (uniquement si le mot-clé `FULL` a été spécifié) Collation de la colonne, toujours `NULL` car ClickHouse n'a pas de collations par colonne | `Nullable(String)` |
| `comment`   | (uniquement si le mot-clé `FULL` a été spécifié) Commentaire de la colonne                                                                 | `String`           |
| `privilege` | (uniquement si le mot-clé `FULL` a été spécifié) Le privilège dont vous disposez sur cette colonne, actuellement indisponible              | `String`           |

<div id="examples">
  ### Exemples
</div>

Dans cet exemple, nous utiliserons l’instruction `SHOW COLUMNS` pour obtenir des informations sur toutes les colonnes de la table 'orders',
à partir de 'delivery\_':

```sql title="Query" theme={null}
SHOW COLUMNS FROM 'orders' LIKE 'delivery_%'
```

```text title="Response" theme={null}
┌─field───────────┬─type─────┬─null─┬─key─────┬─default─┬─extra─┐
│ delivery_date   │ DateTime │    0 │ PRI SOR │ ᴺᵁᴸᴸ    │       │
│ delivery_status │ Bool     │    0 │         │ ᴺᵁᴸᴸ    │       │
└─────────────────┴──────────┴──────┴─────────┴─────────┴───────┘
```

<div id="see-also">
  ### Voir aussi
</div>

* [`system.columns`](/fr/reference/system-tables/columns)

<div id="show-dictionaries">
  ## SHOW DICTIONARIES
</div>

L’instruction `SHOW DICTIONARIES` affiche la liste des [Dictionaries](/fr/reference/statements/create/dictionary).

<div id="syntax">
  ### Syntaxe
</div>

```sql title="Syntax" theme={null}
SHOW DICTIONARIES [FROM <db>] [LIKE '<pattern>'] [LIMIT <N>] [INTO OUTFILE <filename>] [FORMAT <format>]
```

Si la clause `FROM` n'est pas spécifiée, la requête renvoie la liste des dictionnaires de la base de données courante.

Vous pouvez obtenir le même résultat que la requête `SHOW DICTIONARIES` de la manière suivante :

```sql theme={null}
SELECT name FROM system.dictionaries WHERE database = <db> [AND name LIKE <pattern>] [LIMIT <N>] [INTO OUTFILE <filename>] [FORMAT <format>]
```

<div id="examples">
  ### Exemples
</div>

La requête suivante sélectionne les deux premières lignes de la liste des tables dans la base de données `system`, dont le nom contient `reg`.

```sql title="Query" theme={null}
SHOW DICTIONARIES FROM db LIKE '%reg%' LIMIT 2
```

```text title="Response" theme={null}
┌─name─────────┐
│ regions      │
│ region_names │
└──────────────┘
```

<div id="show-index">
  ## SHOW INDEX
</div>

Affiche une liste des index primaires et des index de saut de données d’une table.

Cette instruction existe principalement pour assurer la compatibilité avec MySQL. Les tables système [`system.tables`](/fr/reference/system-tables/tables) (pour les
clés primaires) et [`system.data_skipping_indices`](/fr/reference/system-tables/data_skipping_indices) (pour les index de saut de données)
fournissent des informations équivalentes, mais d’une manière plus conforme aux usages natifs de ClickHouse.

<div id="syntax">
  ### Syntaxe
</div>

```sql title="Syntax" theme={null}
SHOW [EXTENDED] {INDEX | INDEXES | INDICES | KEYS } {FROM | IN} <table> [{FROM | IN} <db>] [WHERE <expr>] [INTO OUTFILE <filename>] [FORMAT <format>]
```

Le nom de la base de données et celui de la table peuvent être indiqués sous forme abrégée sous la forme `<db>.<table>` ; autrement dit, `FROM tab FROM db` et `FROM db.tab` sont
équivalents. Si aucune base de données n'est spécifiée, la requête utilise la base de données courante.

Le mot-clé facultatif `EXTENDED` n'a actuellement aucun effet et est présent pour assurer la compatibilité avec MySQL.

L'instruction produit un tableau de résultats ayant la structure suivante :

| Column          | Description                                                                                                                             | Type               |
| --------------- | --------------------------------------------------------------------------------------------------------------------------------------- | ------------------ |
| `table`         | Le nom de la table.                                                                                                                     | `String`           |
| `non_unique`    | Toujours `1`, car ClickHouse ne prend pas en charge les contraintes d'unicité.                                                          | `UInt8`            |
| `key_name`      | Le nom de l'index ; `PRIMARY` si l'index est un index de clé primaire.                                                                  | `String`           |
| `seq_in_index`  | Pour un index de clé primaire, la position de la colonne à partir de `1`. Pour un index de saut de données : toujours `1`.              | `UInt8`            |
| `column_name`   | Pour un index de clé primaire, le nom de la colonne. Pour un index de saut de données : `''` (chaîne vide), voir le champ "expression". | `String`           |
| `collation`     | L'ordre de tri de la colonne dans l'index : `A` pour croissant, `D` pour décroissant, `NULL` si non trié.                               | `Nullable(String)` |
| `cardinality`   | Une estimation de la cardinalité de l'index (nombre de valeurs uniques dans l'index). Actuellement toujours 0.                          | `UInt64`           |
| `sub_part`      | Toujours `NULL`, car ClickHouse ne prend pas en charge les préfixes d'index comme MySQL.                                                | `Nullable(String)` |
| `packed`        | Toujours `NULL`, car ClickHouse ne prend pas en charge les index compactés (comme MySQL).                                               | `Nullable(String)` |
| `null`          | Actuellement inutilisé.                                                                                                                 |                    |
| `index_type`    | Le type d'index, par ex. `PRIMARY`, `MINMAX`, `BLOOM_FILTER`, etc.                                                                      | `String`           |
| `comment`       | Informations supplémentaires sur l'index, actuellement toujours `''` (chaîne vide).                                                     | `String`           |
| `index_comment` | `''` (chaîne vide), car les index dans ClickHouse ne peuvent pas avoir de champ `COMMENT` (comme dans MySQL).                           | `String`           |
| `visible`       | Si l'index est visible pour l'optimiseur, toujours `YES`.                                                                               | `String`           |
| `expression`    | Pour un index de saut de données, l'expression de l'index. Pour un index de clé primaire : `''` (chaîne vide).                          | `String`           |

<div id="examples">
  ### Exemples
</div>

Dans cet exemple, nous utilisons l’instruction `SHOW INDEX` pour obtenir des informations sur tous les index de la table 'tbl'

```sql title="Query" theme={null}
SHOW INDEX FROM 'tbl'
```

```text title="Response" theme={null}
┌─table─┬─non_unique─┬─key_name─┬─seq_in_index─┬─column_name─┬─collation─┬─cardinality─┬─sub_part─┬─packed─┬─null─┬─index_type───┬─comment─┬─index_comment─┬─visible─┬─expression─┐
│ tbl   │          1 │ blf_idx  │ 1            │ 1           │ ᴺᵁᴸᴸ      │ 0           │ ᴺᵁᴸᴸ     │ ᴺᵁᴸᴸ   │ ᴺᵁᴸᴸ │ BLOOM_FILTER │         │               │ YES     │ d, b       │
│ tbl   │          1 │ mm1_idx  │ 1            │ 1           │ ᴺᵁᴸᴸ      │ 0           │ ᴺᵁᴸᴸ     │ ᴺᵁᴸᴸ   │ ᴺᵁᴸᴸ │ MINMAX       │         │               │ YES     │ a, c, d    │
│ tbl   │          1 │ mm2_idx  │ 1            │ 1           │ ᴺᵁᴸᴸ      │ 0           │ ᴺᵁᴸᴸ     │ ᴺᵁᴸᴸ   │ ᴺᵁᴸᴸ │ MINMAX       │         │               │ YES     │ c, d, e    │
│ tbl   │          1 │ PRIMARY  │ 1            │ c           │ A         │ 0           │ ᴺᵁᴸᴸ     │ ᴺᵁᴸᴸ   │ ᴺᵁᴸᴸ │ PRIMARY      │         │               │ YES     │            │
│ tbl   │          1 │ PRIMARY  │ 2            │ a           │ A         │ 0           │ ᴺᵁᴸᴸ     │ ᴺᵁᴸᴸ   │ ᴺᵁᴸᴸ │ PRIMARY      │         │               │ YES     │            │
│ tbl   │          1 │ set_idx  │ 1            │ 1           │ ᴺᵁᴸᴸ      │ 0           │ ᴺᵁᴸᴸ     │ ᴺᵁᴸᴸ   │ ᴺᵁᴸᴸ │ SET          │         │               │ YES     │ e          │
└───────┴────────────┴──────────┴──────────────┴─────────────┴───────────┴─────────────┴──────────┴────────┴──────┴──────────────┴─────────┴───────────────┴─────────┴────────────┘
```

<div id="see-also">
  ### Voir aussi
</div>

* [`system.tables`](/fr/reference/system-tables/tables)
* [`system.data_skipping_indices`](/fr/reference/system-tables/data_skipping_indices)

<div id="show-processlist">
  ## SHOW PROCESSLIST
</div>

Affiche le contenu de la table [`system.processes`](/fr/reference/system-tables/processes), qui contient la liste des requêtes en cours de traitement à cet instant, à l’exception des requêtes `SHOW PROCESSLIST`.

<div id="syntax">
  ### Syntaxe
</div>

```sql title="Syntax" theme={null}
SHOW PROCESSLIST [INTO OUTFILE filename] [FORMAT format]
```

La requête `SELECT * FROM system.processes` renvoie des informations sur toutes les requêtes actuellement en cours d’exécution.

<Tip>
  Exécutez dans le terminal :

  ```bash theme={null}
  $ watch -n1 "clickhouse-client --query='SHOW PROCESSLIST'"
  ```
</Tip>

<div id="show-grants">
  ## SHOW GRANTS
</div>

L’instruction `SHOW GRANTS` affiche les privilèges d’un utilisateur.

<div id="syntax">
  ### Syntaxe
</div>

```sql title="Syntax" theme={null}
SHOW GRANTS [FOR user1 [, user2 ...]] [WITH IMPLICIT] [FINAL]
```

Si aucun utilisateur n’est spécifié, la requête renvoie les privilèges de l’utilisateur courant.

Le modificateur `WITH IMPLICIT` permet d’afficher les privilèges implicites (par ex. `GRANT SELECT ON system.one`)

Le modificateur `FINAL` fusionne tous les privilèges accordés à l’utilisateur ainsi qu’à ses rôles attribués (avec héritage)

<div id="show-create-user">
  ## SHOW CREATE USER
</div>

L’instruction `SHOW CREATE USER` affiche les paramètres utilisés lors de la [création de l’utilisateur](/fr/reference/statements/create/user).

<div id="syntax">
  ### Syntaxe
</div>

```sql title="Syntax" theme={null}
SHOW CREATE USER [name1 [, name2 ...] | CURRENT_USER]
```

<div id="show-create-role">
  ## SHOW CREATE ROLE
</div>

L’instruction `SHOW CREATE ROLE` affiche les paramètres utilisés lors de la [création du rôle](/fr/reference/statements/create/role).

<div id="syntax">
  ### Syntaxe
</div>

```sql title="Syntax" theme={null}
SHOW CREATE ROLE name1 [, name2 ...]
```

<div id="show-create-row-policy">
  ## SHOW CREATE ROW POLICY
</div>

L’instruction `SHOW CREATE ROW POLICY` affiche les paramètres utilisés lors de la [création d’une ROW POLICY](/fr/reference/statements/create/row-policy).

<div id="syntax">
  ### Syntaxe
</div>

```sql title="Syntax" theme={null}
SHOW CREATE [ROW] POLICY name ON [database1.]table1 [, [database2.]table2 ...]
```

<div id="show-create-quota">
  ## SHOW CREATE QUOTA
</div>

L’instruction `SHOW CREATE QUOTA` affiche les paramètres utilisés lors de la [création du quota](/fr/reference/statements/create/quota).

<div id="syntax">
  ### Syntaxe
</div>

```sql title="Syntax" theme={null}
SHOW CREATE QUOTA [name1 [, name2 ...] | CURRENT]
```

<div id="show-create-settings-profile">
  ## SHOW CREATE SETTINGS PROFILE
</div>

L’instruction `SHOW CREATE SETTINGS PROFILE` affiche les paramètres utilisés lors de la [création du profil de paramètres](/fr/reference/statements/create/settings-profile).

<div id="syntax">
  ### Syntaxe
</div>

```sql title="Syntax" theme={null}
SHOW CREATE [SETTINGS] PROFILE name1 [, name2 ...]
```

<div id="show-users">
  ## SHOW USERS
</div>

L'instruction `SHOW USERS` renvoie la liste des noms des [comptes utilisateur](/fr/concepts/features/security/access-rights#user-account-management).
Pour afficher les paramètres des comptes utilisateur, consultez la table système [`system.users`](/fr/reference/system-tables/users).

<div id="syntax">
  ### Syntaxe
</div>

```sql title="Syntax" theme={null}
SHOW USERS
```

<div id="show-roles">
  ## SHOW ROLES
</div>

L’instruction `SHOW ROLES` renvoie une liste de [rôles](/fr/concepts/features/security/access-rights#role-management).
Pour consulter d’autres paramètres,
reportez-vous aux tables système [`system.roles`](/fr/reference/system-tables/roles) et [`system.role_grants`](/fr/reference/system-tables/role_grants).

<div id="syntax">
  ### Syntaxe
</div>

```sql title="Syntax" theme={null}
SHOW [CURRENT|ENABLED] ROLES
```

<div id="show-profiles">
  ## SHOW PROFILES
</div>

L’instruction `SHOW PROFILES` renvoie une liste de [profils de paramètres](/fr/concepts/features/security/access-rights#settings-profiles-management).
Pour afficher les paramètres des comptes d’utilisateur, consultez la table système [`settings_profiles`](/fr/reference/system-tables/settings_profiles).

<div id="syntax">
  ### Syntaxe
</div>

```sql title="Syntax" theme={null}
SHOW [SETTINGS] PROFILES
```

<div id="show-policies">
  ## SHOW POLICIES
</div>

L’instruction `SHOW POLICIES` renvoie une liste des [politiques de ligne](/fr/concepts/features/security/access-rights#row-policy-management) pour la table spécifiée.
Pour consulter les paramètres des comptes utilisateur, voir la table système [`system.row_policies`](/fr/reference/system-tables/row_policies).

<div id="syntax">
  ### Syntaxe
</div>

```sql title="Syntax" theme={null}
SHOW [ROW] POLICIES [ON [db.]table]
```

<div id="show-quotas">
  ## SHOW QUOTAS
</div>

L’instruction `SHOW QUOTAS` renvoie une liste de [quotas](/fr/concepts/features/security/access-rights#quotas-management).
Pour consulter les paramètres des quotas, reportez-vous à la table système [`system.quotas`](/fr/reference/system-tables/quotas).

<div id="syntax">
  ### Syntaxe
</div>

```sql title="Syntax" theme={null}
SHOW QUOTAS
```

<div id="show-quota">
  ## SHOW QUOTA
</div>

L’instruction `SHOW QUOTA` renvoie la consommation du [quota](/fr/concepts/features/configuration/server-config/quotas) pour tous les utilisateurs ou pour l’utilisateur actuel.
Pour afficher d’autres paramètres, consultez les tables système [`system.quotas_usage`](/fr/reference/system-tables/quotas_usage) et [`system.quota_usage`](/fr/reference/system-tables/quota_usage).

<div id="syntax">
  ### Syntaxe
</div>

```sql title="Syntax" theme={null}
SHOW [CURRENT] QUOTA
```

<div id="show-access">
  ## SHOW ACCESS
</div>

L’instruction `SHOW ACCESS` affiche tous les [utilisateurs](/fr/concepts/features/security/access-rights#user-account-management), [rôles](/fr/concepts/features/security/access-rights#role-management), [profils](/fr/concepts/features/security/access-rights#settings-profiles-management), etc., ainsi que toutes leurs [autorisations](/fr/reference/statements/grant#privileges).

<div id="syntax">
  ### Syntaxe
</div>

```sql title="Syntax" theme={null}
SHOW ACCESS
```

<div id="show-clusters">
  ## SHOW CLUSTER(S)
</div>

L’instruction `SHOW CLUSTER(S)` renvoie une liste de clusters.
Tous les clusters disponibles sont répertoriés dans la table [`system.clusters`](/fr/reference/system-tables/clusters).

<Note>
  La requête `SHOW CLUSTER name` affiche les valeurs `cluster`, `shard_num`, `replica_num`, `host_name`, `host_address` et `port` de la table `system.clusters` pour le nom de cluster spécifié.
</Note>

<div id="syntax">
  ### Syntaxe
</div>

```sql title="Syntax" theme={null}
SHOW CLUSTER '<name>'
SHOW CLUSTERS [[NOT] LIKE|ILIKE '<pattern>'] [LIMIT <N>]
```

<div id="examples">
  ### Exemples
</div>

```sql title="Query" theme={null}
SHOW CLUSTERS;
```

```text title="Response" theme={null}
┌─cluster──────────────────────────────────────┐
│ test_cluster_two_shards                      │
│ test_cluster_two_shards_internal_replication │
│ test_cluster_two_shards_localhost            │
│ test_shard_localhost                         │
│ test_shard_localhost_secure                  │
│ test_unavailable_shard                       │
└──────────────────────────────────────────────┘
```

```sql title="Query" theme={null}
SHOW CLUSTERS LIKE 'test%' LIMIT 1;
```

```text title="Response" theme={null}
┌─cluster─────────────────┐
│ test_cluster_two_shards │
└─────────────────────────┘
```

```sql title="Query" theme={null}
SHOW CLUSTER 'test_shard_localhost' FORMAT Vertical;
```

```text title="Response" theme={null}
Row 1:
──────
cluster:                 test_shard_localhost
shard_num:               1
replica_num:             1
host_name:               localhost
host_address:            127.0.0.1
port:                    9000
```

<div id="show-settings">
  ## SHOW SETTINGS
</div>

L’instruction `SHOW SETTINGS` renvoie la liste des paramètres système et de leurs valeurs.
Elle extrait les données de la table [`system.settings`](/fr/reference/system-tables/settings).

<div id="syntax">
  ### Syntaxe
</div>

```sql title="Syntax" theme={null}
SHOW [CHANGED] SETTINGS LIKE|ILIKE <name>
```

<div id="clauses">
  ### Clauses
</div>

`LIKE|ILIKE` permettent de définir un motif de correspondance pour le nom du paramètre. Ce motif peut contenir des caractères génériques tels que `%` ou `_`. La clause `LIKE` est sensible à la casse, `ILIKE` ne l'est pas.

Lorsque la clause `CHANGED` est utilisée, la requête renvoie uniquement les paramètres dont la valeur diffère de leur valeur par défaut.

<div id="examples">
  ### Exemples
</div>

Requête avec la clause `LIKE` :

```sql title="Query" theme={null}
SHOW SETTINGS LIKE 'send_timeout';
```

```text title="Response" theme={null}
┌─name─────────┬─type────┬─value─┐
│ send_timeout │ Seconds │ 300   │
└──────────────┴─────────┴───────┘
```

Requête utilisant la clause `ILIKE` :

```sql title="Query" theme={null}
SHOW SETTINGS ILIKE '%CONNECT_timeout%'
```

```text title="Response" theme={null}
┌─name────────────────────────────────────┬─type─────────┬─value─┐
│ connect_timeout                         │ Seconds      │ 10    │
│ connect_timeout_with_failover_ms        │ Milliseconds │ 50    │
│ connect_timeout_with_failover_secure_ms │ Milliseconds │ 100   │
└─────────────────────────────────────────┴──────────────┴───────┘
```

Requête avec la clause `CHANGED` :

```sql title="Query" theme={null}
SHOW CHANGED SETTINGS ILIKE '%MEMORY%'
```

```text title="Response" theme={null}
┌─name─────────────┬─type───┬─value───────┐
│ max_memory_usage │ UInt64 │ 10000000000 │
└──────────────────┴────────┴─────────────┘
```

<div id="show-setting">
  ## SHOW SETTING
</div>

L’instruction `SHOW SETTING` affiche la valeur du paramètre pour le nom de paramètre indiqué.

<div id="syntax">
  ### Syntaxe
</div>

```sql title="Syntax" theme={null}
SHOW SETTING <name>
```

<div id="see-also">
  ### Voir aussi
</div>

* table [`system.settings`](/fr/reference/system-tables/settings)

<div id="show-filesystem-caches">
  ## SHOW FILESYSTEM CACHES
</div>

<div id="examples">
  ### Exemples
</div>

```sql title="Query" theme={null}
SHOW FILESYSTEM CACHES
```

```text title="Response" theme={null}
┌─Caches────┐
│ s3_cache  │
└───────────┘
```

<div id="see-also">
  ### Voir aussi
</div>

* table [`system.settings`](/fr/reference/system-tables/settings)

<div id="show-engines">
  ## SHOW ENGINES
</div>

L’instruction `SHOW ENGINES` affiche le contenu de la table [`system.table_engines`](/fr/reference/system-tables/table_engines),
qui contient la description des moteurs de table pris en charge par le serveur, ainsi que des informations sur les fonctionnalités qu’ils prennent en charge.

<div id="syntax">
  ### Syntaxe
</div>

```sql title="Syntax" theme={null}
SHOW ENGINES [INTO OUTFILE filename] [FORMAT format]
```

<div id="see-also">
  ### Voir aussi
</div>

* table [system.table\_engines](/fr/reference/system-tables/table_engines)

<div id="show-functions">
  ## SHOW FUNCTIONS
</div>

L’instruction `SHOW FUNCTIONS` affiche le contenu de la table [`system.functions`](/fr/reference/system-tables/functions).

<div id="syntax">
  ### Syntaxe
</div>

```sql title="Syntax" theme={null}
SHOW FUNCTIONS [LIKE | ILIKE '<pattern>']
```

Si l’une des clauses `LIKE` ou `ILIKE` est spécifiée, la requête renvoie une liste des fonctions système dont le nom correspond au `<pattern>` fourni.

<div id="see-also">
  ### Voir aussi
</div>

* table [`system.functions`](/fr/reference/system-tables/functions)

<div id="show-merges">
  ## SHOW MERGES
</div>

L’instruction `SHOW MERGES` renvoie la liste des fusions.
Toutes les fusions sont répertoriées dans la table [`system.merges`](/fr/reference/system-tables/merges) :

| Colonne             | Description                                                 |
| ------------------- | ----------------------------------------------------------- |
| `table`             | Nom de la table.                                            |
| `database`          | Nom de la base de données à laquelle appartient la table.   |
| `estimate_complete` | Temps estimé avant la fin (en secondes).                    |
| `elapsed`           | Temps écoulé (en secondes) depuis le début de la fusion.    |
| `progress`          | Pourcentage de travail effectué (de 0 à 100 %).             |
| `is_mutation`       | 1 si ce processus correspond à une mutation de part.        |
| `size_compressed`   | Taille totale des données compressées des parts fusionnées. |
| `memory_usage`      | Consommation mémoire du processus de fusion.                |

<div id="syntax">
  ### Syntaxe
</div>

```sql title="Syntax" theme={null}
SHOW MERGES [[NOT] LIKE|ILIKE '<table_name_pattern>'] [LIMIT <N>]
```

<div id="examples">
  ### Exemples
</div>

```sql title="Query" theme={null}
SHOW MERGES;
```

```text title="Response" theme={null}
┌─table──────┬─database─┬─estimate_complete─┬─elapsed─┬─progress─┬─is_mutation─┬─size_compressed─┬─memory_usage─┐
│ your_table │ default  │              0.14 │    0.36 │    73.01 │           0 │        5.40 MiB │    10.25 MiB │
└────────────┴──────────┴───────────────────┴─────────┴──────────┴─────────────┴─────────────────┴──────────────┘
```

```sql title="Query" theme={null}
SHOW MERGES LIKE 'your_t%' LIMIT 1;
```

```text title="Response" theme={null}
┌─table──────┬─database─┬─estimate_complete─┬─elapsed─┬─progress─┬─is_mutation─┬─size_compressed─┬─memory_usage─┐
│ your_table │ default  │              0.14 │    0.36 │    73.01 │           0 │        5.40 MiB │    10.25 MiB │
└────────────┴──────────┴───────────────────┴─────────┴──────────┴─────────────┴─────────────────┴──────────────┘
```

<div id="show-create-masking-policy">
  ## SHOW CREATE MASKING POLICY
</div>

L’instruction `SHOW CREATE MASKING POLICY` affiche les paramètres utilisés lors de la [création d’une politique de masquage](/fr/reference/statements/create/masking-policy).

<div id="syntax">
  ### Syntaxe
</div>

```sql title="Syntax" theme={null}
SHOW CREATE MASKING POLICY name ON [database.]table
```