# 配置Tableau Server连接AI DataLake Spark进行数据查询和分析
本文档介绍Windows和Linux环境下，如何通过安装Tableau Server并配置华为云AI DataLake驱动及Tableau连接器，实现Tableau Server连接Spark数据源进行数据查询与分析。
#### 工具包准备
| **工具名称**                          | **说明**                         |
|:---|:---|
| Tableau Desktop                   | Tableau客户端工具                   |
| aidatalake-spark-jdbc-x.x.x.jar   | 华为云AI DataLake Spark JDBC驱动    |
| aidatalake-spark-tableau-x.xx.zip | Tableau AI DataLake Spark连接器插件 |
   
#### 注意事项
- Tableau Server必须指定连接器安装路径，否则无法识别AI DataLake连接器。
- JDBC驱动必须放置在Tableau Drivers目录下。
- 路径中包含空格时，必须使用双引号包裹。
- 请确保网络可访问华为云AI DataLake Endpoint。
 
#### 步骤1：安装Tableau Server
1. 访问[Tableau Server](https://www.tableau.com/support/releases/server)下载页面，获取Tableau Server安装包。
2. 以具有管理员权限的用户身份登录到要安装Tableau Server的计算机，然后安装文件。
3. 按照安装向导完成以下操作：
   - 设置安装目录（建议使用默认路径）
   
   - 选择安装类型（典型或自定义）
   
   - 使用运行授权 (ATR) 服务激活Tableau Server
    
4. 打开cmd，输入tsm version检查tsm是否安装成功 返回tsm和Tableau Server的版本号说明安装成功。
   
 
#### 步骤2：配置AI DataLake Spark JDBC驱动
1. 单击[aidatalake-spark-jdbc-x.x.x.jar](https://ai-datalake-sdk.obs.cn-north-4.myhuaweicloud.com:443/aidatalake-java-sdk/spark/aidatalake-spark-sdk-1.0-261027.tar.gz)获取JDBC驱动。
2. 找到Tableau Server安装目录，默认路径如下： 
   - Windows ：C:\\Program Files\\Tableau\\Tableau Server
   
   - Linux：/opt/tableau/tableau_server
   
   
   
   
3. 返回上一级目录，进入驱动器目录（如果没有，您需要新建） 
   - Windows进入Drivers目录
   
   - Linux进入tableau_driver/jdbc目录
   
   
   
   
4. 将JDBC驱动jar包复制到该目录下 
   文件存放示例
   Windows：
   Drivers
   ├─aidatalake-spark-jdbc-x.x.x.jar
   Linux
   tableau_driver
   ├─ jdbc
   └─aidatalake-spark-jdbc-x.x.x.jar
   
   
更多详情请参见[安装Tableau Server包并启动Tableau服务管理器](https://help.tableau.com/current/server-linux/en-us/jumpstart.htm)。
#### 步骤3：配置AI DataLake Spark Tableau连接器
1. 单击[aidatalake-tableau-x.x.x.zip](https://ai-datalake-sdk.obs.cn-north-4.myhuaweicloud.com:443/aidatalake-java-sdk/spark/aidatalake-spark-sdk-1.0-261030.tar.gz)获取连接器压缩包。
2. 解压压缩包，得到aidatalake-tableau-1.0.0目录。
3. 将上述文件放入以下目录（也可以放置到任意目录下）：
   - Windows: C:\\Program Files\\Tableau\\Connectors
   
   - Linux: /opt/tableau/connectors
     图1目录结构   
     ![](https://support.huaweicloud.com/bestpractice-aidatalake/zh-cn_image_0000002782631876.png) 
    
4. 设置native_api.connect_plugins_path。
   表1设置native_api.connect_plugins_path 
   | 类别       | 配置说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
   |:---|:---|
   | Windows | 1. 配置参数。 tsm configuration set -k native_api.connect_plugins_path -v "C:\\Program Files\\Tableau\\Connectors" 如果在此步骤中出现配置错误，请尝试将该**--force-keys**选项添加到命令末尾   2. 查看待生效的参数列表。 tsm pending-changes list   3. 应用待处理的配置更改。 tsm pending-changes apply 这将重启服务器，会提示是否重启服务器，输入y                                                                                                                       |
   | Linux     | 1. 配置参数 tsm configuration set -k native_api.connect_plugins_path -v /opt/tableau/connectors tsm configuration set -k native_api.disable_connectors_security -v true 如果在此步骤中出现配置错误，请尝试将该**--force-keys**选项添加到命令末尾   2. 查看待生效的参数列表 tsm pending-changes list   3. 应用待处理的配置更改。 tsm pending-changes apply 这将重启服务器，会提示是否重启服务器，输入y。如果未重启，则执行tsm restart手动重启**。**    |
      
   
 
#### 步骤4：登录Tableau Server管理区域
1. 输入http://\<服务器ip\> 后回车。
2. 输入您在完成Tableau Server安装时创建的服务器管理员凭据。 
   图2输入管理员凭据   
   ![](https://support.huaweicloud.com/bestpractice-aidatalake/zh-cn_image_0000002795076765.png "点击放大")
   
   
3. 在左侧单击"New"\>"Published Data Source"。 
   图3单击Published Data Source   
   ![](https://support.huaweicloud.com/bestpractice-aidatalake/zh-cn_image_0000002753438867.png "点击放大")
   
   
4. 在连接器下可以找到SparkSql，单击"AIDataLake Spark JDBC by HuaweiCloud"**。**
   
   图4单击AIDataLake Spark JDBC by HuaweiCloud   
   ![](https://support.huaweicloud.com/bestpractice-aidatalake/zh-cn_image_0000002723679178.png "点击放大")
   
   
5. 配置Tableau Server连接AI DataLake信息 
   图5配置连接信息   
   ![](https://support.huaweicloud.com/bestpractice-aidatalake/zh-cn_image_0000002750169188.png "点击放大")
   表2Tableau Server连接AI DataLake参数说明 
   | **字段**      | **填写内容**                                                                                 |
   |:---|:---|
   | Server      | 服务器地址，格式如下： {AIDataLake Spark Endpoint}/{ProjectID} |
   | username    | 自定义用户名。                                                                                  |
   | Password | 用户密码。                                                                               |
      
   其中服务器中涉及的参数说明如下。
   表3服务器地址参数说明 
   | 参数                             | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      | 配置样例                                                                                      |
   |:---|:---|:---|
   | AIDataLake Spark Endpoint URL | AI DataLake服务的Url。 终端节点即调用API的请求地址，不同服务不同区域的终端节点不同，您可以从[地区和终端节点](https://console.huaweicloud.com/apiexplorer/#/endpoint/DataArtsFabric)中查询服务的终端节点。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | https://aidatalake-test.cn-north-7.myhuaweicloud.com       |
   | ProjectID                     | AI DataLake资源所在的项目ID。 鼠标悬浮在[AI DataLake管理控制台](https://console.huaweicloud.com/fabric/)页面右上角账号信息位置，单击"我的凭证"，在"项目列表"区域获取的目标项目ID信息。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | 0b33ea2a7e\*\*\*\*\*\*4c009bb05076d                         |
   | workspaceId                      | AI DataLake工作空间ID。 登录[AI DataLake管理控制台](https://console.huaweicloud.com/fabric/)，在"工作空间管理"页面找到目标工作空间ID。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         | spark                                                         |
   | lakeformationInstanceId                                     | LakeFormation实例ID。 获取方法请参见[如何获取LakeFormation实例ID](https://support.huaweicloud.com/lakeformation_faq/lakeformation_05_0007.html)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              | ae6dd098-\*\*\*-\*\*\*\*\*-c02\*\*\*def36d                                                  |
   | endpointName                                                   | AI DataLake服务的Spark端点名称。 登录[AI DataLake管理控制台](https://console.huaweicloud.com/fabric/)，在"引擎端点"下的"批处理引擎Spark"页面找到目标Spark端点名称。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                | spark-sql-test                                                                              |
   | regionName                       | AI DataLake的区域名称和服务名称。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  | cn-north-7                                                 |
   | catalogName                     | 数据目录名称。 - 使用LakeFormation catalog时必填，对应的LakeFormation catalog名称。 查询LakeFormation catalog时， catalog下面必须有default数据库。   - 不填写时默认AI DataLake catalog，使用AI DataLake catalog时无需配置该参数。   | 假设使用名称为lfcatalog的LakeFormation catalog时，配置如下：catalog=lfcatalog |
   | ObsEndPoint                                                  | OBS的EndPoint。 获取方法请参见[终端节点（Endpoint）和访问域名](https://support.huaweicloud.com/productdesc-obs/obs_03_0152.html)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | -                                                                                        |
      
   
   
 
