system.dictionaries

Выполнение запросов в ClickHouse Cloud

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

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

Столбцы:

• database (String) — Имя базы данных, содержащей словарь, созданный DDL-запросом. Пустая строка для других словарей.
• name (String) — Имя словаря.
• uuid (UUID) — UUID словаря.
• status (Enum8('NOT_LOADED' = 0, 'LOADED' = 1, 'FAILED' = 2, 'LOADING' = 3, 'FAILED_AND_RELOADING' = 4, 'LOADED_AND_RELOADING' = 5, 'NOT_EXIST' = 6)) — Статус словаря. Возможные значения:
  • 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) — Объём оперативной памяти, выделенной для словаря.
• hierarchical_index_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 'Временный словарь';

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

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:                     Временный словарь