> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-revert-104359-revert-104251-parquet-single.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.
> Системная таблица с информацией о словарях
# system.dictionaries
**Запросы в ClickHouse Cloud**
Данные в этой системной таблице хранятся локально на каждом узле ClickHouse Cloud. Поэтому, чтобы получить полное представление обо всех данных, требуется функция `clusterAllReplicas`. Дополнительные сведения см. [здесь](/ru/reference/system-tables/overview#system-tables-in-clickhouse-cloud).
## Описание
Содержит сведения о [словарях](/ru/reference/statements/create/dictionary).
## Столбцы
* `database` ([String](/ru/reference/data-types/string)) — Имя базы данных, содержащей словарь, созданный DDL-запросом. Для других словарей — пустая строка.
* `name` ([String](/ru/reference/data-types/string)) — Имя словаря.
* `uuid` ([UUID](/ru/reference/data-types/uuid)) — UUID словаря.
* `status` ([Enum8('NOT\_LOADED' = 0, 'LOADED' = 1, 'FAILED' = 2, 'LOADING' = 3, 'FAILED\_AND\_RELOADING' = 4, 'LOADED\_AND\_RELOADING' = 5, 'NOT\_EXIST' = 6)](/ru/reference/data-types/enum)) — Статус словаря. Возможные значения: NOT\_LOADED — словарь сейчас не загружен в память, LOADED — словарь успешно загружен, FAILED — словарь не удалось загрузить из-за ошибки, LOADING — словарь сейчас загружается, LOADED\_AND\_RELOADING — словарь успешно загружен и сейчас перезагружается (частые причины: запрос SYSTEM RELOAD DICTIONARY, тайм-аут, изменение конфигурации словаря), FAILED\_AND\_RELOADING — словарь не удалось загрузить из-за ошибки, и сейчас выполняется повторная загрузка.
* `origin` ([String](/ru/reference/data-types/string)) — Путь к файлу конфигурации, описывающему словарь.
* `type` ([String](/ru/reference/data-types/string)) — Тип размещения словаря. Хранение словарей в памяти.
* `key.names` ([Array(String)](/ru/reference/data-types/array)) — Массив имён ключей, предоставляемых словарём.
* `key.types` ([Array(String)](/ru/reference/data-types/array)) — Соответствующий массив типов ключей, предоставляемых словарём.
* `attribute.names` ([Array(String)](/ru/reference/data-types/array)) — Массив имён атрибутов, предоставляемых словарём.
* `attribute.types` ([Array(String)](/ru/reference/data-types/array)) — Соответствующий массив типов атрибутов, предоставляемых словарём.
* `bytes_allocated` ([UInt64](/ru/reference/data-types/int-uint)) — Объём оперативной памяти, выделенной для словаря.
* `hierarchical_index_bytes_allocated` ([UInt64](/ru/reference/data-types/int-uint)) — Объём оперативной памяти, выделенной для иерархического индекса.
* `query_count` ([UInt64](/ru/reference/data-types/int-uint)) — Число запросов с момента загрузки словаря или последней успешной перезагрузки.
* `hit_rate` ([Float64](/ru/reference/data-types/float)) — Для кэширующих словарей — процент обращений, при которых значение находилось в кэше.
* `found_rate` ([Float64](/ru/reference/data-types/float)) — Процент обращений, при которых значение было найдено.
* `element_count` ([UInt64](/ru/reference/data-types/int-uint)) — Число элементов, хранящихся в словаре.
* `load_factor` ([Float64](/ru/reference/data-types/float)) — Процент заполнения словаря (для хешированного словаря — процент заполнения хеш-таблицы).
* `source` ([String](/ru/reference/data-types/string)) — Текстовое описание источника данных словаря.
* `lifetime_min` ([UInt64](/ru/reference/data-types/int-uint)) — Минимальное время жизни словаря в памяти, по истечении которого ClickHouse пытается перезагрузить словарь (если задан invalidate\_query — только при его изменении). Указывается в секундах.
* `lifetime_max` ([UInt64](/ru/reference/data-types/int-uint)) — Максимальное время жизни словаря в памяти, по истечении которого ClickHouse пытается перезагрузить словарь (если задан invalidate\_query — только при его изменении). Указывается в секундах.
* `loading_start_time` ([DateTime](/ru/reference/data-types/datetime)) — Время начала загрузки словаря.
* `last_successful_update_time` ([DateTime](/ru/reference/data-types/datetime)) — Время окончания загрузки или обновления словаря. Помогает отслеживать проблемы с источниками данных словарей и выяснять их причины.
* `error_count` ([UInt64](/ru/reference/data-types/int-uint)) — Число ошибок с момента последней успешной загрузки. Помогает отслеживать проблемы с источниками данных словарей и выяснять их причины.
* `loading_duration` ([Float32](/ru/reference/data-types/float)) — Длительность загрузки словаря.
* `last_exception` ([String](/ru/reference/data-types/string)) — Текст ошибки, возникшей при создании или перезагрузке словаря, если создать словарь не удалось.
* `comment` ([String](/ru/reference/data-types/string)) — Текст комментария к словарю.
## Пример
Настройте словарь:
```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';
```
Убедитесь, что словарь загружен.
```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
```