允许 ClickHouse 通过 ODBC 连接到外部数据库。
为安全地实现 ODBC 连接,ClickHouse 使用单独的程序 clickhouse-odbc-bridge。如果直接由 clickhouse-server 加载 ODBC 驱动程序,驱动程序问题可能会导致 ClickHouse 服务器崩溃。ClickHouse 会在需要时自动启动 clickhouse-odbc-bridge。ODBC bridge 程序与 clickhouse-server 来自同一个安装包。
此引擎支持 Nullable 数据类型。
参见 CREATE TABLE 查询的详细说明。
表结构可以与源表的结构不同:
- 列名应与源表中的列名相同,但也可以只使用其中部分列,且顺序不限。
- 列类型可以与源表中的不同。ClickHouse 会尝试将值 转换 为 ClickHouse 数据类型。
- external_table_functions_use_nulls 设置定义了如何处理 Nullable 列。默认值:1。如果为 0,表函数不会生成 Nullable 列,而是插入默认值来代替 NULL。此规则也适用于数组中的 NULL 值。
引擎参数
datasource — odbc.ini 文件中包含连接设置的节名称。
external_database — 外部 DBMS 中数据库的名称。
external_table — external_database 中表的名称。
这些参数也可以通过命名集合传递。
通过 ODBC 从本地安装的 MySQL 获取数据
本示例已在 Ubuntu Linux 18.04 和 MySQL 服务器 5.7 上测试通过。
请确保已安装 unixODBC 和 MySQL Connector。
默认情况下 (如果是通过软件包安装) ,ClickHouse 会以用户 clickhouse 的身份启动。因此,你需要在 MySQL 服务器中创建并配置该用户。
然后在 /etc/odbc.ini 中配置连接。
您可以使用 unixODBC 安装包中的 isql 工具来检查连接。
MySQL 中的表:
ClickHouse 中用于从 MySQL 表检索数据的表:
Last modified on August 14, 2026