Tableau是 Salesforce 开发的一个数据可视化平台，用于可视化数据、交互式仪表板和 KPI 记分卡。本文为您介绍如何使用 Tableau 连接 ByteHouse 并进行数据查询分析。

数据库用户功能为 Beta 功能，如需使用数据库用户连接，请联系提交工单或联系 ByteHouse 团队获取白名单权限。

ByteHouse 支持通过 IAM 用户或数据库用户连接，您在使用该工具前，请先配置好用户账号相关信息。IAM 用户和数据库用户的区别请参考ByteHouse权限管控概述。

step1 配置网络域名

登录并进入 ByteHouse 控制台后，在顶部租户管理的基本信息页面，查看网络组配置，确认已绑定 VPC，并绑定了公网域名。

• 如果未绑定 VPC 和公网域名，需参考设置网络信息文档完成绑定配置。
• 完成绑定后，可单击复制公网域名，用于后续对接参数配置。

step2 设置默认计算组

进入顶部租户管理的参数设置页面，查看已设置了默认计算组，并确保此计算组是正在运行的状态，未被停止。后续对接 ByteHouse 后的数据查询等操作，即会使用此处配置的默认计算组。

step 3 获取连接串的用户及密码信息

使用 IAM 用户连接

IAM 用户使用 API Key 作为连接密码，您可进入顶部租户管理的连接信息页面，在 API Key 模块新建一个 API key，并将 API Key 保存至本地，用于后续的配置使用。

使用数据库用户连接

数据库用户的账号使用 ByteHouse 账号、数据库用户名、账号、环境 ID（可选）拼接而成，格式为{accountID_or_accountName}::{username}[::{envID}]。密码为数据库用户的密码。

获取账号信息

登录并进入 ByteHouse 控制台后，单击右上角个人中心查看并复制账号 ID 或名称。

配置数据库用户及密码

登录并进入 ByteHouse 控制台，在顶部权限管理下的用户页面，查看用户列表，筛选用户类别为数据库的用户，查看并复制数据库用户名。如果尚未创建数据库用户，可联系管理员参考管理数据库用户创建。
数据库用户的密码为管理员配置，可联系管理员获取对应的密码。如果密码丢失或遗忘，可联系管理员重置密码，详情请参考重置密码。

（可选）获取环境信息

如果使用 default 环境，可不配置，如需使用其他环境，需指定环境名称。您可登录并进入 ByteHouse 控制台后，在顶部租户管理下的基本信息页面，查看当前环境名称。

step1 准备工作

1. 下载并安装 Tableau 客户端。

2. 安装 ByteHouse JDBC 驱动。

   1. 下载 ByteHouse JDBC 驱动程序（v1.1.73 或以上版本）。

   2. 将 JDBC 驱动程序存储在以下文件夹中（如果该文件夹不存在，先创建好文件夹）。

      OS	路径
      windows	C:\Program Files\Tableau\Drivers
      mac	~/Library/Tableau/Drivers

3. 安装 ClickHouse Tableau Connector。

   1. 如果您使用的是最新的Tableau Desktop，默认情况下应该具有 ClickHouse 连接器。如果您使用的是旧版本，请先下载 ClickHouseConnector（v0.3.1）。
      

   2. 将连接器（taco文件）放在以下文件夹中：

      OS	路径
      windows	C:\Users\[Windows User]\Documents\My Tableau Repository\Connectors
      mac	~/Documents/My Tableau Repository/Connectors

step2 创建 ByteHouse 数据源

1. 启动Tableau Desktop并单击 To a Server > More。
   

2. 搜索并单击 ClickHouse by ClickHouse。
   

3. 单击Install and Restart Tableau来安装 ClickHouse 连接器。安装完成后重启Tableau Desktop。
   

4. 重启后，在 To a Server > More 下搜索并单击 ClickHouseJDBC byClickHouse。
   

5. 在弹出的页面中配置连接信息。
   

   参数	使用 IAM 用户连接	使用数据库用户连接
   Server	tenant-{TENANT_ID}-{REGION}-public.bytehouse.volces.com，您可以在 ByteHouse 控制台的租户管理>基本信息>网络信息中获取，详情请参见上文step1 配置公网域名。
   Port	数据库端口号，配置为固定取值：19000。
   Username & Password	Username 默认为 bytehouse。 Password 为 <API_Key>，可以在 ByteHouse 控制台>租户管理>连接信息中获取的 API Key，详情请参见上文使用 IAM 用户连接。	Username 由 {accountID_or_accountName}::{username}[::{envID}] 构成，详情请参见上文使用数据库用户连接： accountID_or_accountName：指火山引擎用户账号 ID 或名称，可登录 ByteHouse 控制台，单击右上角个人中心查看并复制账号ID 或名称。 username：登录 ByteHouse 数据库账号用户名。可在 ByteHouse 控制台>权限管理>用户>查看数据库用户名。 envID：可选配置，数据库所在的环境名称。如果使用 default 环境，可不配置，如需使用其他环境，需指定环境名称。您可登录 ByteHouse 控制台，在租户管理>基本信息>**当前环境 **中获取。 password：数据库账号的密码由管理员创建数据库账号时自定义配置，您可联系管理员获取密码。如果密码丢失或遗忘，可通联系管理员重置密码，详情请参考重置密码。
   SSL	打开 SSL 开关。 注意 ByteHouse 需要加密认证，从而保护数据安全，因此您需打开 SSL。

6. （可选）如果您有多个计算组，希望后续查询 ByteHouse 数据时使用指定计算组，您可以在 Advanced 中指定具体的计算组。配置示例如下。
   

7. 单击 Sign In，完成数据源创建。

step3 结果验证

完成 ByteHouse 数据源创建后，您可以在 ByteHouse 数据源中看到空的 Tableau 工作簿，你可在此页面中开始进行数据查询与分析。