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 por uma 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 — dicionário não está carregado na memória no momento, LOADED — dicionário carregado com êxito, FAILED — não foi possível carregar o dicionário devido a um erro, LOADING — o dicionário está sendo carregado, LOADED_AND_RELOADING — o dicionário foi carregado com êxito e está sendo recarregado (motivos frequentes: consulta SYSTEM RELOAD DICTIONARY, timeout ou alteração na configuração do dicionário), FAILED_AND_RELOADING — não foi possível carregar o dicionário devido a um erro, e ele está sendo carregado.
• 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 chaves fornecido pelo dicionário.
• key.types (Array(String)) — Array correspondente de tipos de chaves fornecido pelo dicionário.
• attribute.names (Array(String)) — Array de nomes de atributos fornecido pelo dicionário.
• attribute.types (Array(String)) — Array correspondente de tipos de atributos fornecido 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) — Porcentagem de preenchimento do dicionário (para um dicionário hashed, a porcentagem de preenchimento da tabela hash).
• source (String) — Texto que descreve a fonte de 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 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 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 fontes 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 fontes 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 não tenha sido possível criá-lo.
• 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