> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-fbfa8bee.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
> Table système contenant des informations sur les dictionnaires
# system.dictionaries
**Interroger dans ClickHouse Cloud**
Les données de cette table système sont stockées localement sur chaque nœud de ClickHouse Cloud. Pour obtenir une vue complète de l’ensemble des données, il faut donc utiliser la fonction `clusterAllReplicas`. Consultez [cette page](/fr/reference/system-tables/overview#system-tables-in-clickhouse-cloud) pour plus de détails.
## Description
Contient des informations sur les [dictionnaires](/fr/reference/statements/create/dictionary).
## Colonnes
* `database` ([String](/fr/reference/data-types/index)) — Nom de la base de données contenant le dictionnaire créé par la requête DDL. Chaîne vide pour les autres dictionnaires.
* `name` ([String](/fr/reference/data-types/index)) — Nom du dictionnaire.
* `uuid` ([UUID](/fr/reference/data-types/index)) — UUID du dictionnaire.
* `status` ([Enum8('NOT\_LOADED' = 0, 'LOADED' = 1, 'FAILED' = 2, 'LOADING' = 3, 'FAILED\_AND\_RELOADING' = 4, 'LOADED\_AND\_RELOADING' = 5, 'NOT\_EXIST' = 6)](/fr/reference/data-types/index)) — Statut du dictionnaire. Valeurs possibles :
* **NOT\_LOADED** — Le dictionnaire n’a pas été chargé, car il n’a pas été utilisé
* **LOADED** — Le dictionnaire a été chargé avec succès
* **FAILED** — Impossible de charger le dictionnaire à la suite d’une erreur
* **LOADING** — Le dictionnaire est en cours de chargement
* **LOADED\_AND\_RELOADING** — Le dictionnaire est chargé avec succès
* **and is being reloaded right now (frequent reasons: SYSTEM RELOAD DICTIONARY query** —
* **timeout** —
* **dictionary config has changed)** —
* **FAILED\_AND\_RELOADING** — Le dictionnaire n’a pas pu être chargé à la suite d’une erreur et est en cours de rechargement.
* `origin` ([String](/fr/reference/data-types/index)) — Chemin vers le fichier de configuration qui décrit le dictionnaire.
* `type` ([String](/fr/reference/data-types/index)) — Type d’allocation du dictionnaire. Stockage des dictionnaires en mémoire.
* `key.names` ([Array(String)](/fr/reference/data-types/index)) — Tableau des noms de clés fournis par le dictionnaire.
* `key.types` ([Array(String)](/fr/reference/data-types/index)) — Tableau correspondant des types de clés fournis par le dictionnaire.
* `attribute.names` ([Array(String)](/fr/reference/data-types/index)) — Tableau des noms d’attributs fournis par le dictionnaire.
* `attribute.types` ([Array(String)](/fr/reference/data-types/index)) — Tableau correspondant des types d’attributs fournis par le dictionnaire.
* `bytes_allocated` ([UInt64](/fr/reference/data-types/index)) — Quantité de RAM allouée au dictionnaire.
* `hierarchical_index_bytes_allocated` ([UInt64](/fr/reference/data-types/index)) — Quantité de RAM allouée à l’index hiérarchique.
* `query_count` ([UInt64](/fr/reference/data-types/index)) — Nombre de requêtes depuis le chargement du dictionnaire ou depuis le dernier redémarrage réussi.
* `hit_rate` ([Float64](/fr/reference/data-types/index)) — Pour les dictionnaires de type cache, pourcentage d’utilisations pour lesquelles la valeur se trouvait dans le cache.
* `found_rate` ([Float64](/fr/reference/data-types/index)) — Pourcentage d’utilisations pour lesquelles la valeur a été trouvée.
* `element_count` ([UInt64](/fr/reference/data-types/index)) — Nombre d’éléments stockés dans le dictionnaire.
* `load_factor` ([Float64](/fr/reference/data-types/index)) — Pourcentage de remplissage du dictionnaire (pour un dictionnaire haché, pourcentage de remplissage de la table de hachage).
* `source` ([String](/fr/reference/data-types/index)) — Texte décrivant la source de données du dictionnaire.
* `lifetime_min` ([UInt64](/fr/reference/data-types/index)) — Durée de vie minimale du dictionnaire en mémoire, au-delà de laquelle ClickHouse essaie de recharger le dictionnaire (si invalidate\_query est défini, alors uniquement s’il a changé). Exprimée en secondes.
* `lifetime_max` ([UInt64](/fr/reference/data-types/index)) — Durée de vie maximale du dictionnaire en mémoire, au-delà de laquelle ClickHouse essaie de recharger le dictionnaire (si invalidate\_query est défini, alors uniquement s’il a changé). Exprimée en secondes.
* `loading_start_time` ([DateTime](/fr/reference/data-types/index)) — Heure de début du chargement du dictionnaire.
* `last_successful_update_time` ([DateTime](/fr/reference/data-types/index)) — Heure de fin du chargement ou de la mise à jour du dictionnaire. Aide à surveiller certains problèmes liés aux sources de dictionnaire et à en analyser les causes.
* `error_count` ([UInt64](/fr/reference/data-types/index)) — Nombre d’erreurs depuis le dernier chargement réussi. Aide à surveiller certains problèmes liés aux sources de dictionnaire et à en analyser les causes.
* `loading_duration` ([Float32](/fr/reference/data-types/index)) — Durée du chargement d’un dictionnaire.
* `last_exception` ([String](/fr/reference/data-types/index)) — Texte de l’erreur survenue lors de la création ou du rechargement du dictionnaire, si le dictionnaire n’a pas pu être créé.
* `comment` ([String](/fr/reference/data-types/index)) — Texte du commentaire du dictionnaire.
## Exemple
Configurez le dictionnaire :
```sql theme={null}
CREATE DICTIONARY dictionary_with_comment
(
id UInt64,
value String
)
PRIMARY KEY id
SOURCE(CLICKHOUSE(HOST 'localhost' PORT tcpPort() TABLE 'source_table'))
LAYOUT(FLAT())
LIFETIME(MIN 0 MAX 1000)
COMMENT 'The temporary dictionary';
```
Assurez-vous que le dictionnaire est chargé.
```sql theme={null}
SELECT * FROM system.dictionaries LIMIT 1 FORMAT Vertical;
```
```text theme={null}
Row 1:
──────
database: default
name: dictionary_with_comment
uuid: 4654d460-0d03-433a-8654-d4600d03d33a
status: NOT_LOADED
origin: 4654d460-0d03-433a-8654-d4600d03d33a
type:
key.names: ['id']
key.types: ['UInt64']
attribute.names: ['value']
attribute.types: ['String']
bytes_allocated: 0
query_count: 0
hit_rate: 0
found_rate: 0
element_count: 0
load_factor: 0
source:
lifetime_min: 0
lifetime_max: 0
loading_start_time: 1970-01-01 00:00:00
last_successful_update_time: 1970-01-01 00:00:00
loading_duration: 0
last_exception:
comment: The temporary dictionary
```