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
- AllSites.Manage
- offline_access
- User.Read
使用自定义 OAuth 客户端
Tableau 建议您设置自定义 OAuth 客户端,这样您就可以根据自己的 IT 政策完全控制 OAuth 配置。使用您自己的 OAuth 客户端的选项使您免于受制于 Tableau 发布周期和 Tableau 的 OAuth 客户端轮换计划。有关如何配置您自己的 OAuth 客户端的信息,请参见为站点配置自定义 OAuth。
需要驱动程序
此连接器需要驱动程序才能与数据库通信。如果计算机上未安装该驱动程序,Tableau 将在连接对话框中显示一条错误消息,其中包含指向驱动程序下载(链接在新窗口中打开)页面的链接,您可在该页面中找到驱动程序链接和安装说明。
Tableau Server 上配置 SharePoint 列表 (JDBC)
在如果您正在使用 Tableau Server,必须首先在每个服务器节点上安装连接器和驱动程序。
- 从 Tableau Exchange(链接在新窗口中打开) 下载打包的 Sharepoint 列表 (JDBC) Tableau 连接器 (TACO) 文件或“cdata.sharepoint.taco”。
- 将 .taco 文件移动到 Tableau Server 实例的每个节点上的以下目录:
- Windows:C:\ProgramData\Tableau\Tableau Server\data\tabsvc\vizqlserver\Connectors
- Linux:[您的 Tableau Server 安装目录]/data/tabsvc/vizqlserver/Connectors
- 从 Tableau 驱动程序中心(链接在新窗口中打开)下载并安装 SharePoint 列表 (JDBC) 驱动程序。JDBC 驱动程序 (data.tableau.sharepoint.jar) 需要放置在 Tableau Server 实例每个节点的以下目录中:
- Windows:C:\Program Files\Tableau\Drivers
- Linux:/opt/tableau/tableau_driver/jdbc
- 重新启动 Tableau Server。
- 如果您计划将 OAuth 与 SharePoint 列表 (JDBC) 结合使用,则还需要进行一些额外的 Tableau Server 配置。有关详细信息,请参见“为 OAuth 和现代身份验证配置 Azure AD”.
- 启动 Tableau,并在“连接”下选择“SharePoint 列表 (JDBC)”。
- 在“服务器”文本框中,输入“SharePoint URL”。
- 选择“版本”:“本地”或“SharePoint 联机”。
- 选择身份验证方法:Azure AD、用户名和密码、NTLM、ADFS 或基本。
- 如果选择了 Azure AD,请选择“登录”。
- 对于其他身份验证方法,请输入所需信息,然后选择“登录”。
接下来,在“数据源”页面上,执行以下操作:
- (可选)在页面顶部选择默认数据源名称,然后输入要在 Tableau 中使用的唯一数据源名称。
例如,使用可帮助其他数据源用户推断出要连接的数据源的数据源命名约定。
- 若要开始分析,请选择工作表标签。
如果在 Mac 上使用 Tableau Desktop,则在输入服务器名称进行连接时,请使用完全限定的域名(例如 mydb.test.ourdomain.lan)而不是相对域名(例如 mydb 或 mydb.test)。
或者,可以将域添加到 Mac 计算机的“搜索域”的列表中,以便在您连接时,只需要提供服务器名称。若要更新“搜索域”的列表,请转到“系统首选项”>“网络”>“高级”,然后打开“DNS”选项卡。
在 Mac 上,这两种身份验证方法都要求您输入您的用户名和密码才能连接。
Tableau 仅支持 SharePoint 列表的数据提取连接,不支持实时连接。您可以通过刷新数据提取来更新数据;不支持增量刷新。有关详细信息,请参见刷新数据提取。有关刷新计划的信息,请参见发布工作簿时计划数据提取刷新。