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

Tableau Online

Tableau Online 可以通过官方 MySQL 数据源使用 MySQL 接口连接到 ClickHouse Cloud 或本地 ClickHouse 设置。

ClickHouse Cloud 设置

选择 连接您的应用

在创建您的 ClickHouse Cloud 服务后,在 连接您的应用 屏幕上,从下拉菜单中选择 MySQL。

ClickHouse Cloud 凭据屏幕显示 MySQL 接口选择下拉菜单

启用 MySQL 接口

切换开关以启用此特定服务的 MySQL 接口。 这将为该服务暴露端口 3306,并提示您输入包含您唯一 MySQL 用户名的 MySQL 连接屏幕。

ClickHouse Cloud MySQL 接口启用开�关和连接详细信息

另外,为了为现有服务启用 MySQL 接口:

选择 连接

确保您的服务处于 运行 状态,然后点击您想启用 MySQL 接口的服务。 从左侧菜单中选择 "连接":

ClickHouse Cloud 服务连接屏幕,突出显示连接选项

选择 MySQL

连接方式 下拉菜单中选择 MySQL

ClickHouse Cloud 连接屏幕显示 MySQL 选项选择

启用 MySQL 接口

切换开关以启用此特定服务的 MySQL 接口。 这将为该服务暴露端口 3306,并提示您输入包含您唯一 MySQL 用户名的 MySQL 连接屏幕。

ClickHouse Cloud 连接屏幕,MySQL 接口启用,显示连接详细信息

在 ClickHouse Cloud 中创建只读 MySQL 用户

ClickHouse Cloud 自动创建一个 mysql4<subdomain> 用户,该用户与默认用户共享相同的密码。 <subdomain> 部分对应于您 ClickHouse Cloud 主机名的第一部分。

这种用户名格式对于兼容那些建立安全连接但在 TLS 握手中未包含 SNI (服务器名称指示) 数据的工具是必需的。 没有 SNI 信息,系统无法执行正确的内部路由,因此嵌入在用户名中的子域提示提供了必要的路由信息。 MySQL 控制台客户端就是一个需要此信息的工具的例子。

提示

推荐的最佳实践是创建一个新的只读 MySQL 用户。

备注

对于像 foobar.us-east1.aws.clickhouse.cloud 的 ClickHouse Cloud 主机名,<subdomain> 部分等于 foobar,那么自定义 MySQL 用户名可以是 mysql4foobar_team1

创建只读设置配置文件

创建一个 设置配置文件 以应用于您的只读用户,将 readonly 设置为 1

CREATE SETTINGS PROFILE readonly_profile SETTINGS readonly = 1

创建一个新的只读 MySQL 用户

创建用户,使用以下格式命名:

mysql4<subdomain>_<username>

readonly_profile 应用到新用户,并确保密码采用双重 SHA1 格式。例如:

CREATE USER mysql4foobar_readonly
IDENTIFIED WITH double_sha1_password BY 'YourPassword42$'
SETTINGS PROFILE 'readonly_profile';

授予新用户访问所需表的权限

授予 新用户与所需表或数据库进行交互的必要权限。 例如,如果您只想授予对 system.query_log 的访问权限:

GRANT SELECT ON system.query_log TO mysql4foobar_readonly;
备注

对于只读用户,确保只授予所需访问表的 SELECT 权限。

新创建的用户可以使用 MySQL 接口连接到您的 ClickHouse Cloud 服务。

在 ClickHouse Cloud 中故障排除多个 MySQL 用户

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

ERROR 2013 (HY000): Lost connection to MySQL server at 'reading authorization packet', system error: 54

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

本地 ClickHouse 服务器设置

请参阅 官方文档 关于如何设置一个启用 MySQL 接口的 ClickHouse 服务器。

除了在服务器的 config.xml 中添加条目

<clickhouse>
    <mysql_port>9004</mysql_port>
</clickhouse>

之外,还必须使用 双 SHA1 密码加密 为将要使用 MySQL 接口的用户。

从命令行生成一个使用双 SHA1 加密的随机密码:

PASSWORD=$(base64 < /dev/urandom | head -c16); echo "$PASSWORD"; echo -n "$PASSWORD" | sha1sum | tr -d '-' | xxd -r -p | sha1sum | tr -d '-'

输出应该如下所示:

LZOQYnqQN4L/T6L0
fbc958cc745a82188a51f30de69eebfc67c40ee4

第一行是生成的密码,第二行是我们可以用来配置 ClickHouse 的哈希值。

以下是使用生成的哈希值的 mysql_user 示例配置:

/etc/clickhouse-server/users.d/mysql_user.xml

<users>
    <mysql_user>
        <password_double_sha1_hex>fbc958cc745a82188a51f30de69eebfc67c40ee4</password_double_sha1_hex>
        <networks>
            <ip>::/0</ip>
        </networks>
        <profile>default</profile>
        <quota>default</quota>
    </mysql_user>
