> ## Documentation Index
> Fetch the complete documentation index at: https://private-7c7dfe99-fix-nav-issues.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Системная таблица с информацией о словарях

# system.dictionaries

<Info>
  **Запросы в ClickHouse Cloud**

  Данные в этой системной таблице хранятся локально на каждом узле ClickHouse Cloud. Поэтому, чтобы получить полное представление обо всех данных, требуется функция `clusterAllReplicas`. Дополнительные сведения см. [здесь](/ru/reference/system-tables/overview#system-tables-in-clickhouse-cloud).
</Info>

<div id="description">
  ## Описание
</div>

Содержит сведения о [словарях](/ru/reference/statements/create/dictionary).

<div id="columns">
  ## Столбцы
</div>

* `database` ([String](/ru/reference/data-types)) — Имя базы данных, содержащей словарь, созданный DDL-запросом. Для остальных словарей — пустая строка.
* `name` ([String](/ru/reference/data-types)) — Имя словаря.
* `uuid` ([UUID](/ru/reference/data-types)) — 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)) — Статус словаря. Возможные значения:
  * **NOT\_LOADED** — Словарь не был загружен, поскольку не использовался
  * **LOADED** — Словарь успешно загружен
  * **FAILED** — Словарь не удалось загрузить из-за ошибки
  * **LOADING** — Словарь загружается в данный момент
  * **LOADED\_AND\_RELOADING** — Словарь успешно загружен
  * **and is being reloaded right now (frequent reasons: SYSTEM RELOAD DICTIONARY query** —
  * **тайм-аут** —
  * **конфигурация словаря изменилась)** —
  * **FAILED\_AND\_RELOADING** — Словарь не удалось загрузить из-за ошибки, и сейчас он загружается повторно.
* `origin` ([String](/ru/reference/data-types)) — Путь к конфигурационному файлу, который описывает словарь.
* `type` ([String](/ru/reference/data-types)) — Тип размещения словаря в памяти. Хранение словарей в памяти.
* `key.names` ([Array(String)](/ru/reference/data-types)) — Массив имен ключей, предоставляемых словарем.
* `key.types` ([Array(String)](/ru/reference/data-types)) — Соответствующий массив типов ключей, предоставляемых словарем.
* `attribute.names` ([Array(String)](/ru/reference/data-types)) — Массив имен атрибутов, предоставляемых словарем.
* `attribute.types` ([Array(String)](/ru/reference/data-types)) — Соответствующий массив типов атрибутов, предоставляемых словарем.
* `bytes_allocated` ([UInt64](/ru/reference/data-types)) — Объем оперативной памяти, выделенной для словаря.
* `hierarchical_index_bytes_allocated` ([UInt64](/ru/reference/data-types)) — Объем оперативной памяти, выделенной для иерархического индекса.
* `query_count` ([UInt64](/ru/reference/data-types)) — Количество запросов с момента загрузки словаря или последней успешной перезагрузки.
* `hit_rate` ([Float64](/ru/reference/data-types)) — Для cache-словарей — процент обращений, при которых значение находилось в кеше.
* `found_rate` ([Float64](/ru/reference/data-types)) — Процент обращений, при которых значение было найдено.
* `element_count` ([UInt64](/ru/reference/data-types)) — Количество элементов, хранящихся в словаре.
* `load_factor` ([Float64](/ru/reference/data-types)) — Степень заполнения словаря в процентах (для хешированного словаря — степень заполнения хеш-таблицы).
* `source` ([String](/ru/reference/data-types)) — Текстовое описание источника данных для словаря.
* `lifetime_min` ([UInt64](/ru/reference/data-types)) — Минимальное время жизни словаря в памяти, по истечении которого ClickHouse пытается перезагрузить словарь (если задан `invalidate&#95;query`, то только если он изменился). Задается в секундах.
* `lifetime_max` ([UInt64](/ru/reference/data-types)) — Максимальное время жизни словаря в памяти, по истечении которого ClickHouse пытается перезагрузить словарь (если задан `invalidate&#95;query`, то только если он изменился). Задается в секундах.
* `loading_start_time` ([DateTime](/ru/reference/data-types)) — Время начала загрузки словаря.
* `last_successful_update_time` ([DateTime](/ru/reference/data-types)) — Время окончания загрузки или обновления словаря. Помогает отслеживать проблемы с источниками словарей и выяснять их причины.
* `error_count` ([UInt64](/ru/reference/data-types)) — Количество ошибок с момента последней успешной загрузки. Помогает отслеживать проблемы с источниками словарей и выяснять их причины.
* `loading_duration` ([Float32](/ru/reference/data-types)) — Длительность загрузки словаря.
* `last_exception` ([String](/ru/reference/data-types)) — Текст ошибки, возникающей при создании или перезагрузке словаря, если словарь не удалось создать.
* `comment` ([String](/ru/reference/data-types)) — Текст комментария к словарю.

<div id="example">
  ## Пример
</div>

Настройте словарь:

```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
```