Перейти к основному содержимому
Перейти к основному содержимому

system.dictionaries

Запросы в ClickHouse Cloud

Данные в этой системной таблице хранятся локально на каждом узле в ClickHouse Cloud. Для получения полного представления о всех данных требуется функция clusterAllReplicas. Смотрите здесь для получения дополнительной информации.

Содержит информацию о словарях.

Столбцы:

  • database (String) — Имя базы данных, содержащей словарь, созданный с помощью DDL-запроса. Пустая строка для других словарей.
  • name (String) — Имя словаря.
  • uuid (UUID) — UUID словаря.
  • status (Enum8) — Статус словаря. Возможные значения:
    • NOT_LOADED — Словарь не был загружен, потому что не использовался.
    • LOADED — Словарь успешно загружен.
    • FAILED — Не удалось загрузить словарь в результате ошибки.
    • LOADING — Словарь в процессе загрузки.
    • LOADED_AND_RELOADING — Словарь успешно загружен и сейчас повторно загружается (частые причины: SYSTEM RELOAD DICTIONARY запрос, тайм-аут, изменена конфигурация словаря).
    • FAILED_AND_RELOADING — Не удалось загрузить словарь в результате ошибки и он загружается сейчас.
  • origin (String) — Путь к файлу конфигурации, описывающему словарь.
  • type (String) — Тип распределения словаря. Хранение словарей в памяти.
  • key.names (Array(String)) — Массив имен ключей, предоставленных словарем.
  • key.types (Array(String)) — Соответствующий массив типов ключей, предоставленных словарем.
  • attribute.names (Array(String)) — Массив имен атрибутов, предоставленных словарем.
  • attribute.types (Array(String)) — Соответствующий массив типов атрибутов, предоставленных словарем.
  • bytes_allocated (UInt64) — Объем ОЗУ, выделенный для словаря.
  • query_count (UInt64) — Количество запросов с момента загрузки словаря или с момента последнего успешного перезапуска.
  • hit_rate (Float64) — Для кэшированных словарей процент случаев, когда значение находилось в кэше.
  • found_rate (Float64) — Процент случаев, когда значение было найдено.
  • element_count (UInt64) — Количество элементов, хранящихся в словаре.
  • load_factor (Float64) — Процент заполненности словаря (для хэшированного словаря — процент заполненности в хеш-таблице).
  • source (String) — Текст, описывающий источник данных для словаря.
  • lifetime_min (UInt64) — Минимальный срок жизни словаря в памяти, после которого ClickHouse пытается перезагрузить словарь (если установлен invalidate_query, то только если он изменился). Устанавливается в секундах.
  • lifetime_max (UInt64) — Максимальный срок жизни словаря в памяти, после которого ClickHouse пытается перезагрузить словарь (если установлен invalidate_query, то только если он изменился). Устанавливается в секундах.
  • loading_start_time (DateTime) — Время начала загрузки словаря.
  • last_successful_update_time (DateTime) — Время завершения загрузки или обновления словаря. Помогает отслеживать некоторые проблемы с источниками словаря и исследовать причины.
  • error_count (UInt64) - Количество ошибок с момента последней успешной загрузки. Помогает отслеживать некоторые проблемы с источниками словаря и исследовать причины.
  • loading_duration (Float32) — Длительность загрузки словаря.
  • last_exception (String) — Текст ошибки, возникающей при создании или перезагрузке словаря, если словарь не удалось создать.
  • comment (String) — Текст комментария к словарю.

Пример

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

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';

Убедитесь, что словарь загружен.

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