Passer au contenu principal
Interroger dans ClickHouse CloudLes 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 pour plus de détails.

Description

Contient des informations sur les dictionnaires.

Colonnes

  • database (String) — 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) — Nom du dictionnaire.
  • uuid (UUID) — 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)) — 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) — Chemin vers le fichier de configuration qui décrit le dictionnaire.
  • type (String) — Type d’allocation du dictionnaire. Stockage des dictionnaires en mémoire.
  • key.names (Array(String)) — Tableau des noms de clés fournis par le dictionnaire.
  • key.types (Array(String)) — Tableau correspondant des types de clés fournis par le dictionnaire.
  • attribute.names (Array(String)) — Tableau des noms d’attributs fournis par le dictionnaire.
  • attribute.types (Array(String)) — Tableau correspondant des types d’attributs fournis par le dictionnaire.
  • bytes_allocated (UInt64) — Quantité de RAM allouée au dictionnaire.
  • hierarchical_index_bytes_allocated (UInt64) — Quantité de RAM allouée à l’index hiérarchique.
  • query_count (UInt64) — Nombre de requêtes depuis le chargement du dictionnaire ou depuis le dernier redémarrage réussi.
  • hit_rate (Float64) — Pour les dictionnaires de type cache, pourcentage d’utilisations pour lesquelles la valeur se trouvait dans le cache.
  • found_rate (Float64) — Pourcentage d’utilisations pour lesquelles la valeur a été trouvée.
  • element_count (UInt64) — Nombre d’éléments stockés dans le dictionnaire.
  • load_factor (Float64) — Pourcentage de remplissage du dictionnaire (pour un dictionnaire haché, pourcentage de remplissage de la table de hachage).
  • source (String) — Texte décrivant la source de données du dictionnaire.
  • lifetime_min (UInt64) — 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) — 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) — Heure de début du chargement du dictionnaire.
  • last_successful_update_time (DateTime) — 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) — 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) — Durée du chargement d’un dictionnaire.
  • last_exception (String) — 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) — Texte du commentaire du dictionnaire.

Exemple

Configurez le dictionnaire :
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é.
SELECT * FROM system.dictionaries LIMIT 1 FORMAT Vertical;
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
Dernière modification le 25 juin 2026