# 配置Tableau Desktop连接AI DataLake Spark进行数据查询和分析
本文档介绍在Windows环境下，如何通过安装Tableau Desktop并配置华为云AI DataLake JDBC驱动及Tableau连接器，实现Tableau Desktop连接AI DataLake数据源进行数据查询与分析。
#### 操作前准备
- **环境要求：**操作系统仅支持Windows 10, Windows 11版本x64位操作系统。
- **工具包** ：
  
  | **工具名称**                          | **说明**                         |
  |:---|:---|
  | 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 Desktop必须通过启动参数指定连接器路径，否则无法识别AI DataLake连接器。
- JDBC驱动必须放置在Tableau Drivers目录下。
- 请确保网络可访问华为云AI DataLake Endpoint。
 
#### 步骤1：安装Tableau Desktop
1. 访问[Tableau Desktop](https://www.tableau.com/zh-cn/support/releases)下载页面。
2. 获取Tableau Desktop安装包。
3. 双击运行安装程序。
4. 按照安装向导完成以下操作： 
   - 接受许可协议
   
   - 选择安装类型：典型或自定义
   
   - 设置安装目录：建议使用默认路径
   
   
   
   
 
#### 步骤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 Desktop安装目录。 
   默认路径如下：C:\\Program Files\\Tableau\\Tableau 2025.1
   
   
3. 返回上一级目录，进入Drivers文件夹。
4. 将JDBC驱动jar包复制到Drivers目录下。
 
#### 步骤3：配置AI DataLake 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. 将上述目录放置到任意目录下，例如：D:\\tmp\\Connectors。
 
#### 步骤4：配置Tableau Desktop启动参数
- **方式一（推荐）：** **快捷方式启动**
  1. Tableau Desktop快捷方式右键，选择"属性"。
  
  2. 在**目标** 中追加启动参数：
     ```
     "C:\Program Files\Tableau\Tableau 2025.1\bin\tableau.exe" -DConnectPluginsPath="D:\tmp\Connectors"
     ```
     ![](https://support.huaweicloud.com/bestpractice-aidatalake/public_sys-resources/note_3.0-zh-cn.png)
     - 如果路径中包含空格，必须使用英文双引号包裹。
     
     - 可执行文件路径和参数之间需保留一个空格。
       
  
  3. 单击"确定"。
  
  4. 双击快捷方式启动Tableau Desktop。
   

- **方式二：** **命令行启动**
  ```
  tableau.exe -DConnectPluginsPath=D:\tmp\Connectors
  ```
  
 
#### 步骤5：创建 AI DataLake Spark数据源连接
1. 启动Tableau Desktop。
2. 在左侧选择"连接到服务器"\>"更多"。
3. 搜索关键字aidatalake。 
   图1搜索aidatalake   
   ![](https://support.huaweicloud.com/bestpractice-aidatalake/zh-cn_image_0000002750007350.png "点击放大")
   
   
4. 选择"AIDataLake Spark JDBC by HuaweiCloud"。
5. 填写连接参数。 
   表1Tableau Desktop连接AI DataLake参数说明 
   | **字段**   | **填写内容**                                                                                                                                                     |
   |:---|:---|
   | Server   | 服务器地址。 格式为：{AIDataLake Spark Endpoint URL}/{ProjectID}                                                                  |
   | Username | 华为云账号的AK和SK。 获取AK和SK信息，请参见[获取AKSK](https://support.huaweicloud.com/sdkreference-aidatalake/aidatalake_09_0007.html) 。 |
   | Password | 华为云账号的AK和SK。 获取AK和SK信息，请参见[获取AKSK](https://support.huaweicloud.com/sdkreference-aidatalake/aidatalake_09_0007.html) 。 |
      
   其中服务器中涉及的参数说明如下。
   表2服务器地址参数说明 
   | 参数                             | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | 配置样例                                                                                      |
   |:---|:---|:---|
   | 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)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | -                                                                                        |
      
   
   
 
