字典数据源

语法

提示

如果你在 ClickHouse Cloud 中使用字典，请使用 DDL 查询方式来创建字典，并使用用户 default 创建字典。 另外，请在 Cloud Compatibility 指南 中核对受支持的字典数据源列表。

可以将字典连接到 ClickHouse 中的多种不同数据源。 数据源在配置文件的 source 部分中进行配置，在 DDL 语句中则通过 SOURCE 子句进行配置。

DDL

CREATE DICTIONARY dict_name (...)
...
SOURCE(SOURCE_TYPE(param1 val1 ... paramN valN)) -- 数据源配置
...

Configuration file

<clickhouse>
  <dictionary>
    ...
    <source>
      <source_type>
        <!-- 数据源配置 -->
      </source_type>
    </source>
    ...
  </dictionary>
  ...
</clickhouse>

支持的字典数据源

可用的源类型（SOURCE_TYPE/source_type）包括：

• 本地文件
• 可执行文件
• 可执行池
• HTTP(S)
• 数据库管理系统（DBMS）
  • ODBC
  • MySQL
  • ClickHouse
  • MongoDB
  • Redis
  • Cassandra
  • PostgreSQL
  • YTsaurus
• YAMLRegExpTree
• Null

对于源类型 本地文件、可执行文件、HTTP(s)、ClickHouse， 可以使用可选的设置：

DDL

SOURCE(FILE(path './user_files/os.tsv' format 'TabSeparated'))
--highlight-next-line
SETTINGS(format_csv_allow_single_quotes = 0)

配置文件

<source>
  <file>
    <path>/opt/dictionaries/os.tsv</path>
    <format>TabSeparated</format>
  </file>
  <settings>
#highlight-next-line
      <format_csv_allow_single_quotes>0</format_csv_allow_single_quotes>
  </settings>
</source>