system.dictionaries

在 ClickHouse Cloud 中查询

该系统表中的数据在 ClickHouse Cloud 的每个节点上本地保存。因此，要获得所有数据的完整视图，需要使用 clusterAllReplicas 函数。有关更多详细信息，请参见 here。

包含有关 字典 的信息。

列：

• 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) — 为字典分配的 RAM 数量。
• 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) — 加载或更新字典的结束时间。帮助监控字典源的某些问题并调查原因。
• loading_duration (Float32) — 字典加载的持续时间。
• last_exception (String) — 创建或重新加载字典时发生的错误文本，如果字典无法创建。
• comment (String) — 字典的注释文本。

示例

配置字典：

确保字典已加载。