Web Data Connector 3.0 SDK로 작성된 커넥터

Web Data Connector 3.0은 웹 데이터 커넥터의 최신 버전으로, ODBC/JDBC 드라이버가 아닌 API를 통해 노출되는 웹 응용 프로그램 및 서비스의 데이터에 연결하기 위한 Tableau 솔루션입니다.

Web Data Connector 3.0 SDK는 웹 데이터에 대한 자체 사용자 지정 커넥터를 작성하는 데 필요한 도구를 제공합니다. 또한 Tableau Exchange에서는 파트너가 작성한 커넥터를 사용할 수도 있습니다.

참고: 웹 데이터 커넥터 3.0은 2022.3 Tableau 릴리스의 일부였습니다.

Web Data Connector 3.0 정보

웹 데이터 커넥터의 이전 반복과 달리 Tableau 커넥터 SDK와 유사한 Web Data Connector 3.0은 웹 데이터에 대한 사용자 지정 커넥터를 작성하고 커넥터를 .taco 파일로 패키지화할 수 있는 기능을 제공합니다. WDC 3.0 커넥터는 Tableau 커넥터 SDK를 사용하여 작성된 드라이버 기반 커넥터와 같은 방식으로 사용될 수 있으며 자체 웹 서버에서 커넥터를 호스트할 필요가 없습니다.

다른 .taco 커넥터와 마찬가지로 WDC 3.0 커넥터는 일련의 XML 및 Javascript/TypeScript 파일을 포함한 .jar 파일로 패키지화되고 서명됩니다. 이러한 파일은 다음과 같은 커넥터의 모양과 동작을 정의합니다.

  • 웹 기반 커넥터 UI
  • 응용 프로그램 또는 서비스 끝점에서 데이터를 검색하기 위한 API 호출
  • 검색된 데이터를 Tableau 추출로 매핑하기 위한 지침

참고: Web Data Connector 3.0은 추출 전용으로 유지되지만 그 외에는 다른 모든 데이터 원본과 마찬가지로 데이터를 시각화하고 분석을 게시하는 데 사용할 수 있습니다.

중요: Tableau Server의 WDC 3.0 기반 커넥터에는 알려진 문제가 있습니다. 아래의 알려진 문제(Tableau Server에만 해당)를 참조하십시오.

고유한 커넥터 작성

자체 사용자 지정 커넥터를 작성하기 시작하려면 공식 Web Data Connector 3.0 설명서를 참조하십시오.

Web Data Connector 3.0 SDK로 작성된 커넥터 사용

Web Data Connector 3.0 SDK를 사용하여 커넥터를 작성한 후 다음 단계에 따라 Tableau에서 커넥터를 사용하십시오.

  1. 커넥터 파일([커넥터 이름].taco)을 다운로드합니다.
  2. .taco 파일을 다음 디렉터리(기본 위치)에 배치합니다.
    • 2021.2 이상의 경우:
      Tableau Desktop의 경우Tableau Prep Builder의 경우Tableau Server의 경우
      • Windows - C:\Users\[Windows 사용자]\문서\내 Tableau 리포지토리\커넥터
      • macOS - /Users/[user]/도큐먼트/내 Tableau 리포지토리/커넥터
      • Windows: C:\Users\[Windows 사용자]\문서\내 Tableau Prep 리포지토리\커넥터
      • MacOS: /Users//도큐멘트/내 Tableau Prep 리포지토리/커넥터
      • Windows: C:\Program Files\Tableau\커넥터

      • Linux: /opt/tableau/connectors

    • 2021.1 이상의 경우:
      Tableau Desktop의 경우Tableau Prep Builder의 경우Tableau Server, Tableau Prep Conductor, Tableau Prep 흐름 작성의 경우
      • Windows - C:\Users\[Windows 사용자]\문서\내 Tableau 리포지토리\커넥터
      • macOS - /Users/[user]/도큐먼트/내 Tableau 리포지토리/커넥터
      • Windows: C:\Users\[Windows 사용자]\문서\내 Tableau Prep 리포지토리\커넥터
      • MacOS: /Users//도큐멘트/내 Tableau Prep 리포지토리/커넥터
      • Tableau Server: [Tableau_Server_Installation_Directory]/data/tabsvc/vizqlserver/커넥터

      커넥터를 Prep에 사용하려면 다음 위치에 taco도 추가해야 합니다.

      • Tableau Prep Conductor: [Tableau_Server_Installation_Directory]/data/tabsvc/flowprocessor/커넥터
      • Tableau Prep 흐름 작성: [Tableau_Server_Installation_Directory]/data/tabsvc/flowqueryservice/커넥터

참고: 커넥터를 설치하면 Tableau의 커넥터 목록에 나타납니다.

WDC 라이브러리, 시뮬레이터 또는 개발자 샘플에서 문제를 발견한 경우 Github에서 문제를 제출(링크가 새 창에서 열림)하십시오.

Tableau를 데이터에 연결

  1. Tableau를 시작하고 연결에서 앞서 설치한 커넥터의 이름을 선택합니다. 데이터 커넥터 전체 목록을 보려면 서버에 연결 아래에서 자세히를 선택합니다.
  2. 메시지에 따라 정보를 입력하고 로그인을 선택합니다.
  3. 커넥터가 데이터를 Tableau로 가져올 때까지 기다립니다.
  4. 시트 탭을 선택하여 분석을 시작합니다.

커넥터 로드 순서

커넥터의 클래스가 이미 등록된 커넥터와 동일한 경우 새 커넥터가 거부됩니다. 두 커넥터가 클래스 이름을 공유하는 경우 먼저 로드된 커넥터가 우선합니다.

Tableau는 각 디렉터리의 커넥터를 다음 순서로 로드합니다.

  1. 기본 제공 Tableau 커넥터
  2. C:\Program Files\Tableau\Connectors(Windows) 또는/opt/tableau/connectors(Linux)에 위치한 커넥터
  3. My Tableau Repository/Connectors에 위치한 커넥터
  4. (선택 사항) -DConnectPluginsPath로 지정된 개발 경로의 커넥터

알려진 문제(Tableau Server에만 해당)

Tableau Server에서 WDC 3.0 기반 커넥터에 연결하려고 할 때 'Tableau Server(버전 <버전 번호>)에서 이 워크시트 작업 중 오류가 발생했습니다.'라는 오류 메시지가 표시될 수 있습니다.

이 오류는 통합 문서가 만들어진 웹 데이터 커넥터 3.0 기반 커넥터가 다중 노드 Tableau Server와 호환되지 않기 때문에 발생합니다. 현재로서는 해결 방법이나 해결책이 없습니다. 자세한 내용은 WDC 3.0 기반 커넥터를 사용하여 웹 작성 시 '오류가 발생했습니다'라는 오류와 함께 HTTP 503이 수신됨(영문)(링크가 새 창에서 열림) 기술 자료를 참조하십시오.

참고 항목

피드백을 제공해 주셔서 감사합니다!귀하의 피드백이 제출되었습니다. 감사합니다!