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

您需要获取 ByteHouse 企业版集群的集群连接地址、端口号、用户名、密码，用于后续在 Tableau 中配置连接信息，您可参考以下章节获取对应信息。

• 集群连接地址：集群网关信息，详情请参见下文获取网络域名。
• 端口号：使用 19000。更多端口信息请参见集群连接端口。
• 用户名：ByteHouse 服务的用户名，详情请参见下文获取账号与密码。
• 密码：ByteHouse 服务的密码，详情请参见下文获取账号与密码。

获取网络域名

集群连接地址即集群的网关信息。您可登录并进入 ByteHouse 控制台后，单击顶部集群管理，通过集群列表 > 集群详情 > 基本信息路径，查看网络信息模块的网关配置，根据您的环境复制私网或公网地址。

如果您尚未配置公网地址，可单击绑定公网 IP，选择已创建的公网 IP。如果无可用公网 IP，可创建公网 IP 或者刷新页面重试。创建公网 IP 的操作详情和费用可参考以下文档：

• 申请公网 IP
• 公网 IP - 计费概览

获取账号与密码

ByteHouse 企业版支持使用 IAM 子用户和数据库用户访问，二者的区别可参见用户类型，获取方式如下：

• IAM 子用户：您可登录 ByteHouse 企业版控制台，单击右上角 ByteHouse 个人中心，单击账号管理，查看并复制集群连接账号中的用户名，详情请参见获取集群连接信息。
• 数据库用户：您可登录 ByteHouse 企业版控制台，单击顶部权限管理，单击用户，在用户列表中查看用户类别为 Database 的用户，并复制该用户名。

ByteHouse 企业版使用 IAM 用户访问和数据库用户访问时使用的密码相同，均为 ByteHouse 集群连接密码，获取方式如下：
登录 ByteHouse 企业版控制台，单击右上角 ByteHouse 个人中心，单击账号管理，查看并复制集群连接账号中的密码，详情请参见获取集群连接信息。

步骤一：准备工作

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

2. 安装 ByteHouse JDBC 驱动。

   1. 下载最新版本 ByteHouse JDBC 驱动程序。

   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

步骤二：创建 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	ByteHouse 企业版集群连接地址。您可在集群管理 > 集群名称 > 基本信息 > 网络信息中查看并复制公网网关地址，详情请参见上文获取网络域名。
   Port	数据库端口号，配置为固定取值：19000。
   Username & Password	Username 为 ByteHouse 企业版用户名。您可单击右上角 ByteHouse 个人中心，单击账号管理，查看并复制集群连接账号中的用户名，详情请参见上文获取账号与密码。 Password 为 ByteHouse 企业版密码。您可单击右上角 ByteHouse 个人中心，单击账号管理，查看并复制集群连接账号中的密码，详情请参见上文获取账号与密码。
   SSL	打开 SSL 开关。 注意 ByteHouse 需要加密认证，从而保护数据安全，因此您需打开 SSL。

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

步骤三：结果验证

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