system.dictionaries

Tabela do sistema com informações sobre dicionários

Consultas no ClickHouse Cloud

Os dados nesta tabela de sistema são mantidos localmente em cada nó do ClickHouse Cloud. Portanto, para obter uma visão completa de todos os dados, é necessário usar a função clusterAllReplicas. Consulte aqui para mais detalhes.

​

Descrição

Contém informações sobre dicionários.

​

Colunas

• database (String) — Nome do banco de dados que contém o dicionário criado pela consulta DDL. String vazia para outros dicionários.
• name (String) — Nome do dicionário.
• uuid (UUID) — UUID do dicionário.
• status (Enum8(‘NOT_LOADED’ = 0, ‘LOADED’ = 1, ‘FAILED’ = 2, ‘LOADING’ = 3, ‘FAILED_AND_RELOADING’ = 4, ‘LOADED_AND_RELOADING’ = 5, ‘NOT_EXIST’ = 6)) — Status do dicionário. Possíveis valores:
  • NOT_LOADED — O dicionário não foi carregado porque não foi usado
  • LOADED — Dicionário carregado com sucesso
  • FAILED — Não foi possível carregar o dicionário devido a um erro
  • LOADING — O dicionário está sendo carregado no momento
  • LOADED_AND_RELOADING — O dicionário foi carregado com sucesso
  • and is being reloaded right now (frequent reasons: SYSTEM RELOAD DICTIONARY query —
  • timeout —
  • dictionary config has changed) —
  • FAILED_AND_RELOADING — Não foi possível carregar o dicionário devido a um erro e ele está sendo carregado no momento.
• origin (String) — Caminho para o arquivo de configuração que descreve o dicionário.
• type (String) — Tipo de alocação do dicionário. Armazenamento de Dicionários na memória.
• key.names (Array(String)) — Array de nomes de chave fornecidos pelo dicionário.
• key.types (Array(String)) — Array correspondente de tipos de chave fornecidos pelo dicionário.
• attribute.names (Array(String)) — Array de nomes de atributos fornecidos pelo dicionário.
• attribute.types (Array(String)) — Array correspondente de tipos de atributos fornecidos pelo dicionário.
• bytes_allocated (UInt64) — Quantidade de RAM alocada para o dicionário.
• hierarchical_index_bytes_allocated (UInt64) — Quantidade de RAM alocada para o índice hierárquico.
• query_count (UInt64) — Número de consultas desde que o dicionário foi carregado ou desde a última reinicialização bem-sucedida.
• hit_rate (Float64) — Para dicionários de cache, a porcentagem de usos em que o valor estava no cache.
• found_rate (Float64) — Porcentagem de usos em que o valor foi encontrado.
• element_count (UInt64) — Número de itens armazenados no dicionário.
• load_factor (Float64) — Percentual de preenchimento do dicionário (para um dicionário com hash, o percentual de preenchimento da tabela hash).
• source (String) — Texto que descreve a fonte de dados do dicionário.
• lifetime_min (UInt64) — Tempo de vida mínimo do dicionário na memória, após o qual o ClickHouse tenta recarregá-lo (se invalidate_query estiver definido, apenas se ele tiver sido alterado). Definido em segundos.
• lifetime_max (UInt64) — Tempo de vida máximo do dicionário na memória, após o qual o ClickHouse tenta recarregá-lo (se invalidate_query estiver definido, apenas se ele tiver sido alterado). Definido em segundos.
• loading_start_time (DateTime) — Horário de início do carregamento do dicionário.
• last_successful_update_time (DateTime) — Horário de término do carregamento ou da atualização do dicionário. Ajuda a monitorar problemas com fontes de dicionário e a investigar suas causas.
• error_count (UInt64) — Número de erros desde o último carregamento bem-sucedido. Ajuda a monitorar problemas com fontes de dicionário e a investigar suas causas.
• loading_duration (Float32) — Duração do carregamento do dicionário.
• last_exception (String) — Texto do erro que ocorre ao criar ou recarregar o dicionário, caso ele não possa ser criado.
• comment (String) — Texto do comentário do dicionário.

​

Exemplo

Configure o dicionário:

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

Certifique-se de que o dicionário esteja carregado.

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