ClickHouse字典操作函数完全指南

富艾霏

于 2025-05-30 09:09:07 发布

阅读量406

点赞数 3

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00104/article/details/148325506

ClickHouse字典操作函数完全指南

ClickHouse ClickHouse® 是一个免费的大数据分析型数据库管理系统。项目地址: https://gitcode.com/gh_mirrors/cli/ClickHouse

概述

在ClickHouse中，字典是一种高效的数据结构，用于存储和快速访问键值对数据。字典可以存储在内存中，支持多种数据源，包括本地文件、数据库表等。本文将全面介绍ClickHouse中用于操作字典的各种函数及其使用方法。

字典基础概念

字典在ClickHouse中是一种特殊的数据结构，具有以下特点：

键值对存储结构
支持多种数据源
高效查询性能
支持多种布局方式（flat、hashed、cache等）
支持层次结构和范围查询

核心字典函数

1. 字典值获取函数

dictGet函数族

这三个函数是字典操作中最常用的函数，用于从字典中获取值：

dictGet('dict_name', 'attr_name', id_expr)
dictGetOrDefault('dict_name', 'attr_name', id_expr, default_value)
dictGetOrNull('dict_name', 'attr_name', id_expr)

参数说明：

dict_name：字典名称，字符串字面量
attr_name：字典属性名，字符串字面量
id_expr：键值表达式
default_value：默认值（仅dictGetOrDefault需要）

返回值差异：

dictGet：找不到键时返回字典配置中指定的<null_value>
dictGetOrDefault：找不到键时返回指定的默认值
dictGetOrNull：找不到键时返回NULL

示例：

-- 假设有一个名为'products'的字典，包含产品信息
SELECT 
    dictGet('products', 'name', 123) AS product_name,
    dictGetOrDefault('products', 'price', 123, 0.0) AS product_price,
    dictGetOrNull('products', 'category', 123) AS product_category

2. 字典存在性检查

dictHas函数

检查字典中是否存在指定的键：

dictHas('dict_name', id_expr)

返回值：

1：键存在
0：键不存在

示例：

SELECT dictHas('user_dict', user_id) AS user_exists
FROM user_actions

3. 层次结构字典函数

dictGetHierarchy函数

获取键在层次结构字典中的所有父级：

dictGetHierarchy('dict_name', key)

返回值：包含所有父键的数组

示例：

-- 获取组织架构中某个员工的所有上级
SELECT dictGetHierarchy('org_structure', 123) AS managers

dictIsIn函数

检查一个键是否是另一个键的祖先：

dictIsIn('dict_name', child_key, ancestor_key)

返回值：

1：是祖先或相同键
0：不是祖先

示例：

-- 检查部门123是否属于总部部门1
SELECT dictIsIn('departments', 123, 1) AS is_child_department

dictGetChildren和dictGetDescendant函数

获取子节点和后代节点：

dictGetChildren('dict_name', key)  -- 直接子节点
dictGetDescendant('dict_name', key, level)  -- 指定层级的后代

示例：

-- 获取部门1的所有直接子部门
SELECT dictGetChildren('departments', 1) AS child_depts

-- 获取部门1的所有后代（最多2层）
SELECT dictGetDescendant('departments', 1, 2) AS descendant_depts

4. 正则表达式树字典函数

dictGetAll函数

从正则表达式树字典中获取所有匹配的值：

dictGetAll('dict_name', 'attr_name', id_expr[, limit])

特点：

返回数组类型而非单个值
可选limit参数限制返回结果数量

示例：

-- 获取URL路径匹配的所有标签
SELECT dictGetAll('url_tags', 'tag', '/products/electronics') AS matched_tags

类型化字典函数

ClickHouse提供了一系列类型明确的字典函数，可以直接将返回值转换为特定类型：

dictGetInt8, dictGetInt16, dictGetInt32, dictGetInt64
dictGetUInt8, dictGetUInt16, dictGetUInt32, dictGetUInt64
dictGetFloat32, dictGetFloat64
dictGetDate, dictGetDateTime
dictGetUUID, dictGetString
dictGetIPv4, dictGetIPv6

这些函数都有对应的OrDefault版本，例如dictGetInt32OrDefault。

示例：

SELECT 
    dictGetUInt32('user_stats', 'login_count', user_id) AS logins,
    dictGetDateTimeOrDefault('user_sessions', 'last_login', user_id, now()) AS last_seen
FROM users