MySQL表引擎
MySQL引擎允许您对存储在远程MySQL服务器上的数据执行SELECT
和INSERT
查询。
创建表
有关CREATE TABLE查询的详细描述,请参见。
表结构可以与原始MySQL表结构不同:
- 列名应该与原始MySQL表中的相同,但您可以只使用其中的一些列并且顺序可以任意。
- 列类型可能与原始MySQL表中的不同。ClickHouse努力将值强制转换为ClickHouse数据类型。
- external_table_functions_use_nulls设置定义如何处理Nullable列。默认值:1。如果为0,表函数不会生成Nullable列,而是插入默认值而不是null。这也适用于数组中的NULL值。
备注
MySQL表引擎目前在MacOS的ClickHouse构建中不可用(issue)
引擎参数
host:port
— MySQL服务器地址。database
— 远程数据库名称。table
— 远程表名称。user
— MySQL用户。password
— 用户密码。replace_query
— 将INSERT INTO
查询转换为REPLACE INTO
的标志。如果replace_query=1
,则替换该查询。on_duplicate_clause
— 被添加到INSERT
查询中的ON DUPLICATE KEY on_duplicate_clause
表达式。 示例:INSERT INTO t (c1,c2) VALUES ('a', 2) ON DUPLICATE KEY UPDATE c2 = c2 + 1
,其中on_duplicate_clause
为UPDATE c2 = c2 + 1
。请参见MySQL文档,以了解您可以与ON DUPLICATE KEY
子句结合使用的on_duplicate_clause
。 要指定on_duplicate_clause
,您需要将0
传递给replace_query
参数。如果同时传递replace_query = 1
和on_duplicate_clause
,ClickHouse将生成异常。
参数也可以使用命名集合传递。在这种情况下,host
和port
应分别指定。该方法建议用于生产环境。
简单的WHERE
子句,如=, !=, >, >=, <, <=
在MySQL服务器上执行。
其余条件和LIMIT
采样约束在查询到MySQL完成后仅在ClickHouse中执行。
支持多个副本,必须用|
列出。例如:
使用示例
在MySQL中创建表:
在ClickHouse中使用纯参数创建表:
或使用命名集合:
从MySQL表中检索数据:
设置
默认设置效率不高,因为它们甚至不重用连接。这些设置可以让您增加服务器每秒执行的查询数量。
connection_auto_close
允许在查询执行后自动关闭连接,即禁用连接重用。
可能的值:
- 1 — 允许自动关闭连接,因此禁用了连接重用
- 0 — 不允许自动关闭连接,因此启用了连接重用
默认值:1
。
connection_max_tries
设置故障转移池的重试次数。
可能的值:
- 正整数。
- 0 — 对于故障转移池没有重试。
默认值:3
。
connection_pool_size
连接池大小(如果所有连接都在使用中,则查询将等待直到某些连接被释放)。
可能的值:
- 正整数。
默认值:16
。
connection_wait_timeout
等待可用连接的超时(以秒为单位)(如果有connection_pool_size
个活动连接),0 - 不等待。
可能的值:
- 正整数。
默认值:5
。
connect_timeout
连接超时(以秒为单位)。
可能的值:
- 正整数。
默认值:10
。
read_write_timeout
读/写超时(以秒为单位)。
可能的值:
- 正整数。
默认值:300
。