跳转到主要内容
允许 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 值。
引擎参数
  • datasourceodbc.ini 文件中包含连接设置的节名称。
  • external_database — 外部 DBMS 中数据库的名称。
  • external_tableexternal_database 中表的名称。
这些参数也可以通过命名集合传递。

使用示例

通过 ODBC 从本地安装的 MySQL 获取数据 本示例已在 Ubuntu Linux 18.04 和 MySQL 服务器 5.7 上测试通过。 请确保已安装 unixODBC 和 MySQL Connector。 默认情况下 (如果是通过软件包安装) ,ClickHouse 会以用户 clickhouse 的身份启动。因此,你需要在 MySQL 服务器中创建并配置该用户。
然后在 /etc/odbc.ini 中配置连接。
您可以使用 unixODBC 安装包中的 isql 工具来检查连接。
MySQL 中的表:
ClickHouse 中用于从 MySQL 表检索数据的表:

另见

最后修改于 2026年6月19日