> ## Documentation Index
> Fetch the complete documentation index at: https://clickhouse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.
> Tableau Online 汇聚数据的力量，让用户无论身在何处都能更高效、更自信地做出决策。
# Tableau Online
export const Image = ({img, alt, size = "lg"}) => {
const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
return ;
};
Tableau Online 可以使用官方 MySQL 数据源，通过 MySQL 接口连接到 ClickHouse Cloud 或本地部署的 ClickHouse。
## ClickHouse Cloud 配置
选择 Connect your app} id="select-connect-your-app">
创建 ClickHouse Cloud 服务后，在 `Connect your app` 页面上，从下拉列表中选择 MySQL。
切换开关，为此特定服务启用 MySQL 接口。
这会为该服务开放端口 `3306`，并显示 MySQL 连接页面，其中包含你专属的 MySQL 用户名。
或者，如需为现有服务启用 MySQL 接口：
选择 Connect} id="select-connect">
确保你的服务处于 `Running` 状态，然后点击你要为其启用 MySQL 接口的服务。
从左侧菜单中选择 “Connect”：
选择 MySQL} id="choose-mysql">
从 `Connect With` 下拉列表中选择 `MySQL`。
切换开关，为此特定服务启用 MySQL 接口。
这会为该服务开放端口 `3306`，并显示 MySQL 连接页面，其中包含你专属的 MySQL 用户名。
## 在 ClickHouse Cloud 中创建只读 MySQL 用户
ClickHouse Cloud 会自动创建一个 `mysql4` 用户，该用户与默认用户使用相同的密码。
`` 部分对应你的 ClickHouse Cloud 主机名的第一部分。
这种用户名格式是为了兼容那些会建立安全连接、但在 TLS 握手中不包含 [SNI (Server Name Indication)](https://www.cloudflare.com/learning/ssl/what-is-sni) 数据的工具。
如果没有 SNI 信息，系统就无法进行正确的内部路由，因此嵌入用户名中的子域名提示会提供所需的路由信息。
MySQL 控制台客户端就是一个需要这种格式的工具示例。
建议的最佳实践是新建一个只读 MySQL 用户。
对于 `foobar.us-east1.aws.clickhouse.cloud` 这样的 ClickHouse Cloud 主机名，`` 部分就是 `foobar`，自定义 MySQL 用户名可以是 `mysql4foobar_team1` 这样的形式。
创建一个要应用于只读用户的 [settings profile](/docs/zh/reference/statements/create/settings-profile)，
将 `readonly` setting 设为 `1`：
```sql theme={null}
CREATE SETTINGS PROFILE readonly_profile SETTINGS readonly = 1
```
[创建用户](/docs/zh/reference/statements/create/user)，名称需遵循以下格式：
```sql theme={null}
mysql4_
```
将 `readonly_profile` 应用于新用户，并确保密码采用 double SHA1 格式。例如：
```sql theme={null}
CREATE USER mysql4foobar_readonly
IDENTIFIED WITH double_sha1_password BY 'YourPassword42$'
SETTINGS PROFILE 'readonly_profile';
```
向新用户 [授予](/docs/zh/reference/statements/grant) 访问目标表或数据库所需的权限。
例如，如果你只想授予对 `system.query_log` 的访问权限：
```sql theme={null}
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_` 格式，如[上文](#creating-multiple-mysql-users-in-clickhouse-cloud)所述。
## 本地部署 ClickHouse 服务器设置
请参阅[官方文档](/docs/zh/concepts/features/interfaces/mysql)
了解如何配置启用 MySQL 接口的 ClickHouse server。
除了在服务器的 `config.xml` 中添加一项配置之外
```xml theme={null}
9004
```
对于将使用 MySQL interface 的用户，还*必须*使用
[Double SHA1 密码加密](/docs/zh/concepts/features/configuration/settings/settings-users#user-namepassword)。
在 shell 中生成一个经 Double SHA1 加密的随机密码：
```shell theme={null}
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`
```xml theme={null}
fbc958cc745a82188a51f30de69eebfc67c40ee4
::/0
default
default
```
将 `password_double_sha1_hex` 项替换为你自己生成的 Double SHA1 哈希值。
此外，建议使用 `use_mysql_types_in_show_columns`
以便在 `SHOW [FULL] COLUMNS` 查询结果中显示 MySQL 原生类型，而不是 ClickHouse 类型，
这样 BI 工具在使用 MySQL 连接器时便能正确识别数据库 schema。
例如：
`/etc/clickhouse-server/users.d/mysql_user.xml`
```xml theme={null}
1
```
或者将其分配给其他 profile，而不是默认 profile。
如果你有可用的 `mysql` 可执行文件，就可以通过命令行测试连接。
使用上面的示例用户名 (`mysql_user`) 和密码 (`LZOQYnqQN4L/T6L0`) ，命令行如下所示：
```bash theme={null}
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` 中，取消以下内容的注释，以监听所有地址：
```bash theme={null}
::
```
## 将 Tableau Online 连接到 ClickHouse (本地部署且不使用 SSL)
登录 Tableau Cloud 站点，并添加一个新的已发布数据源。
从可用连接器列表中选择“MySQL”。
填写在设置 ClickHouse 时收集到的连接详细信息。
Tableau Online 会自动识别数据库结构，并提供可用表列表。将所需的表拖到右侧画布上。此外，还可以点击“Update Now”预览数据，并进一步调整自动识别出的字段类型或名称。
完成后，只需点击右上角的“Publish As”，即可像往常一样在 Tableau Online 中使用新创建的数据集。
注意：如果希望将 Tableau Online 与 Tableau Desktop 配合使用，并在两者之间共享 ClickHouse 数据集，请确保在 Tableau Desktop 中也使用默认的 MySQL 连接器，并按照从数据源下拉菜单中选择 MySQL 后 [此处](https://www.tableau.com/support/drivers) 显示的设置指南进行操作。如果使用的是 M1 Mac，请查看[这篇故障排查讨论](https://community.tableau.com/s/question/0D58b0000Ar6OhvCQE/unable-to-install-mysql-driver-for-m1-mac)，了解驱动安装的替代方法。
## 将 Tableau Online 连接到 ClickHouse (Cloud 或本地部署，启用 SSL)
由于无法在 Tableau Online 的 MySQL 连接设置向导中提供 SSL 证书，
唯一的办法是先使用 Tableau Desktop 配置连接，再将其导出到 Tableau Online。不过，这个过程其实相当简单。
在 Windows 或 Mac 设备上运行 Tableau Desktop，然后依次选择 "Connect" -> "To a Server" -> "MySQL"。
通常，你需要先在本机安装 MySQL 驱动。
如果你在 Data Source 下拉菜单中选择 MySQL，即可按照[这里](https://www.tableau.com/support/drivers)显示的设置指南进行设置。
如果你使用的是 M1 Mac，请查看[这个故障排查讨论串](https://community.tableau.com/s/question/0D58b0000Ar6OhvCQE/unable-to-install-mysql-driver-for-m1-mac)，了解安装 驱动 的替代方法。
在 MySQL 连接设置 UI 中，请确保已启用 "SSL" 选项。
ClickHouse Cloud 的 SSL 证书由 [Let's Encrypt](https://letsencrypt.org/certificates/) 签发。
你可以在[这里](https://letsencrypt.org/certs/isrgrootx1.pem)下载该根证书。
输入你的 ClickHouse Cloud 实例的 MySQL 用户 credentials，以及已下载根证书的 path。
像平常一样选择所需的表 (与 Tableau Online 中的操作类似) ，
然后依次选择 "Server" -> "Publish Data Source" -> Tableau Cloud。
重要提示：你需要在 "Authentication" 选项中选择 "Embedded password"。
此外，选择 "Update workbook to use the 已发布数据源"。
最后，点击 "Publish"，嵌入了 credentials 的数据源会自动在 Tableau Online 中打开。
## 已知限制 (ClickHouse 23.11)
所有已知限制均已在 ClickHouse `23.11` 中修复。如果您遇到任何其他兼容性问题，请随时[联系我们](https://clickhouse.com/company/contact)或提交一个[新 issue](https://github.com/ClickHouse/ClickHouse/issues)。
