跳转到主要内容

语法

如果您在 ClickHouse Cloud 中使用字典,请使用 DDL 查询选项创建字典,并以 default 用户创建。 此外,请在 Cloud 兼容性指南 中确认受支持的字典源列表。
字典可通过多种不同的源接入 ClickHouse。 源可在配置文件的 source 部分中配置,也可通过 DDL 语句中的 SOURCE 子句指定。

支持的字典源

支持以下源类型 (SOURCE_TYPE/source_type) : 对于 本地文件、可执行文件、HTTP(s)、ClickHouse 这几种字典源类型, 可以使用可选设置:

自定义查询的列顺序

ClickHouse、 MySQL、 PostgreSQL 和 ODBC 数据源支持 query 字段, 用于替代 ClickHouse 原本会根据 table 和 where 构建的查询。 字典要求该查询结果中的列遵循固定顺序,而这一顺序并不是属性在 CREATE DICTIONARY 语句中的书写顺序:
  1. 键列,按 PRIMARY KEY 中的顺序排列;
  2. 对于 range_hashed 或 complex_key_range_hashed 字典,先是 range_min 列,再是 range_max 列;
  3. 其余属性,按声明顺序排列。
ClickHouse 数据源按列名将结果与上述顺序进行匹配,因此使用该数据源时,只要每一列都以其所填充的属性命名, query 中的列顺序就无关紧要。而 MySQL、PostgreSQL 和 ODBC 数据源按位置读取列,因此使用这些数据源时, 只要 query 中的列顺序与上述不同,值就会被加载到错误的属性中。视所涉及的类型而定, 字典要么因类型转换错误而加载失败,要么存入错误的值。因此, 请按上述顺序编写 query: