Pular para o conteúdo principal
Consultas no ClickHouse CloudOs 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
Última modificação em 10 de junho de 2026