Tableau Online

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

ClickHouse Cloud 设置

创建 ClickHouse Cloud 服务后，在凭据屏幕上，选择 MySQL 选项卡
切换开关以为此特定服务启用 MySQL 接口。这将为此服务公开端口 3306，并提示您使用包含唯一 MySQL 用户名的 MySQL 连接屏幕。密码将与服务的默认用户密码相同。或者，为了为现有服务启用 MySQL 接口
确保您的服务处于 运行中 状态，然后单击要为其启用 MySQL 接口的服务的“查看连接字符串”按钮
切换开关以为此特定服务启用 MySQL 接口。这将提示您输入默认密码。
输入密码后，您将获得此服务的 MySQL 连接字符串提示

在 ClickHouse Cloud 中创建多个 MySQL 用户

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

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

提示

对于像 foobar.us-east1.aws.clickhouse.cloud 这样的 ClickHouse Cloud 主机名，<subdomain> 部分等于 foobar，自定义 MySQL 用户名可能如下所示：mysql4foobar_team1。

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

可选 - 创建一个设置配置文件以应用于您的自定义用户。例如，my_custom_profile 带有一个额外的设置，当我们使用稍后创建的用户连接时，此设置将默认应用
```
CREATE SETTINGS PROFILE my_custom_profile SETTINGS prefer_column_name_to_alias=1;
```
prefer_column_name_to_alias 仅用作示例，您可以在其中使用其他设置。
创建用户使用以下格式：mysql4<subdomain>_<username>（参见上文）。密码必须采用双 SHA1 格式。例如
```
CREATE USER mysql4foobar_team1 IDENTIFIED WITH double_sha1_password BY 'YourPassword42$';
```
或者如果您想为此用户使用自定义配置文件
```
CREATE USER mysql4foobar_team1 IDENTIFIED WITH double_sha1_password BY 'YourPassword42$' SETTINGS PROFILE 'my_custom_profile';
```
其中 my_custom_profile 是您之前创建的配置文件的名称。
授予新用户与所需表或数据库交互的必要权限。例如，如果您只想授予对 system.query_log 的访问权限
```
GRANT SELECT ON system.query_log TO mysql4foobar_team1;
```
使用创建的用户通过 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>

还需要为将使用 MySQL 接口的用户使用双 SHA1 密码加密。

从 shell 生成使用双 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>

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

此外，建议使用 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 Server 以侦听所需的 IP 地址。例如，在 config.xml 中，取消注释以下内容以侦听所有地址

<listen_host>::</listen_host> 

将 Tableau Online 连接到 ClickHouse（本地，无 SSL）

登录到您的 Tableau Cloud 站点并添加新的已发布数据源。

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

指定在 ClickHouse 设置期间收集的连接详细信息。

Tableau Online 将内省数据库并提供可用表的列表。将所需的表拖到右侧的画布上。此外，您可以单击“立即更新”以预览数据，以及微调内省的字段类型或名称。

之后，剩下的就是单击右上角的“发布为”，您应该能够像往常一样在 Tableau Online 中使用新创建的数据集。

注意：如果您想将 Tableau Online 与 Tableau Desktop 结合使用并在两者之间共享 ClickHouse 数据集，请确保您也使用具有默认 MySQL 连接器的 Tableau Desktop，请遵循此处显示的设置指南，如果您从数据源下拉列表中选择 MySQL。如果您使用的是 M1 Mac，请查看此故障排除线程以获取驱动程序安装解决方法。

将 Tableau Online 连接到 ClickHouse（云或本地设置，带 SSL）

由于无法通过 Tableau Online MySQL 连接设置向导提供 SSL 证书，因此唯一的方法是使用 Tableau Desktop 设置连接，然后将其导出到 Tableau Online。但是，此过程非常简单。

在 Windows 或 Mac 计算机上运行 Tableau Desktop，然后选择“连接” -> “到服务器” -> “MySQL”。很有可能，您需要首先在您的计算机上安装 MySQL 驱动程序。如果您从数据源下拉菜单中选择 MySQL，则可以通过按照显示的设置指南此处进行操作。如果您使用的是 M1 Mac，请查看此故障排除线程，了解驱动程序安装的变通方法。

注意

在 MySQL 连接设置 UI 中，确保启用了“SSL”选项。 ClickHouse Cloud 的 SSL 证书由LetsEncrypt 签名。您可以在此处下载此根证书。

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

像往常一样选择所需表格（类似于 Tableau Online），然后选择“服务器” -> “发布数据源” -> Tableau Cloud。

重要：您需要在“身份验证”选项中选择“嵌入式密码”。

Data source publishing settings - embedding your credentials

此外，选择“更新工作簿以使用发布的数据源”。

Data source publishing settings - updating the workbook for online usage

最后，点击“发布”，您的包含嵌入式凭据的数据源将在 Tableau Online 中自动打开。

已知限制（ClickHouse 23.11）

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

Tableau Online

ClickHouse Cloud 设置​

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

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

本地 ClickHouse 服务器设置​

将 Tableau Online 连接到 ClickHouse（本地，无 SSL）​

将 Tableau Online 连接到 ClickHouse（云或本地设置，带 SSL）​

已知限制（ClickHouse 23.11）​