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. Valores possíveis:
  • NOT_LOADED — O dicionário não foi carregado porque não foi utilizado
  • 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 agora
  • LOADED_AND_RELOADING — O dicionário foi carregado com sucesso
  • and is being reloaded right now (frequent reasons: SYSTEM RELOAD DICTIONARY query — e está sendo recarregado neste momento (motivos frequentes: consulta SYSTEM RELOAD DICTIONARY
  • timeout — tempo limite
  • dictionary config has changed) — a configuração do dicionário foi alterada)
  • FAILED_AND_RELOADING — Não foi possível carregar o dicionário devido a um erro e ele está sendo carregado agora.
• 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 com os nomes das chaves fornecidas pelo dicionário.
• key.types (Array(String)) — Array correspondente com os tipos de chave fornecidos pelo dicionário.
• attribute.names (Array(String)) — Array com os nomes dos atributos fornecidos pelo dicionário.
• attribute.types (Array(String)) — Array correspondente com os tipos de atributo 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 do tipo 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 origem dos dados do dicionário.
• lifetime_min (UInt64) — Ciclo de vida mínimo do dicionário na memória, após o qual o ClickHouse tenta recarregá-lo (se invalidate_query estiver definido, somente se ele tiver sido alterado). Definido em segundos.
• lifetime_max (UInt64) — Ciclo de vida máximo do dicionário na memória, após o qual o ClickHouse tenta recarregá-lo (se invalidate_query estiver definido, somente se ele tiver sido alterado). Definido em segundos.
• loading_start_time (DateTime) — Hora de início do carregamento do dicionário.
• last_successful_update_time (DateTime) — Hora de término do carregamento ou da atualização do dicionário. Ajuda a monitorar problemas com origens de dicionário e investigar suas causas.
• error_count (UInt64) — Número de erros desde o último carregamento bem-sucedido. Ajuda a monitorar problemas com origens de dicionário e investigar suas causas.
• loading_duration (Float32) — Duração do carregamento de um dicionário.
• last_exception (String) — Texto do erro que ocorre ao criar ou recarregar o dicionário, caso ele não tenha podido 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