跳转到主要内容
QuickSight 可通过 MySQL 接口,使用官方 MySQL 数据源和 Direct Query 模式连接到本地部署的 ClickHouse (23.11+) 。

本地部署 ClickHouse 服务器设置

有关如何配置启用 MySQL 接口的 ClickHouse 服务器,请参阅官方文档 除了在服务器的 config.xml 中添加一个条目之外
对于将通过 MySQL 接口 连接的用户,还必须使用 Double SHA1 密码加密 在 shell 中生成一个经 Double SHA1 加密的随机密码:
输出应类似于以下内容:
第一行是生成的密码,第二行是可用于配置 ClickHouse 的哈希值。 下面是 mysql_user 的一个示例配置,使用了生成的哈希值: /etc/clickhouse-server/users.d/mysql_user.xml
password_double_sha1_hex 条目替换为你自己生成的 Double SHA1 哈希值。 QuickSight 要求在 MySQL user 的 profile 中添加若干额外设置。 /etc/clickhouse-server/users.d/mysql_user.xml
不过,建议将其分配给另一个 profile,供你的 MySQL user 使用,而不要使用默认的 profile。 最后,配置 ClickHouse 服务器 使其监听所需的 IP 地址。 在 config.xml 中,取消注释以下内容以监听所有地址:
如果你本机可用 mysql 可执行文件,就可以通过命令行测试连接。 使用上文中的示例用户名 (mysql_user) 和密码 (LZOQYnqQN4L/T6L0) ,命令行如下所示:

将 QuickSight 连接到 ClickHouse

首先,前往 https://quicksight.aws.amazon.com,进入 Datasets,然后点击“New dataset”:
搜索 QuickSight 附带的官方 MySQL 连接器 (名称就是 MySQL) :
填写连接信息。请注意,MySQL 接口的默认端口是 9004, 具体端口可能会因服务器配置而有所不同。
现在,您有两种方式可以从 ClickHouse 获取数据。首先,您可以从列表中选择一张表:
或者,您也可以指定自定义 SQL 来获取数据:
点击“Edit/Preview data”后,您应该能够看到识别出的表结构;如果您选择的是自定义 SQL 方式,也可以在这里进行调整:
请确保在 UI 左下角选择了“Direct Query”模式:
现在,您可以继续发布数据集并创建新的可视化!

已知限制

  • SPICE 导入未能如预期正常工作;请改用 Direct Query 模式。参见 #58553
最后修改于 2026年6月25日