</users>

用您自己生成的双 SHA1 哈希值替换 password_double_sha1_hex 条目。

此外,建议使用 use_mysql_types_in_show_columns 来在 SHOW [FULL] COLUMNS 查询结果中显示本地 MySQL 类型,而不是 ClickHouse 类型,这样可以让 BI 工具在使用 MySQL 连接器时正确探测数据库架构。

例如:

/etc/clickhouse-server/users.d/mysql_user.xml

<profiles>
    <default>
        <use_mysql_types_in_show_columns>1</use_mysql_types_in_show_columns>
    </default>
</profiles>

或者将其分配给一个不同的配置文件,而不是默认配置文件。

如果您有 mysql 二进制文件可用,您可以从命令行测试连接。使用上面示例中的用户名(mysql_user)和密码(LZOQYnqQN4L/T6L0),命令行将是:

mysql --protocol tcp -h localhost -u mysql_user -P 9004 --password=LZOQYnqQN4L/T6L0
mysql> show databases;
+--------------------+
| name               |
+--------------------+
| INFORMATION_SCHEMA |
| default            |
| information_schema |
| system             |
+--------------------+
4 rows in set (0.00 sec)
Read 4 rows, 603.00 B in 0.00156 sec., 2564 rows/sec., 377.48 KiB/sec.

最后,配置 ClickHouse 服务器以在所需的 IP 地址上监听。例如,在 config.xml 中,取消注释以下内容以在所有地址上监听:

<listen_host>::</listen_host> 

将 Tableau Online 连接到 ClickHouse(本地,无 SSL)

登录到您的 Tableau Cloud 网站,添加一个新的发布数据源。

Tableau Online 界面,显示用于创建发布数据源的 '新建' 按钮

从可用连接器列表中选择 "MySQL"。

Tableau Online 连接器选择屏幕,突出显示 MySQL 选项

指定您在 ClickHouse 设置过程中收集的连接详细信息。

Tableau Online MySQL 连接配置屏幕,显示服务器、端口、数据库和凭证字段

Tableau Online 将自动检查数据库并提供可用表的列表。将所需的表拖动到右侧画布上。此外,您可以单击 "立即更新" 以预览数据,并微调检查到的字段类型或名称。

Tableau Online 数据源页面,左侧显示数据库表,右侧画布上带有拖放功能

之后,您只需在右上角点击 "作为发布",就可以像往常一样在 Tableau Online 中使用新创建的数据集。

注意:如果您希望在 Tableau Online 和 Tableau Desktop 之间共享 ClickHouse 数据集,请确保您在 Tableau Desktop 中也使用默认的 MySQL 连接器,并按照在数据源下拉菜单中选择 MySQL 时显示的 此处 的设置指南进行操作。如果您使用的是 M1 Mac,请查看 此故障排除线程 以获取驱动程序安装解决方案。

将 Tableau Online 连接到 ClickHouse(云或本地设置,带 SSL)

由于无法通过 Tableau Online MySQL 连接设置向导提供 SSL 证书,唯一的方法是使用 Tableau Desktop 设置连接,然后导出到 Tableau Online。然而,这个过程相对简单。

在 Windows 或 Mac 机器上运行 Tableau Desktop,选择 "连接" -> "到服务器" -> "MySQL"。可能需要先在您的机器上安装 MySQL 驱动程序。您可以通过在数据源下拉菜单中选择 MySQL 时显示的 此处 的设置指南进行操作。如果您使用的是 M1 Mac,请查看 此故障排除线程 以获取驱动程序安装解决方案。

Tableau Desktop 界面,显示连接菜单,突出显示 MySQL 选项

备注

在 MySQL 连接设置 UI 中,请确保启用 "SSL" 选项。 ClickHouse Cloud 的 SSL 证书由 Let's Encrypt 签名。 您可以在 此处 下载此根证书。

提供您的 ClickHouse Cloud 实例的 MySQL 用户凭证和下载的根证书的路径。

Tableau Desktop MySQL 连接对话框,启用 SSL 选项,显示服务器、用户名、密码和证书字段

像往常一样选择所需的表(类似于 Tableau Online), 然后选择 "服务器" -> "发布数据源" -> Tableau Cloud。

Tableau Desktop 显示服务器菜单,突出显示发布数据源选项

重要提示:您需要在 "身份验证" 选项中选择 "嵌入密码"。

Tableau Desktop 发布对话框,显示身份验证选项,已选择嵌入密码

此外,选择 "更新工作簿以使用发布的数据源"。

Tableau Desktop 发布对话框,选中 '更新工作簿以使用发布的数据源' 选项

最后,点击 "发布",您的数据源将自动在 Tableau Online 中以嵌入凭证的方式打开。

已知限制(ClickHouse 23.11)

在 ClickHouse 23.11 中修复了所有已知限制。如果您遇到任何其他不兼容问题,请随时 联系我们 或创建一个 新问题