Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

system.dictionaries

View as MarkdownEdit this pageReport an issueSet up docs MCP

Descripción

Contiene información sobre diccionarios.

Columnas

  • database (String) — Nombre de la base de datos que contiene el diccionario creado mediante una consulta DDL. Cadena vacía para otros diccionarios.
  • name (String) — Nombre del diccionario.
  • uuid (UUID) — UUID del diccionario.
  • status (Enum8('NOT_LOADED' = 0, 'LOADED' = 1, 'FAILED' = 2, 'LOADING' = 3, 'FAILED_AND_RELOADING' = 4, 'LOADED_AND_RELOADING' = 5, 'NOT_EXIST' = 6)) — Estado del diccionario. Valores posibles: NOT_LOADED — El diccionario no está cargado actualmente en memoria, LOADED — El diccionario se cargó correctamente, FAILED — No se pudo cargar el diccionario debido a un error, LOADING — El diccionario se está cargando, LOADED_AND_RELOADING — El diccionario se cargó correctamente y se está recargando (motivos frecuentes: consulta SYSTEM RELOAD DICTIONARY, timeout o cambios en la configuración del diccionario), FAILED_AND_RELOADING — No se pudo cargar el diccionario debido a un error y se está cargando.
  • origin (String) — Ruta al archivo de configuración que describe el diccionario.
  • type (String) — Tipo de asignación de memoria del diccionario. Almacenamiento de diccionarios en memoria.
  • key.names (Array(String)) — Array de nombres de claves proporcionado por el diccionario.
  • key.types (Array(String)) — Array correspondiente de tipos de claves proporcionado por el diccionario.
  • attribute.names (Array(String)) — Array de nombres de atributos proporcionado por el diccionario.
  • attribute.types (Array(String)) — Array correspondiente de tipos de atributos proporcionado por el diccionario.
  • bytes_allocated (UInt64) — Cantidad de RAM asignada al diccionario.
  • hierarchical_index_bytes_allocated (UInt64) — Cantidad de RAM asignada al índice jerárquico.
  • query_count (UInt64) — Número de consultas desde que se cargó el diccionario o desde el último reinicio correcto.
  • hit_rate (Float64) — Para los diccionarios de caché, porcentaje de usos en los que el valor se encontraba en la caché.
  • found_rate (Float64) — Porcentaje de usos en los que se encontró el valor.
  • element_count (UInt64) — Número de elementos almacenados en el diccionario.
  • load_factor (Float64) — Porcentaje de ocupación del diccionario (para un diccionario hash, porcentaje de ocupación de la tabla hash).
  • source (String) — Texto que describe la fuente de datos del diccionario.
  • lifetime_min (UInt64) — Tiempo de vida mínimo del diccionario en memoria, tras el cual ClickHouse intenta recargarlo (si se establece invalidate_query, solo si ha cambiado). Se expresa en segundos.
  • lifetime_max (UInt64) — Tiempo de vida máximo del diccionario en memoria, tras el cual ClickHouse intenta recargarlo (si se establece invalidate_query, solo si ha cambiado). Se expresa en segundos.
  • loading_start_time (DateTime) — Hora de inicio de la carga del diccionario.
  • last_successful_update_time (DateTime) — Hora de finalización de la carga o actualización del diccionario. Ayuda a supervisar problemas con las fuentes de diccionarios e investigar sus causas.
  • error_count (UInt64) — Número de errores desde la última carga correcta. Ayuda a supervisar problemas con las fuentes de diccionarios e investigar sus causas.
  • loading_duration (Float32) — Duración de la carga de un diccionario.
  • last_exception (String) — Texto del error que se produce al crear o recargar el diccionario si no se pudo crear.
  • comment (String) — Texto del comentario del diccionario.

Ejemplo

Configure el diccionario:

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';

Asegúrese de que el diccionario esté cargado.

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