태블로 API 가이드

Tableau는 자동화, 연동, 확장 등 다양한 목적을 위해 여러 종류의 API를 제공하고 있습니다. 하지만 API의 종류가 워낙 많고 각각의 목적도 다르기 때문에 처음 접하는 사용자 입장에서는 어떤 API를 사용해야 할지 판단하기 어렵습니다.

이번 포스트에서는 Tableau에서 제공하는 API를 간단히 소개하고, 각 API가 제공하는 기능과 실제 사용 사례를 함께 정리하였습니다. "이럴 때 이 API를 쓰면 된다"는 기준을 세우는 데 도움이 되기를 바라며, 상세한 구현 방법은 링크된 공식 문서를 참고해주시기 바랍니다.

API 개요

REST API

서버 및 클라우드 환경에서 사용자, 콘텐츠, 사이트, 작업을 프로그래밍 방식으로 제어할 수 있는 API입니다.

• 사용자 및 그룹 관리
• 워크북, 데이터 소스 게시 및 권한 설정
• 추출 새로고침, Prep 흐름 실행(Conductor)
• 사이트 설정, 토큰 인증 등 지원

사용 예시

• 신규 사용자 자동 등록 및 그룹 배정
• 매일 새벽 자동 추출 새로고침
• 프로젝트 단위 권한 일괄 수정

Embedding API

웹페이지나 웹앱에서 Tableau 시각화를 삽입하고 제어할 수 있는 API입니다.

• <tableau-viz> 웹 컴포넌트 또는 모듈형 JavaScript 라이브러리
• 외부 UI에서 필터, 매개변수, 마크 선택 제어
• React, Angular 등 최신 프레임워크와 호환

사용 예시

• 사내 포털이나 서비스 웹사이트에 대시보드 삽입
• 사용자 입력값을 기반으로 실시간 시각화 제어

Webhooks

Tableau에서 발생한 이벤트를 외부 시스템으로 자동 전달하는 기능을 제공합니다.
웹후크의 생성·관리 작업은 REST API로 수행합니다.

• 워크북 게시, 추출 실패, 흐름 실행 완료 등의 이벤트 감지
• HTTP POST 방식으로 Slack, 이메일, ServiceNow 등과 연동

사용 예시

• 추출 실패 시 자동 알림 전송
• 콘텐츠 게시 시 승인 요청 메일 발송
• 새 워크북 게시 시 Slack 공지

Metadata API

콘텐츠와 데이터 자산의 관계를 분석하고 계보(lineage)를 추적할 수 있는 API입니다.
단일 GraphQL 엔드포인트에 필요한 필드만 선택(query)하여 질의합니다.

• 워크북, 시트, 데이터 소스, 테이블 간 의존성 확인
• 데이터 거버넌스 및 변경 영향도 분석 강화

사용 예시

• 특정 필드가 사용된 시트를 자동 검색
• 테이블 변경 시 영향을 받는 콘텐츠 식별

Hyper API

Tableau의 .hyper 추출 파일을 생성, 수정, 삭제할 수 있는 API입니다.

• Python, Java, C++ 등에서 사용 가능
• 자체 ETL 프로세스 구성 및 자동화 지원
• Hyper SQL을 통한 고급 쿼리 수행

사용 예시

• 외부 데이터를 정제해 .hyper 파일 생성
• 주기적으로 데이터 업데이트 자동화

문서화 API

워크북(.twb), 데이터 소스(.tds) 파일을 코드로 편집 및 배포할 수 있는 API입니다.
지원 수준: As-Is(정식 지원 범위가 아니며, 변경 가능성이 있습니다).

• XML 기반 구조를 안전하게 조작
• 연결 정보 교체, 필드 사용 정보 추출, 템플릿 생성 가능

사용 예시

• 테스트용 데이터 원본을 운영 데이터로 자동 교체
• 공통 템플릿 워크북을 일괄 생성

대시보드 확장 프로그램 API

Tableau 대시보드에 외부 웹 애플리케이션을 삽입할 수 있는 API입니다.
확장 유형에는 Dashboard Extension(대시보드와 상호작용)과 Viz Extension(신규 시각화 타입 추가)이 있습니다.

• 외부 시스템과 양방향 통신
• 마크 선택, 필터 변경 감지 등 사용자 이벤트 처리
• JavaScript, HTML, CSS 기반으로 개발

사용 예시

• 대시보드 내 사용자 피드백 입력 창 구현
• 필터값을 외부 시스템으로 전송하여 실시간 결과 반영

Analytics 확장 프로그램 API

외부 계산 엔진(Python, R, MATLAB, SageMaker 등)을 Tableau 계산식에서 호출할 수 있는 API입니다.

• 실시간 예측·통계 분석 결과를 시각화로 반환
• HTTPS/인증 기반 통신 지원

사용 예시

• 머신러닝 예측 모델의 결과를 실시간 표시
• R 기반 통계 분석을 계산식에 반영

웹 데이터 커넥터(Web Data Connector, WDC)

웹 API나 JSON, XML 데이터를 Tableau에 연결할 수 있는 API입니다.
WDC 3.0은 EPS(Extensible Protocol Server) 로 로컬 서버 없이 실행할 수 있고, TACO Toolkit을 통해 .taco 패키징/서명 배포를 지원합니다.

• HTML + JavaScript 기반 커넥터 직접 개발
• REST API, 공공데이터, RSS 등 연결 가능

사용 예시

• 공공데이터 API를 Tableau로 불러오기
• SaaS 서비스(Google Analytics 등)의 데이터 연결

커넥터 SDK

신규 데이터 소스를 Tableau에 연결하기 위한 커넥터 개발 도구입니다.

• ODBC/JDBC 드라이버 기반
• SQL dialect, 인증 흐름, UI 직접 정의
• TDVT 도구를 통한 검증 지원

사용 예시

• 사내 전용 DB용 커넥터 개발
• 특정 SaaS 솔루션 전용 커넥터 제작

모바일 앱 부트스트랩

모바일 앱에 Tableau 콘텐츠를 삽입할 수 있도록 하는 샘플 템플릿과 예제를 제공합니다.

• React Native, Cordova, iOS 등 지원
• 브랜드 맞춤형 UI 구성 및 토큰 기반 인증 연동

사용 예시

• 임직원용 모바일 앱에서 실시간 대시보드 제공
• 오프라인 환경에서 데이터 미리보기 구성

Tableau API는 각각의 목적과 역할이 뚜렷하며, 이들을 적절히 조합하면 Tableau를 기업 내 데이터 생태계 전반과 유기적으로 연결할 수 있습니다.

자동화, 확장, 통합 등 필요한 목적에 맞는 API를 선택하여 업무 효율과 데이터 활용도를 함께 높여보세요.