文档首页/ 智能数据湖 AI DataLake/ 最佳实践/ 使用BI工具连接AI DataLake Spark分析数据/ 配置Tableau Desktop连接AI DataLake Spark进行数据查询和分析
更新时间:2026-11-19 GMT+08:00
分享

配置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下载页面。
  2. 获取Tableau Desktop安装包。
  3. 双击运行安装程序。
  4. 按照安装向导完成以下操作:

    • 接受许可协议
    • 选择安装类型:典型或自定义
    • 设置安装目录:建议使用默认路径

步骤2:配置 AI DataLake Spark JDBC驱动

  1. 单击aidatalake-spark-jdbc-x.x.x.jar获取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获取连接器压缩包。
  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"
      • 如果路径中包含空格,必须使用英文双引号包裹。
      • 可执行文件路径和参数之间需保留一个空格。
    3. 单击“确定”。
    4. 双击快捷方式启动Tableau Desktop。
  • 方式二:命令行启动
    tableau.exe -DConnectPluginsPath=D:\tmp\Connectors

步骤5:创建 AI DataLake Spark数据源连接

  1. 启动Tableau Desktop。
  2. 在左侧选择“连接到服务器”>“更多”。
  3. 搜索关键字aidatalake。

    图1 搜索aidatalake

  4. 选择“AIDataLake Spark JDBC by HuaweiCloud”。
  5. 填写连接参数。

    表1 Tableau Desktop连接AI DataLake参数说明

    字段

    填写内容

    Server

    服务器地址。

    格式为:{AIDataLake Spark Endpoint URL}/{ProjectID}

    Username

    华为云账号的AK和SK。

    获取AK和SK信息,请参见获取AKSK 。

    Password

    其中服务器中涉及的参数说明如下。
    表2 服务器地址参数说明

    参数

    说明

    配置样例

    AIDataLake Spark Endpoint URL

    AI DataLake服务的Url。

    终端节点即调用API的请求地址,不同服务不同区域的终端节点不同,您可以从地区和终端节点中查询服务的终端节点。

    https://aidatalake-test.cn-north-7.myhuaweicloud.com

    ProjectID

    AI DataLake资源所在的项目ID。

    鼠标悬浮在AI DataLake管理控制台页面右上角账号信息位置,单击“我的凭证”,在“项目列表”区域获取的目标项目ID信息。

    0b33ea2a7e******4c009bb05076d

    workspaceId

    AI DataLake工作空间ID。

    登录AI DataLake管理控制台,在“工作空间管理”页面找到目标工作空间ID。

    spark

    lakeformationInstanceId

    LakeFormation实例ID。

    获取方法请参见如何获取LakeFormation实例ID

    ae6dd098-***-*****-c02***def36d

    endpointName

    AI DataLake服务的Spark端点名称。

    登录AI DataLake管理控制台,在“引擎端点”下的“批处理引擎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)和访问域名

    -

相关文档