跳转到主要内容
允许对存储在远程 MySQL 服务器中的数据执行 SELECTINSERT 查询。

语法

参数

参数也可以通过命名集合传递。在这种情况下,需要分别指定 hostport。这种方式推荐在生产环境中使用。 目前,诸如 =, !=, >, >=, <, <= 这样的简单 WHERE 子句会在 MySQL 服务器上执行。 其余条件以及 LIMIT 采样约束,只会在对 MySQL 的查询完成后由 ClickHouse 执行。 支持多个副本,必须使用 | 列出。例如:

返回值

一个表对象,其列与原始 MySQL 表的列相同。
MySQL 的某些数据类型可映射为不同的 ClickHouse 类型——可通过查询级设置 mysql_datatypes_support_level 来处理这一点。
INSERT 查询中,为了将表函数 mysql(...) 与带列名列表的表名区分开来,必须使用关键字 FUNCTIONTABLE FUNCTION。请参见下面的示例。

示例

MySQL 中的表:
从 ClickHouse 查询数据:
或者使用命名集合
替换与插入:
将 MySQL 表中的数据复制到 ClickHouse 表中:
或者,如果只想根据当前的最大 ID 从 MySQL 复制一个增量批次:
最后修改于 2026年6月19日