---
schema_version: "1"
id: 45f968bbe49d39c6ad16445d314f7c73642e57bdb30c2238d43cb3db15afeedc
title: SharePoint 列表 (JDBC)
collection: tableau
version: current
locale: zh-cn
portal_url: https://docs.salesforce.com/tableau/current/zh-cn/pro/desktop/examples_sharepoint_lists_jdbc.md
canonical_url: https://help.tableau.com/current/pro/desktop/zh-cn/examples_sharepoint_lists_jdbc.htm
source_site: help.tableau.com
content_type: documentation
content_hash: a4c23982a9ef4ea916bdb12106af1103e4f4a19b75ad67de373c1623a9818e45
description: Connect Tableau to the SharePoint Lists (JDBC) driver and set up the data source.
---
[跳转到主要内容](#main-content)

# SharePoint 列表 (JDBC)

本文介绍如何将 Tableau 连接到 SharePoint 列表 (JDBC) 驱动程序并设置数据源。

**注意：**SharePoint 列表 JDBC 连接器需要 Tableau 2022.3 或更高版本以及 SharePoint 列表 JDBC 驱动程序。

## 准备连接

在开始之前，请收集以下连接信息：

- 包含要连接的列表的 SharePoint 站点的 URL
- 您的 SharePoint 服务器的版本：本地或 SharePoint Online
- 身份验证方法：Azure AD、第三方 SSO 或集成身份验证
- 用户名或电子邮件地址、密码以及（可选）SSO 域（如果需要）

### 必需的 API 权限

在 SharePoint 中，授予 Tableau 以下应用程序编程接口 (API) 权限：

- profile
- openid
- email
- AllSites.Manage
- offline\_access
- User.Read

### 使用自定义 OAuth 客户端

Tableau 建议您设置自定义 OAuth 客户端，这样您就可以根据自己的 IT 政策完全控制 OAuth 配置。使用您自己的 OAuth 客户端的选项使您免于受制于 Tableau 发布周期和 Tableau 的 OAuth 客户端轮换计划。有关如何配置您自己的 OAuth 客户端的信息，请参见[为站点配置自定义 OAuth](https://help.tableau.com/current/server/zh-cn/config_oauth_azure_ad.htm#custom)。

### 需要驱动程序

此连接器需要驱动程序才能与数据库通信。如果计算机上未安装该驱动程序，Tableau 将在连接对话框中显示一条错误消息，其中包含指向[驱动程序下载](https://www.tableau.com/zh-cn/support/drivers)页面的链接，您可在该页面中找到驱动程序链接和安装说明。

### 在 Tableau Server 上配置 SharePoint 列表 (JDBC)

如果您正在使用 Tableau Server，必须首先在每个服务器节点上安装连接器和驱动程序。

1. 从 [Tableau Exchange](https://exchange.tableau.com/zh-CN/products/728) 下载打包的 Sharepoint 列表 (JDBC) Tableau 连接器 (TACO) 文件或“cdata.sharepoint.taco”。
2. 将 .taco 文件移动到 Tableau Server 实例的每个节点上的以下目录：

- **Windows**：C:\\ProgramData\\Tableau\\Tableau Server\\data\\tabsvc\\vizqlserver\\Connectors
- **Linux**：\[您的 Tableau Server 安装目录\]/data/tabsvc/vizqlserver/Connectors

1. 从 [Tableau 驱动程序中心](https://www.tableau.com/zh-cn/support/drivers)下载并安装 SharePoint 列表 (JDBC) 驱动程序。JDBC 驱动程序 (data.tableau.sharepoint.jar) 需要放置在 Tableau Server 实例每个节点的以下目录中：

- **Windows**：C:\\Program Files\\Tableau\\Drivers
- **Linux**：/opt/tableau/tableau\_driver/jdbc

1. 重新启动 Tableau Server。
2. 如果您计划将 OAuth 与 SharePoint 列表 (JDBC) 结合使用，则还需要进行一些额外的 Tableau Server 配置。有关详细信息，请参见[“为 OAuth 和现代身份验证配置 Azure AD”](https://help.tableau.com/current/server/zh-cn/config_oauth_azure_ad.htm).

## 进行连接并设置数据源

1. 启动 Tableau，并在**“连接”**下选择**“SharePoint 列表 (JDBC)”**。
2. 在“服务器”文本框中，输入**“SharePoint URL”**。
3. 选择**“版本”**：**“本地”**或**“SharePoint 联机”**。
4. 选择**身份验证**方法：**Azure AD**、**用户名和密码**、**NTLM**、**ADFS** 或**基本**。
5. 如果选择了 Azure AD，请选择**“登录”**。
6. 对于其他身份验证方法，请输入所需信息，然后选择**“登录”**。

接下来，在“数据源”页面上，执行以下操作：

1. （可选）在页面顶部选择默认数据源名称，然后输入要在 Tableau 中使用的唯一数据源名称。

例如，使用可帮助其他数据源用户推断出要连接的数据源的数据源命名约定。

1. 若要开始分析，请选择工作表标签。

## 登录到 Mac

如果在 Mac 上使用 Tableau Desktop，则在输入服务器名称进行连接时，请使用完全限定的域名（例如 mydb.test.ourdomain.lan）而不是相对域名（例如 mydb 或 mydb.test）。

或者，可以将域添加到 Mac 计算机的“搜索域”的列表中，以便在您连接时，只需要提供服务器名称。若要更新“搜索域”的列表，请转到“系统首选项”\>“网络”\>“高级”，然后打开“DNS”选项卡。

在 Mac 上，这两种身份验证方法都要求您输入您的用户名和密码才能连接。

## 刷新您的数据

Tableau 仅支持 SharePoint 列表的数据提取连接，不支持实时连接。您可以通过刷新数据提取来更新数据；不支持增量刷新。有关详细信息，请参见[刷新数据提取](https://help.tableau.com/current/pro/desktop/zh-cn/extracting_refresh.htm)。有关刷新计划的信息，请参见[发布工作簿时计划数据提取刷新](https://help.tableau.com/current/pro/desktop/zh-cn/publish_workbooks_schedules.htm)。

## 另请参见

- [设置数据源](https://help.tableau.com/current/pro/desktop/zh-cn/datasource_prepare.htm) – 向此数据源中添加更多数据，或者在分析数据之前准备数据。
- [构建图表和分析数据](https://help.tableau.com/current/pro/desktop/zh-cn/design_and_analyze.htm) – 开始数据分析。