Tableau Server의 웹 데이터 커넥터
WDC(웹 데이터 커넥터)는 Tableau에서 아직 커넥터가 없는 데이터 원본에 HTTP를 통해 액세스할 수 있는 데이터 연결을 제공하는 웹 페이지입니다. WDC를 사용하면 웹을 통해 액세스할 수 있는 거의 모든 데이터에 연결하여 통합 문서에 대한 추출을 만들 수 있습니다. WDC용 데이터 원본에는 내부 웹 서비스, JSON 데이터, REST API가 포함되며 HTTP 또는 HTTPS를 통해 사용할 수 있는 기타 원본도 포함됩니다. 사용자는 자신의 WDC를 만들거나 다른 사람이 만든 커넥터를 사용할 수 있습니다.
Tableau Desktop에서 WDC를 사용하는 방법에 대한 자세한 내용은 Tableau Desktop 설명서에서 웹 데이터 커넥터(링크가 새 창에서 열림)를 참조하십시오.
WDC를 만드는 방법에 대한 자세한 내용은 Github에서 웹 데이터 커넥터 설명서를 참조하십시오.
Tableau Server에서 연결을 실행하기 전에
보안 조치로, Tableau Server는 이 항목에 설명된 대로 사용자가 커넥터를 승인하지 않으면 WDC를 실행하지 않습니다.
참고: Tableau Server에서 사용할 WDC를 승인하려면 서버 관리자여야 합니다.
WDC는 실행 코드를 포함하며 일반적으로 타사 웹 사이트에 요청을 수행하기 때문에 사용자의 승인이 필요합니다. 사용자가 Tableau Server에서 WDC를 사용할 수 있으려면 먼저 관리자가 커넥터가 사용하는 도메인 및 포트를 허용 목록에 추가해야 하며 커넥터가 요청을 보내고 받을 수 있는 도메인을 보조 허용 목록에 포함시켜야 합니다. 이 작업을 수행하기 전에 커넥터를 검사하고 테스트하여 커넥터의 기능과 연결하는 사이트를 확인하는 것이 좋습니다. 자세한 내용은 웹 데이터 커넥터 테스트 및 검토를 참조하십시오.
커넥터를 허용 목록에 추가할 때 커넥터가 호스팅되는 특정 URL에 대한 연결과 커넥터가 쿼리할 수 있는 URL로부터 연결을 허용하도록 Tableau Server를 구성합니다. 이것이 Tableau Server가 WDC를 실행하도록 허용하는 유일한 방법입니다. 그런 다음 커넥터를 조직 방화벽 내부의 서버에서 호스팅하거나 외부 도메인에서 호스팅할 수 있습니다. Tableau Server는 WDC 가져오기를 지원하지 않습니다.
허용 목록의 커넥터 관리
WDC를 허용 목록에 추가하려면 tsm data-access web-data-connectors add 명령을 사용합니다. 아래에 설명되어 있는 이 명령과 관련 명령을 사용하여 다음과 같은 작업을 수행할 수 있습니다.
WDC를 허용 목록 및 보조 허용 목록에 추가
모든 WDC 또는 WDC 새로 고침 허용 또는 허용하지 않음
허용 목록에서 하나 이상의 커넥터 제거
허용 목록 및 보조 허용 목록에 있는 모든 WDC 나열
WDC 허용 목록을 업데이트하려면 서버를 다시 시작해야 함
WDC를 변경하는 명령을 실행한 후 tsm pending-changes apply 명령을 사용하여 보류 중인 변경 내용을 적용해야 합니다.
보류 중인 변경 내용을 적용하려면 서버를 다시 시작해야 하는 경우 pending-changes apply 명령은 서버가 다시 시작됨을 알리는 메시지를 표시합니다. 서버가 중지된 경우에도 이 메시지가 표시되지만 이 경우 다시 시작은 없습니다. --ignore-prompt 옵션을 사용하여 이 메시지를 표시하지 않을 수 있지만 다시 시작 동작은 변경되지 않습니다. 변경 내용을 적용해도 다시 시작할 필요가 없는 경우 메시지 없이 변경 내용이 적용됩니다. 자세한 내용은 tsm pending-changes apply를 참조하십시오.
커넥터를 허용 목록 및 보조 허용 목록에 추가
커넥터를 허용 목록 및 보조 허용 목록에 추가하려면 tsm data-access web-data-connectors add 명령을 사용하고 이름, 허용 목록 URL 및 보조 허용 목록 URL을 제공합니다. web-data-connector-settings 엔터티를 사용하여 WDC를 관리할 수도 있습니다. 이 명령을 실행한 후 tsm pending-changes apply 명령을 사용하여 보류 중인 변경 내용을 적용해야 합니다. 이 명령은 Tableau Server를 다시 시작한다는 경고 메시지가 나타납니다. Tableau Server가 현재 실행되고 있으면 다시 시작되고, 현재 중지된 경우에는 다시 시작하지 않고 중지된 상태로 유지됩니다.
tsm data-access web-data-connectors add --name "USGS Earthquakes" --url https://tableau.github.io:443/webdataconnector/Examples/html/earthquakeUSGS.html --secondary https://tableau.github.io/.*,https://earthquake.usgs.gov/.*,https://maxcdn.bootstrapcdn.com/.*,https://ajax.googleapis.com/.*,https://connectors.tableau.com/.*
형식에 대한 참고 사항:
- WDC의 이름을 묶을 때 굽은 따옴표나 "스마트" 따옴표가 아닌 곧은 따옴표(" 및 ')를 사용해야 합니다. 이름에 공백이 포함된 경우 큰따옴표(")를 사용하십시오.
- 많은 WDC에서
--url옵션에 지정하는 포트는 443이거나 80이지만 Tableau Server에서 데이터 원본 세부 정보를 조사하여 커넥터의 값을 확인할 수 있습니다. WDC에 SSL(HTTPS)을 사용하는 경우 URL의 일부로 포트 번호를 지정해야 합니다. 예를 들어 HTTPS에 대한 기본 포트를 사용하려는 경우 URL은 다음과 같은 형식일 수 있습니다.https://example.com:443/WDC/. --secondary옵션에는 WDC가 액세스해야 하는 라이브러리 및 원본을 제공하는 도메인을 나타내는 URL 또는 쉼표로 구분된 URL 목록을 지정해야 합니다. WDC가 보조 도메인을 사용하지 않는 한 이 옵션은 생략하거나 비워 둘 수 없습니다. WDC가 보조 도메인을 사용하는지 여부 또는 보조 도메인이 무엇인지 모르는 경우 WDC의 개발자에게 문의해야 할 수 있습니다.http://.*및https://.*와일드카드 URL을 사용하여 모든 도메인을 허용하도록 선택할 수도 있습니다. 그러나 보안을 강화하려면 보다 구체적인 URL을 사용하는 것이 좋습니다.- 보조 허용 목록에 전체 도메인을 추가하려면 도메인 URL 끝에 와일드카드 식을 지정합니다. 전체 도메인을 나타내는 와일드카드로
.*을 사용합니다. 예를 들면https://example.com/.*입니다.
WDC 또는 WDC 추출 새로 고침 허용 또는 허용하지 않음
WDC 또는 WDC 추출 새로 고침을 허용하거나 허용하지 않으려면 tsm data-access web-data-connectors allow 명령에서 -t 또는 -r 옵션을 사용합니다. 기본적으로 WDC 및 WDC 추출 새로 고침이 허용됩니다. 이 설정을 변경하는 경우 tsm pending-changes apply 명령을 실행해야 합니다. 명령 및 명령 옵션에 대한 자세한 내용은 tsm data-access web-data-connectors allow를 참조하십시오.
허용 목록에서 하나 이상의 WDC 제거
허용 목록에서 하나 이상의 WDC를 제거하려면 tsm data-access web-data-connectors delete 명령을 사용합니다. 이 설정을 변경하는 경우 tsm pending-changes apply 명령을 실행해야 합니다. 자세한 내용은 tsm data-access web-data-connectors delete를 참조하십시오.
허용 목록에 있는 모든 WDC 나열
허용 목록에 있는 모든 WDC를 나열하려면 tsm data-access web-data-connectors list 명령을 사용합니다. 자세한 내용은 tsm data-access web-data-connectors list를 참조하십시오.
커넥터를 위한 추출 새로 고침
사용자가 WDC를 사용하는 통합 문서를 만들 경우 Tableau Server는 커넥터에서 반환되는 데이터로부터 추출을 만듭니다. 그런 다음 통합 문서를 게시하면 게시 프로세스에서 통합 문서와 데이터 추출을 서버로 보냅니다.
Tableau에서는 다른 모든 추출과 마찬가지로, WDC에 의해 만들어진 추출을 새로 고칠 수 있습니다. 커넥터가 웹 기반 데이터 원본에 로그인하기 위해 자격 증명이 필요한 경우 자격 증명이 데이터 원본에 내장되어 있으며 WDC가 서버의 허용 목록에 있는지 확인해야 합니다. 커넥터에 자격 증명이 필요하지만 데이터 원본에 자격 증명이 내장되지 않은 경우 Tableau Server는 추출을 새로 고칠 수 없습니다. 이는 새로 고침이 일정에 따라 또는 다른 백그라운드 컨텍스트에 의해 실행될 수 있으며 서버에 자격 증명을 요구하는 기능이 없기 때문입니다.
현재 Tableau Server에서 직접 데이터 원본을 다시 인증할 수 있는 방법은 없습니다. 데이터 원본이 만료된 자격 증명을 사용하거나 자격 증명을 내장하지 않고 게시된 경우 통합 문서 및 데이터 추출을 새로운 내장된 자격 증명을 사용하여 다시 게시해야 합니다.
새로 고침 작업을 수행하는 백그라운드 프로세스가 실패하는 경우 이 문제를 나타내는 알림 및 로그 항목이 만들어집니다. 사용자는 추출의 타임스탬프가 변경되지 않는 것을 확인할 수 있습니다.
모든 WDC에 대해 새로 고침을 사용하지 않도록 설정하려면 tsm data-access web-data-connectors allow -r false 명령을 사용합니다.
문제 해결
커넥터를 허용 목록에 추가할 때 서버에서 문제가 발생하는 경우 로그 파일을 검사할 수 있습니다. 초기 서버 노드와 게이트웨이 프로세스가 실행되고 있는 다른 노드 모두에서 로그 파일을 확인하십시오. 로그 파일에 대한 자세한 내용은 Tableau Server 로그 및 로그 파일 위치를 참조하십시오.
Tableau Server가 WDC로 만들어진 추출을 새로 고치지 않는 것이 문제라면 webdataconnector.refresh.enabled 구성 설정이 true로 설정되어 있는지 확인하십시오. 이 구성 설정이 false로 설정되어 있으면 다음 명령을 실행하여 서버에 있는 모든 WDC에 대해 추출 새로 고침을 허용합니다.
tsm data-access web-data-connectors allow -r true
참고: 허용 목록은 Tableau Server에서 웹 데이터 커넥터를 실행할 수 있는 유일한 방법입니다. 웹 데이터 커넥터 가져오기는 버전 10.5부터 사용 중단되었습니다.