跳到主要内容
跳到主要内容

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) — 为字典分配的 RAM 数量。
  • query_count (UInt64) — 自字典加载或自最后一次成功重启以来的查询数量。
  • hit_rate (Float64) — 对于缓存字典,值在缓存中的使用百分比。
  • found_rate (Float64) — 找到值的使用百分比。
  • element_count (UInt64) — 存储在字典中的项目数量。
  • load_factor (Float64) — 字典中填充的百分比(对于哈希字典,哈希表中填充的百分比)。
  • source (String) — 描述字典的数据源的文本 data source
  • 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) — 关于字典的评论文本。

示例

配置字典:

确保字典已加载。