> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-mintlify-fbfa8bee.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
> Tabela do sistema com informações sobre dicionários
# system.dictionaries
**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](/pt-BR/reference/system-tables/overview#system-tables-in-clickhouse-cloud) para mais detalhes.
## Descrição
Contém informações sobre [dicionários](/pt-BR/reference/statements/create/dictionary).
## Colunas
* `database` ([String](/pt-BR/reference/data-types/index)) — Nome do banco de dados que contém o dicionário criado pela consulta DDL. String vazia para outros dicionários.
* `name` ([String](/pt-BR/reference/data-types/index)) — Nome do dicionário.
* `uuid` ([UUID](/pt-BR/reference/data-types/index)) — 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)](/pt-BR/reference/data-types/index)) — 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](/pt-BR/reference/data-types/index)) — Caminho para o arquivo de configuração que descreve o dicionário.
* `type` ([String](/pt-BR/reference/data-types/index)) — Tipo de alocação do dicionário. Armazenamento de Dicionários na memória.
* `key.names` ([Array(String)](/pt-BR/reference/data-types/index)) — Array com os nomes das chaves fornecidas pelo dicionário.
* `key.types` ([Array(String)](/pt-BR/reference/data-types/index)) — Array correspondente com os tipos de chave fornecidos pelo dicionário.
* `attribute.names` ([Array(String)](/pt-BR/reference/data-types/index)) — Array com os nomes dos atributos fornecidos pelo dicionário.
* `attribute.types` ([Array(String)](/pt-BR/reference/data-types/index)) — Array correspondente com os tipos de atributo fornecidos pelo dicionário.
* `bytes_allocated` ([UInt64](/pt-BR/reference/data-types/index)) — Quantidade de RAM alocada para o dicionário.
* `hierarchical_index_bytes_allocated` ([UInt64](/pt-BR/reference/data-types/index)) — Quantidade de RAM alocada para o índice hierárquico.
* `query_count` ([UInt64](/pt-BR/reference/data-types/index)) — Número de consultas desde que o dicionário foi carregado ou desde a última reinicialização bem-sucedida.
* `hit_rate` ([Float64](/pt-BR/reference/data-types/index)) — Para dicionários do tipo cache, a porcentagem de usos em que o valor estava no cache.
* `found_rate` ([Float64](/pt-BR/reference/data-types/index)) — Porcentagem de usos em que o valor foi encontrado.
* `element_count` ([UInt64](/pt-BR/reference/data-types/index)) — Número de itens armazenados no dicionário.
* `load_factor` ([Float64](/pt-BR/reference/data-types/index)) — Percentual de preenchimento do dicionário (para um dicionário com hash, o percentual de preenchimento da tabela hash).
* `source` ([String](/pt-BR/reference/data-types/index)) — Texto que descreve a origem dos dados do dicionário.
* `lifetime_min` ([UInt64](/pt-BR/reference/data-types/index)) — 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](/pt-BR/reference/data-types/index)) — 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](/pt-BR/reference/data-types/index)) — Hora de início do carregamento do dicionário.
* `last_successful_update_time` ([DateTime](/pt-BR/reference/data-types/index)) — 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](/pt-BR/reference/data-types/index)) — 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](/pt-BR/reference/data-types/index)) — Duração do carregamento de um dicionário.
* `last_exception` ([String](/pt-BR/reference/data-types/index)) — Texto do erro que ocorre ao criar ou recarregar o dicionário, caso ele não tenha podido ser criado.
* `comment` ([String](/pt-BR/reference/data-types/index)) — Texto do comentário do dicionário.
## Exemplo
Configure o dicionário:
```sql theme={null}
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.
```sql theme={null}
SELECT * FROM system.dictionaries LIMIT 1 FORMAT Vertical;
```
```text theme={null}
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
```