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) — 描述字典的 数据源 的文本。
- 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) — 字典的备注文本。
示例
配置字典:
确保字典已加载。
