MySQL

允许连接到远程 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 │
└────────┴───────┘

SQL 参考

数据类型

引擎

函数

格式

接口

设置

系统表

数据湖

创建数据库

`enable_compression`

TLS/SSL

数据类型支持

支持全局变量

使用示例

​创建数据库

​enable_compression

​TLS/SSL

​数据类型支持

​支持全局变量

​使用示例

创建数据库

`enable_compression`

TLS/SSL

数据类型支持

支持全局变量

使用示例