TabPy 로컬 구성해서 Tableau Prep 연결하기

TabPy란?

TabPy (Tableau Python Server)는 Tableau에서 Python 스크립트를 실행하고 그 결과를 Tableau 워크플로우에 직접 반영할 수 있도록 도와주는 분석 확장 서버입니다.

Tableau Desktop뿐 아니라 Tableau Prep에서도 사용할 수 있으며, 이를 통해 데이터 전처리 과정에 Python 기반 로직을 유연하게 삽입할 수 있습니다.

1단계: TabPy 설치

▶︎ Python 환경 확인

먼저 Python이 설치되어 있어야 합니다. (Anaconda 환경에서도 OK)

python --version
pip --version

▶︎ TabPy 설치

pip install tabpy

2단계: TabPy 서버 실행

▶︎ 터미널에서 아래 명령어 입력

tabpy

정상적으로 실행되면 아래와 같은 로그가 표시됩니다:

Web service listening on port 9004
TabPy Server Ready.

Tip: 처음 실행 시 Do you wish to proceed without authentication? (y/N)라는 메시지가 나오면 y 입력 후 Enter

🔗 3단계: Tableau Prep에서 TabPy 연결

▶︎ 메뉴 경로

도움말 > 설정 및 성능 > 분석 확장 프로그램 연결 관리

설정 값 입력

항목	값
서버 유형	TabPy
호스트	localhost
포트	9004
사용자 인증	사용하지 않음 (기본 설정)

“연결 테스트” 버튼을 클릭하여 정상 연결 확인 → “확인” 클릭

4단계: Tableau Prep에서 Python 코드 활용

TabPy를 연결하면, 스크립트 단계에서 Python 코드를 아래와 같은 방식으로 삽입할 수 있습니다.

예시: 문자열 대문자 변환

def getOutputSchema():
    return pd.DataFrame({'col1': str})

return pd.DataFrame({'col1': data['이름'].str.upper()})

보안 팁: 비밀번호 설정하고 싶다면?

1. tabpy.conf 파일 생성 또는 수정

[TabPy]
TABPY_PORT = 9004
TABPY_ENABLE_AUTHENTICATION = True

2. 비밀번호 해시 생성

python -m tabpy.tools.generate_password_hash

3. users.json 파일 생성 후 TabPy 실행 시 인증 적용

tabpy --config=/path/to/tabpy.conf