知识库

XML 端点在 Tableau Server 中不再可用


发布时间: 15 Mar 2017
上次修改日期: 20 Jul 2023

问题

自从 2016 年 8 月发布 Tableau Server 版本 10.0 以来,由于 Tableau Server 进程发生了变化,因此 XML 端点(例如 http://MY-SERVER/users.xml)尚不可用。依赖于这些端点的用户应移植其代码以使用 REST API

环境

  • Tableau Server 10.0 和更高版本
  • XML 端点

答案

当前和未来版本的 Tableau Server 中的状态

在 Tableau Server 9.3 中,默认情况下禁用了 wgserver 进程。(REST API 调用由不同的进程进行处理。)如果要在 Tableau Server 9.3 中继续使用 XML 端点,则必须使用以下命令显式启用该进程:

tabadmin stop 
tabadmin set wgserver.enabled true 
tabadmin set wgserver.xmlapi.enabled true 
tabadmin set worker0.wgserver.procs 1 
tabadmin configure 
tabadmin start 


重要信息:从 Tableau Server 10.0 开始,wgserver 进程已被完全删除,您将根本无法使用 XML 端点。

XML 端点奇偶校验

由于我们使用新功能扩展了 REST API,因此对 XML 端点的需求越来越少。XML 端点返回的信息现在可以使用 REST API 来获得,或者被确定为不是当前需要 API 端点的功能。

XML 端点和 REST API 之间不一定是一对一映射;例如,XML 端点可能已经返回信息,但信息格式不同于 REST API 方法返回的信息的格式。

下表显示了 XML 端点和 REST API 方法之间的等效方式。

XML 端点REST API 方法
auth.xmlSign In
data_connections.xmlQuery Workbook Connections
datasources.xmlQuery Datasources
groups.xmlQuery Groups
projects.xmlQuery Projects
schedules.xmlQuery Schedules
site_tasks.xmlQuery Extract Refresh Tasks
sites.xml查询站点
查询站点
tags.xml查询数据源
查询工作簿
查询用户的工作簿
tasks.xmlQuery Extract Refresh Tasks
users.xml获取组中的用户
获取站点中的用户
views.xml查询站点视图
查询工作簿视图
workbooks.xml查询工作簿
查询用户的工作簿

如果上表中没有列出端点,则 REST API 中不存在等效项,但有一项例外(见下一节)。

systeminfo.xml

systeminfo.xml 端点继续可用。此端点提供有关服务器进程的当前状态的信息。有关详细信息,请参见 Tableau Server 文档中的以 XML 形式获取进程状态

其他信息

后台

由于其他原因,Tableau Server 组件偶尔会进行重新设计,以获得更好的性能和可扩展性。在这项工作中,Tableau Server 上不再需要 API 服务器进程 (wgserver)。该组件最初提供的功能现在已经内置到其他组件中。

XML 端点

对于多个版本,Tableau Server 已经包含 wgserver 进程,旨在便于内容管理。此过程的实现方法的副作用是 Tableau Server 允许用户向 XML 端点发出请求。例如,用户已经能够发出如下的请求,这些请求返回了有关在服务器上定义的用户的信息:

http://MY-SERVER/users.xml

XML 端点从未被记录并且不受支持。 如果您的应用程序功能依赖于这些端点,则必须更新代码才能改用 REST API

更改的原因

如前所述,XML 端点不是受支持的功能;它们是 wgserver 的实现方式的副作用。因为它们不受支持,所以我们没有花力气去更新端点以适应服务器上的新功能或修复错误。此外,XML 端点有时不稳定 - 例如,使用 XML 端点请求非常大的数据集可能会导致错误或挂起。

此文章是否已解决问题?