dictionaries
包含有关 字典 的信息。
列
database
(字符串) — 包含由 DDL 查询创建的字典的数据库名称。对于其他字典,为空字符串。name
(字符串) — 字典名称。uuid
(UUID) — 字典 UUID。status
(Enum8) — 字典状态。可能的值NOT_LOADED
— 字典未加载,因为它未使用。LOADED
— 字典已成功加载。FAILED
— 由于错误导致无法加载字典。LOADING
— 字典正在加载中。LOADED_AND_RELOADING
— 字典已成功加载,并且目前正在重新加载(常见原因:SYSTEM RELOAD DICTIONARY 查询、超时、字典配置已更改)。FAILED_AND_RELOADING
— 由于错误导致无法加载字典,并且正在加载中。
origin
(字符串) — 描述字典的配置文件的路径。type
(字符串) — 字典分配的类型。 在内存中存储字典。key.names
(数组(字符串)) — 字典提供的 键名称 数组。key.types
(数组(字符串)) — 字典提供的相应 键类型 数组。attribute.names
(数组(字符串)) — 字典提供的 属性名称 数组。attribute.types
(数组(字符串)) — 字典提供的相应 属性类型 数组。bytes_allocated
(UInt64) — 为字典分配的 RAM 量。query_count
(UInt64) — 自字典加载或自上次成功重启以来的查询次数。hit_rate
(Float64) — 对于缓存字典,缓存中值的利用率百分比。found_rate
(Float64) — 找到值的利用率百分比。element_count
(UInt64) — 存储在字典中的项目数量。load_factor
(Float64) — 字典的填充百分比(对于哈希字典,哈希表中的填充百分比)。source
(字符串) — 描述字典的 数据源 的文本。lifetime_min
(UInt64) — 字典在内存中的最小 生命周期,在此之后 ClickHouse 尝试重新加载字典(如果设置了invalidate_query
,则仅在字典发生更改时)。以秒为单位设置。lifetime_max
(UInt64) — 字典在内存中的最大 生命周期,在此之后 ClickHouse 尝试重新加载字典(如果设置了invalidate_query
,则仅在字典发生更改时)。以秒为单位设置。loading_start_time
(日期时间) — 加载字典的开始时间。last_successful_update_time
(日期时间) — 加载或更新字典的结束时间。有助于监控字典源的一些问题并调查原因。loading_duration
(Float32) — 字典加载的持续时间。last_exception
(字符串) — 如果字典无法创建,则创建或重新加载字典时发生的错误的文本。comment
(字符串) — 字典的注释文本。
示例
配置字典
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