Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

system.dictionaries

View as MarkdownEdit this pageReport an issueSet up docs MCP

Description

Contient des informations sur les dictionnaires.

Colonnes

  • database (String) — Nom de la base de données contenant le dictionnaire créé par une 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)) — État du dictionnaire. Valeurs possibles : NOT_LOADED — dictionnaire actuellement non chargé en mémoire, LOADED — dictionnaire chargé avec succès, FAILED — impossible de charger le dictionnaire en raison d'une erreur, LOADING — dictionnaire en cours de chargement, LOADED_AND_RELOADING — dictionnaire chargé avec succès et en cours de rechargement (raisons fréquentes : requête SYSTEM RELOAD DICTIONARY, délai d'expiration, modification de la configuration du dictionnaire), FAILED_AND_RELOADING — échec du chargement du dictionnaire en raison d'une erreur, puis chargement en cours.
  • origin (String) — Chemin vers le fichier de configuration décrivant 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 le dernier redémarrage réussi.
  • hit_rate (Float64) — Pour les dictionnaires de type cache, pourcentage d'utilisations pour lesquelles la valeur était présente 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 hashed, 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, après laquelle ClickHouse tente de le recharger (si invalidate_query est défini, uniquement s'il a changé). Exprimée en secondes.
  • lifetime_max (UInt64) — Durée de vie maximale du dictionnaire en mémoire, après laquelle ClickHouse tente de le recharger (si invalidate_query est défini, 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. Permet de surveiller les problèmes liés aux sources de dictionnaires et d'en rechercher les causes.
  • error_count (UInt64) — Nombre d'erreurs depuis le dernier chargement réussi. Permet de surveiller les problèmes liés aux sources de dictionnaires et d'en rechercher les causes.
  • loading_duration (Float32) — Durée du chargement d'un dictionnaire.
  • last_exception (String) — Texte de l'erreur survenant lors de la création ou du rechargement du dictionnaire si sa création a échoué.
  • comment (String) — Texte du commentaire associé au 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
Navigation