跳到主要内容
跳到主要内容

MySQL表引擎

MySQL引擎允许您对存储在远程MySQL服务器上的数据执行SELECTINSERT查询。

创建表

有关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_clauseUPDATE c2 = c2 + 1。请参见MySQL文档,以了解您可以与ON DUPLICATE KEY子句结合使用的on_duplicate_clause。 要指定on_duplicate_clause,您需要将0传递给replace_query参数。如果同时传递replace_query = 1on_duplicate_clause,ClickHouse将生成异常。

参数也可以使用命名集合传递。在这种情况下,hostport应分别指定。该方法建议用于生产环境。

简单的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

参见