Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs
49.6kGet Started

MySQL

View as MarkdownEdit this pageReport an issueSet up docs MCP
ClickHouse Cloud 不支持此功能

允许连接到远程 MySQL 服务器 上的数据库，并执行 INSERT 和 SELECT 查询，在 ClickHouse 与 MySQL 之间交换数据。

MySQL 数据库引擎会将查询转发到 MySQL 服务器，因此您可以执行 SHOW TABLES 或 SHOW CREATE TABLE 等操作。

您无法执行以下查询：

  • RENAME
  • CREATE TABLE
  • ALTER

创建数据库

CREATE DATABASE [IF NOT EXISTS] db_name [ON CLUSTER cluster]
ENGINE = MySQL('host:port', ['database' | database], 'user', 'password')
[SETTINGS enable_compression=0]

引擎参数

  • host:port — MySQL 服务器地址。
  • database — 远程数据库名称。
  • user — MySQL 用户名。
  • password — 用户密码。

设置

enable_compression

为 MySQL 协议连接启用 zlib 压缩。设置为 1 时，ClickHouse 会向 MySQL 服务器请求启用协议级压缩。

默认值：0。

示例：

CREATE DATABASE mysql_db
ENGINE = MySQL('localhost:3306', 'test', 'my_user', 'user_password')
SETTINGS enable_compression = 1;

TLS/SSL

与 MySQL 建立加密连接所需的凭据可作为命名集合的键 (或键值参数) 传递：

参数 描述
ssl_ca_pem 用于验证 MySQL 服务器证书的 CA 证书内容。
ssl_cert_pem 用于基于证书的身份验证的客户端证书内容。
ssl_key_pem 与 ssl_cert_pem 对应的私钥内容。

这些值是相应 PEM 文件的内容，可复制到命名集合或查询中。与密码一样，它们会在日志和 SHOW 查询中被隐藏。

也可以通过 ssl_ca、ssl_cert 和 ssl_key 指定服务器上文件的路径来提供相同的凭据——但只能在服务器配置文件中定义的命名集合中使用，且此类值无法在查询中覆盖。服务器会使用自身的特权打开这些文件；因此，若允许从 SQL 中传入路径，任何能够定义 MySQL source 的用户都能探查本地文件系统，并使用其自身无权读取的证书和密钥进行身份验证。

数据类型支持

MySQL ClickHouse
UNSIGNED TINYINT UInt8
TINYINT Int8
UNSIGNED SMALLINT UInt16
SMALLINT Int16
UNSIGNED INT, UNSIGNED MEDIUMINT UInt32
INT, MEDIUMINT Int32
UNSIGNED BIGINT UInt64
BIGINT Int64
FLOAT Float32
DOUBLE Float64
DATE Date
DATETIME, TIMESTAMP DateTime
BINARY FixedString
POINT Point
LINESTRING LineString
POLYGON Polygon
MULTILINESTRING MultiLineString
MULTIPOLYGON MultiPolygon
MULTIPOINT MultiPoint
GEOMETRY Geometry

空间类型的转换 (始终会转换的 POINT 除外) 由 mysql_datatypes_support_level 设置中的 geometry 标志控制，该标志默认启用。通用 GEOMETRY 列类型会映射为总括性的 Geometry 类型 (即具体几何类型的 Variant) 。由于这类列可存储任意子类型的值，读取没有对应 ClickHouse 类型的子类型值 (GEOMETRYCOLLECTION) 时会引发异常；为获得恰当的几何类型，可接受这一不兼容性。声明为 GEOMETRYCOLLECTION 类型的列会与其他所有 MySQL 数据类型一样，转换为 String 。

支持 Nullable。在以下三种情况下，空间列会映射为 String (如果可为空，则为 Nullable(String)) ，而非几何类型：声明为 GEOMETRYCOLLECTION；geometry 标志已禁用且类型不是 POINT；或该列可为空且类型不是 POINT，因为 Point 是唯一可嵌套在 Nullable 中的几何类型。在这三种情况下，字符串会精确保留 MySQL 返回的值：一个 4 字节的 SRID 前缀，后接 WKB 载荷，因此在将其传递给 WKB 解码器之前，请去除前导的这 4 个字节。

支持全局变量

为获得更好的兼容性，你可以使用 MySQL 风格引用全局变量，即 @@identifier。

支持以下变量：

  • version
  • max_allowed_packet

示例：

SELECT @@version;

使用示例

MySQL 中的表：

mysql> USE test;
Database changed

mysql> CREATE TABLE `mysql_table` (
    ->   `int_id` INT NOT NULL AUTO_INCREMENT,
    ->   `float` FLOAT NOT NULL,
    ->   PRIMARY KEY (`int_id`));
Query OK, 0 rows affected (0,09 sec)

mysql> insert into mysql_table (`int_id`, `float`) VALUES (1,2);
Query OK, 1 row affected (0,00 sec)

mysql> select * from mysql_table;
+------+-----+
| int_id | value |
+------+-----+
|      1 |     2 |
+------+-----+
1 row in set (0,00 sec)

ClickHouse 中与 MySQL 服务器交换数据的数据库：

CREATE DATABASE mysql_db ENGINE = MySQL('localhost:3306', 'test', 'my_user', 'user_password') SETTINGS read_write_timeout=10000, connect_timeout=100;
SHOW DATABASES
┌─name─────┐
│ default  │
│ mysql_db │
│ system   │
└──────────┘
SHOW TABLES FROM mysql_db
┌─name─────────┐
│  mysql_table │
└──────────────┘
SELECT * FROM mysql_db.mysql_table
┌─int_id─┬─value─┐
│      1 │     2 │
└────────┴───────┘
INSERT INTO mysql_db.mysql_table VALUES (3,4)
SELECT * FROM mysql_db.mysql_table
┌─int_id─┬─value─┐
│      1 │     2 │
│      3 │     4 │
└────────┴───────┘
Navigation