> ## 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 可将 ClickHouse 数据库和表作为数据源使用。
# 将 Tableau 连接到 ClickHouse
export const ClickHouseSupportedBadge = () => {
return ;
};
export const Image = ({img, alt, size = "lg"}) => {
const normalizedSize = ["sm", "md", "lg"].includes(size) ? size : "lg";
return ;
};
ClickHouse 提供官方 Tableau 连接器，并已在
[Tableau Exchange](https://exchange.tableau.com/products/1064) 上架。
该连接器基于 ClickHouse 的高级 [JDBC 驱动](/docs/zh/integrations/language-clients/java/jdbc)。
借助此连接器，Tableau 可将 ClickHouse 数据库和表作为数据源进行集成。要启用此功能，
请按照下方的设置指南进行操作。
## 使用前的准备工作
1. 准备好连接详细信息
要通过 HTTP(S) 连接到 ClickHouse，你需要以下信息：
| Parameter(s) | Description |
| ------------------------------------------------------ | ------------------------------------------ |
| `HOST` and `PORT` | 通常，使用 TLS 时端口为 8443；不使用 TLS 时端口为 8123。 |
| `DATABASE NAME` | 默认情况下，存在一个名为 `default` 的数据库。请使用你要连接的数据库名称。 |
| `USERNAME` and `PASSWORD` | 默认情况下，用户名为 `default`。请根据你的使用场景使用相应的用户名。 |
| 你的 ClickHouse Cloud 服务的连接信息可在 ClickHouse Cloud 控制台中查看。 | |
| 选择一个服务，然后点击 **Connect**： | |
选择 **HTTPS**。连接信息会显示在示例 `curl` 命令中。
如果你使用的是自管理 ClickHouse，则连接信息由你的 ClickHouse 管理员配置。
2. 下载并安装 Tableau
Desktop。
3. 按照 `clickhouse-tableau-connector-jdbc` 的说明，下载兼容版本的
ClickHouse JDBC 驱动。
请确保下载 [clickhouse-jdbc-X.X.X-all-dependencies.jar](https://github.com/ClickHouse/clickhouse-java/releases) JAR 文件。该制品自版本 `0.9.2` 起提供。
4. 将 JDBC 驱动放到以下文件夹中 (根据操作系统选择；如果文件夹不存在，可以自行创建) ：
* macOS: `~/Library/Tableau/Drivers`
* Windows: `C:\Program Files\Tableau\Drivers`
5. 在 Tableau 中配置 ClickHouse 数据源，然后开始构建数据可视化！
## 在 Tableau 中配置 ClickHouse 数据源
现在你已经安装并配置好了 `clickhouse-jdbc` 驱动，接下来看看如何在 Tableau 中定义一个数据源，以连接到 ClickHouse 中的 **TPCD** 数据库。
1. 启动 Tableau。 (如果它已经在运行，请先重启。)
2. 在左侧菜单中，点击 **To a Server** 部分下的 **More**。在可用连接器列表中搜索 **ClickHouse by ClickHouse**：
在连接器列表中看不到 **ClickHouse by ClickHouse** 连接器？这可能与 Tableau Desktop 版本过旧有关。
要解决这个问题，可以考虑升级 Tableau Desktop，或者[手动安装该连接器](#install-the-connector-manually)。
3. 点击 **ClickHouse by ClickHouse**，随后会弹出以下对话框：
4. 点击 **Install and Restart Tableau**。重启应用程序。
5. 重启后，该连接器将显示其完整名称：`ClickHouse JDBC by ClickHouse, Inc.`。点击它后，会弹出以下对话框：
6. 输入连接详细信息：
| 设置 | 值 |
| -------- | ---------------------------------- |
| Server | **你的 ClickHouse 主机名 (不带任何前缀或后缀) ** |
| Port | **8443** |
| Database | **default** |
| Username | **default** |
| Password | \*\*\*\*\*\* |
使用 ClickHouse Cloud 时，必须勾选 SSL 复选框以启用安全连接。
我们的 ClickHouse database 名为 **TPCD**，但你必须在上面的对话框中将 **Database** 设为 **default**，然后
在下一步中将 **Schema** 选择为 **TPCD**。 (这很可能是连接器中的一个 bug 导致的，因此这种行为
以后可能会改变，但目前你必须使用 **default** 作为 database。)
7. 点击 **Sign In** 按钮后，你应该会看到一个新的 Tableau 工作簿：
8. 从 **Schema** 下拉菜单中选择 **TPCD**，你应该会看到 **TPCD** 中的表列表：
现在你已经可以在 Tableau 中构建一些可视化了！
## 在 Tableau 中创建可视化
现在我们已经在 Tableau 中配置好了 ClickHouse 数据源，接下来就来将数据可视化……
1. 将 **CUSTOMER** 表拖到工作簿中。注意，列已经显示出来了，但数据表还是空的：
2. 点击 **Update Now** 按钮后，**CUSTOMER** 中的 100 行数据就会填充到表中。
3. 将 **ORDERS** 表拖入工作簿，然后将 **Custkey** 设置为这两个表之间的关联字段：
4. 现在，**ORDERS** 和 **LINEITEM** 表已经作为你的数据源关联起来了，因此你可以利用
这种关系来回答与数据相关的问题。选择工作簿底部的 **Sheet 1** 选项卡。
5. 假设你想了解每年订购了多少特定商品。将 **ORDERS** 中的 **OrderDate** 拖到
**Columns** 区域 (横向字段) ，然后将 **LINEITEM** 中的 **Quantity** 拖到 **Rows**。Tableau 会
生成如下折线图：
这并不是一张特别精彩的折线图，不过这个数据集是由脚本生成、专门用于测试查询性能的，所以
你会发现 TCPD 数据中的模拟订单变化并不大。
6. 假设你想了解按季度统计的平均订单金额 (美元) ，以及按运输方式 (空运、邮件、海运、
卡车等) 细分的结果：
* 点击 **New Worksheet** 选项卡以创建新工作表
* 将 **ORDERS** 中的 **OrderDate** 拖到 **Columns** 中，并将其从 **Year** 改为 **Quarter**
* 将 **LINEITEM** 中的 **Shipmode** 拖到 **Rows** 中
你应该会看到如下内容：
7. **Abc** 值只是用来暂时填补空白区域，直到你将某个指标拖到表中。将 **Totalprice** 从 \*
*ORDERS*\* 拖到表上。注意，默认计算方式是对 **Totalprices** 执行 **SUM**：
8. 点击 **SUM**，将 **Measure** 改为 **Average**。在同一个下拉菜单中，选择 **Format**，然后将
**Numbers** 改为 **Currency (Standard)**：
做得好！你已经成功将 Tableau 连接到 ClickHouse，也为分析和可视化 ClickHouse 数据
打开了更广阔的空间。
## 手动安装连接器
如果您使用的 Tableau Desktop 版本较旧，默认未包含该连接器，可以按照以下步骤手动安装：
1. 从 [Tableau Exchange](https://exchange.tableau.com/products/1064) 下载最新的 taco 文件
2. 将 taco 文件放到以下位置：
* macOS: `~/Documents/My Tableau Repository/Connectors`
* Windows: `C:\Users\[Windows User]\Documents\My Tableau Repository\Connectors`
3. 重启 Tableau Desktop。若安装成功，您将在 `New Data Source` 部分看到该连接器。
## 连接与分析提示
如需进一步了解如何优化 Tableau 与 ClickHouse 的集成，
请参阅[连接提示](/docs/zh/integrations/connectors/data-visualization/tableau/tableau-connection-tips)和[分析提示](/docs/zh/integrations/connectors/data-visualization/tableau/tableau-analysis-tips)。
## 测试
该连接器目前使用 [TDVT 框架](https://tableau.github.io/connector-plugin-sdk/docs/tdvt) 进行测试，当前覆盖率为 97%。
## 摘要
您可以使用通用的 ODBC/JDBC ClickHouse 驱动程序将 Tableau 连接到 ClickHouse。不过，此连接器可简化连接设置流程。如果您在使用该连接器时遇到任何问题，欢迎通过 GitHub 与我们联系。
