Tableau Server에서 XML 끝점을 더 이상 사용할 수 없음

게시 날짜: 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.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

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 끝점을 사용하여 매우 큰 데이터 집합을 요청하면 오류가 발생하거나 중단될 수 있습니다.