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

step1 配置公网域名

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

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

step2 获取API Key

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

step3 设置默认计算组

进入顶部租户管理的参数设置页面，查看已设置了默认计算组，并确保此计算组是正在运行的状态，未被停止。后续对接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. 在弹出的页面中配置连接信息。
   

   参数	配置说明
   Server	租户-{TENANT_ID}-{区域}-public.bytehouse.volces.com 配置为ByteHouse的公网域名，格式为：tenant-{TENANT_ID}-{REGION}-public.bytehouse.volces.com，您可以在ByteHouse控制台的租户管理>基本信息>网络信息中获取。
   Port	数据库端口号，配置为固定取值：19000
   Username & Password	登录ByteHouse数据库的用户名和密码。 用户名默认为 bytehouse。 密码为<API_Key>，可以在ByteHouse控制台的租户管理>连接信息中获取的API Key。
   SSL	打开SSL开关。 注意 ByteHouse 需要加密认证，从而保护数据安全，因此您需打开SSL。

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

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

step3 结果验证

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