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

MySQL 接口

ClickHouse 支持 MySQL 网络协议。这使得某些没有原生 ClickHouse 连接器的客户端能够利用 MySQL 协议，同时它已被与以下 BI 工具验证：

如果您尝试其他未经测试的客户端或集成，请注意可能存在以下限制：

  • SSL 实现可能不完全兼容；可能会出现潜在的 TLS SNI 问题。
  • 某些工具可能需要尚未实现的方言特性（例如，特定于 MySQL 的函数或设置）。

如果有可用的原生驱动程序（例如， DBeaver），建议使用它而不是 MySQL 接口。此外，虽然大多数 MySQL 语言客户端应该可以正常工作，但 MySQL 接口并不能保证能直接替代已有 MySQL 查询的代码库。

如果您的用例涉及某个没有原生 ClickHouse 驱动程序的特定工具，并且您希望通过 MySQL 接口使用它，并且发现某些不兼容性 - 请在 ClickHouse 仓库中 创建一个问题。

备注

为了更好地支持上述 BI 工具的 SQL 方言，ClickHouse 的 MySQL 接口隐式地使用设置 prefer_column_name_to_alias = 1 来运行 SELECT 查询。 这无法关闭，在极少数边缘情况下，发送到 ClickHouse 的正常和 MySQL 查询接口的查询可能会表现出不同的行为。

在 ClickHouse Cloud 上启用 MySQL 接口​

  1. 创建 ClickHouse Cloud 服务后，单击 Connect 按钮。

  1. 将 Connect with 下拉菜单更改为 MySQL。

  1. 切换开关以启用此特定服务的 MySQL 接口。这将为该服务暴露端口 3306 并提示您显示包含您唯一 MySQL 用户名的 MySQL 连接屏幕。密码将与服务的默认用户密码相同。

复制显示的 MySQL 连接字符串。

在 ClickHouse Cloud 中创建多个 MySQL 用户​

默认情况下，有一个内置的 mysql4<subdomain> 用户，其密码与 default 用户相同。<subdomain> 部分是您 ClickHouse Cloud 主机名的第一个段。这种格式对于与实现安全连接但不提供 SNI 信息 的工具使用是必要的，这使得在没有额外提示在用户名中的情况下进行内部路由变得不可能（MySQL 控制台客户端就是其中一种工具）。

因此，我们 强烈建议 在创建打算与 MySQL 接口一起使用的新用户时遵循 mysql4<subdomain>_<username> 格式，其中 <subdomain> 是用来标识您的云服务的提示，而 <username> 是您选择的任意后缀。

提示

对于 ClickHouse Cloud 主机名为 foobar.us-east1.aws.clickhouse.cloud，<subdomain> 部分等于 foobar，自定义 MySQL 用户名可能看起来像 mysql4foobar_team1。

您可以创建额外的用户与 MySQL 接口一起使用，例如，如果您需要应用额外的设置。

  1. 可选 - 创建一个适用于您自定义用户的 设置配置文件。例如，创建名为 my_custom_profile 的额外设置，该设置在与我们稍后创建的用户连接时默认应用：

prefer_column_name_to_alias 仅作为示例，您可以在其中使用其他设置。 2. 创建用户，使用以下格式: mysql4<subdomain>_<username>（见上文）。密码必须为双 SHA1 格式。例如：

或者如果您希望为该用户使用自定义配置文件：

其中 my_custom_profile 是您之前创建的配置文件的名称。 3. 授予 新用户必要的权限，以与所需的表或数据库进行交互。例如，若要仅授予对 system.query_log 的访问权限：

  1. 使用创建的用户通过 MySQL 接口连接到您的 ClickHouse Cloud 服务。

在 ClickHouse Cloud 中排除多个 MySQL 用户的问题​

如果您创建了一个新的 MySQL 用户，并且在通过 MySQL CLI 客户端连接时看到以下错误：

在这种情况下，请确保用户名遵循 mysql4<subdomain>_<username> 格式，如上所述（见上文）。

在自管理 ClickHouse 上启用 MySQL 接口​

将 mysql_port 设置添加到服务器的配置文件中。例如，您可以在 config.d/ 目录中的新 XML 文件中定义端口 文件夹:

启动 ClickHouse 服务器并查找类似以下内容的日志消息，提及监听 MySQL 兼容协议：

将 MySQL 连接到 ClickHouse​

以下命令演示如何将 MySQL 客户端 mysql 连接到 ClickHouse：

例如：

如果连接成功，输出如下：

为了与所有 MySQL 客户端兼容，建议在配置文件中指定用户密码为 双 SHA1 格式。 如果用户密码使用 SHA256 指定，则某些客户端将无法进行身份验证（如 mysqljs 和旧版本的命令行工具 MySQL 和 MariaDB）。

限制：

  • 不支持准备好的查询

  • 某些数据类型以字符串形式发送

要取消长查询，请使用 KILL QUERY connection_id 语句（在处理中时将其替换为 KILL QUERY WHERE query_id = connection_id）。例如：