问题
自从 2016 年 8 月发布 Tableau Server 版本 10.0 以来,由于 Tableau Server 进程发生了变化,因此 XML 端点(例如http://MY-SERVER/users.xml
)尚不可用。依赖于这些端点的用户应移植其代码以使用 REST API。
http://MY-SERVER/users.xml
)尚不可用。依赖于这些端点的用户应移植其代码以使用 REST API。
在 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 端点。
由于我们使用新功能扩展了 REST API,因此对 XML 端点的需求越来越少。XML 端点返回的信息现在可以使用 REST API 来获得,或者被确定为不是当前需要 API 端点的功能。
XML 端点和 REST API 之间不一定是一对一映射;例如,XML 端点可能已经返回信息,但信息格式不同于 REST API 方法返回的信息的格式。
下表显示了 XML 端点和 REST API 方法之间的等效方式。
XML 端点 | REST API 方法 |
---|---|
auth.xml | Sign In |
data_connections.xml | Query Workbook Connections |
datasources.xml | Query Datasources |
groups.xml | Query Groups |
projects.xml | Query Projects |
schedules.xml | Query Schedules |
site_tasks.xml | Query Extract Refresh Tasks |
sites.xml | 查询站点 |
tags.xml | 查询数据源 |
tasks.xml | Query Extract Refresh Tasks |
users.xml | 获取组中的用户 |
views.xml | 查询站点视图 |
workbooks.xml | 查询工作簿 |
如果上表中没有列出端点,则 REST API 中不存在等效项,但有一项例外(见下一节)。
systeminfo.xml
端点继续可用。此端点提供有关服务器进程的当前状态的信息。有关详细信息,请参见 Tableau Server 文档中的以 XML 形式获取进程状态。
由于其他原因,Tableau Server 组件偶尔会进行重新设计,以获得更好的性能和可扩展性。在这项工作中,Tableau Server 上不再需要 API 服务器进程 (wgserver
)。该组件最初提供的功能现在已经内置到其他组件中。
对于多个版本,Tableau Server 已经包含 wgserver
进程,旨在便于内容管理。此过程的实现方法的副作用是 Tableau Server 允许用户向 XML 端点发出请求。例如,用户已经能够发出如下的请求,这些请求返回了有关在服务器上定义的用户的信息:
http://MY-SERVER/users.xml
XML 端点从未被记录并且不受支持。 如果您的应用程序功能依赖于这些端点,则必须更新代码才能改用 REST API。
如前所述,XML 端点不是受支持的功能;它们是 wgserver
的实现方式的副作用。因为它们不受支持,所以我们没有花力气去更新端点以适应服务器上的新功能或修复错误。此外,XML 端点有时不稳定 - 例如,使用 XML 端点请求非常大的数据集可能会导致错误或挂起。