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

配置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下载页面,获取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获取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服务管理器。

步骤3:配置AI DataLake Spark Tableau连接器

  1. 单击aidatalake-tableau-x.x.x.zip获取连接器压缩包。
  2. 解压压缩包,得到aidatalake-tableau-1.0.0目录。
  3. 将上述文件放入以下目录(也可以放置到任意目录下):
    • Windows: C:\Program Files\Tableau\Connectors
    • Linux: /opt/tableau/connectors
      图1 目录结构
  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 输入管理员凭据

  3. 在左侧单击“New”>“Published Data Source”。

    图3 单击Published Data Source

  4. 在连接器下可以找到SparkSql,单击“AIDataLake Spark JDBC by HuaweiCloud”。

    图4 单击AIDataLake Spark JDBC by HuaweiCloud

  5. 配置Tableau Server连接AI DataLake信息

    图5 配置连接信息
    表2 Tableau Server连接AI DataLake参数说明

    字段

    填写内容

    Server

    服务器地址,格式如下:

    {AIDataLake Spark Endpoint}/{ProjectID}

    username

    自定义用户名。

    Password

    用户密码。

    其中服务器中涉及的参数说明如下。

    表3 服务器地址参数说明

    参数

    说明

    配置样例

    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)和访问域名

    -

相关文档