---
schema_version: "1"
id: edb68214a7ec36074eb98764e4acfad56e3f5581ff2df00bfd5ae07cecb844a7
title: 테이블 확장 프로그램
collection: tableau
version: next
locale: ko-kr
portal_url: https://docs.salesforce.com/tableau/next/ko-kr/pro/desktop/td_table_extensions.md
canonical_url: https://help.tableau.com/v0.0/pro/desktop/ko-kr/td_table_extensions.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 5c7072f386343c5c220c400601236a832aece9b83ebbec783456f381594ae37e
description: Create table extensions with analytics extension scripts in Tableau Desktop.
---
[주요 콘텐츠로 건너뛰기](#main-content)

# 테이블 확장 프로그램

테이블 확장 프로그램을 사용하면 분석 확장 프로그램 스크립트가 있는 데이터 테이블을 만들 수 있습니다. 사용자 지정 TabPy 또는 Rserve 스크립트를 작성하고 필요에 따라 하나 이상의 입력 테이블을 추가할 수 있습니다.

**참고:** 통합 문서를 열거나 데이터 원본을 새로 고칠 때마다 테이블 확장 프로그램이 새로 고쳐집니다.

### 이점

신규 사용자와 숙련된 사용자 모두에게 적용되는 테이블 확장 프로그램 이점은 다음과 같습니다.

- 스크립트 또는 고급 기능을 Tableau에 손쉽게 통합
- Tableau 데이터 연결에서 데이터를 끌어와서 스크립트 입력으로 사용
- 로우 코드 에디터를 사용하여 코드를 데이터 원본에 손쉽게 추가
- [데이터 가이드](https://help.tableau.com/current/server/ko-kr/data_guide.htm) 및 [데이터 설명](https://help.tableau.com/current/server/ko-kr/explain_data_basics.htm)과 통합
- TabPy, Rserve 및 기타 분석 확장 프로그램과 통합
- 결과를 사용하여 대시보드 또는 비주얼리제이션 구성

## 필수 요건

테이블 확장 프로그램을 사용하려면 먼저 다음 목록을 완료해야 합니다.

- Desktop 또는 웹 작성에서 데이터 원본을 엽니다.
- 분석 확장 프로그램 구성
    - 분석 확장 프로그램 연결 구성에 대한 자세한 내용은 [분석 확장 프로그램에 식 전달](https://help.tableau.com/current/pro/desktop/ko-kr/r_connection_manage.htm)을 참조하십시오.

## 테이블 확장 프로그램 만들기

테이블 확장 프로그램을 만들려면 다음 단계를 완료하십시오.

1. 통합 문서를 엽니다.
2. 데이터 원본을 열거나 만듭니다.
3. **연결** 아래에서 **새 테이블 확장 프로그램**을 선택합니다.
4. 시트를 데이터 모델로 끌어옵니다.
5. _(선택 사항)_ 데이터 연결의 테이블을 테이블 확장 프로그램 패널로 끌어와서 분석 확장 프로그램 스크립트 또는 함수의 입력으로 사용합니다.
    
    기본적으로 Tableau의 데이터는 분석 확장 프로그램으로 전달되고 `variable _arg1`(`{‘column_name’: [1,2,3], ‘column_name_2’: [3,4,5]`와 같은 사전식 구조)로 정의됩니다.
    
    - **Python 입력 데이터:** `import pandas as pddf = (pd.DataFrame(_arg1))`을 사용하여 입력 데이터를 pandas 데이터 프레임으로 변환할 수 있습니다.
    - **RServe 입력 데이터:** 입력 데이터는 `variable.arg1`로 정의되며 데이터 유형은 명명된 목록의 목록입니다.
    - **사용자 지정 SQL 입력 데이터:** 지원되는 관계형 데이터 원본의 경우 사용자 지정 SQL을 테이블 확장 프로그램의 입력으로 사용할 수 있습니다. 사용자 지정 SQL 쿼리에 매개 변수가 사용되는 경우 매개 변수를 변경하면 쿼리가 다시 실행되고 스크립트가 다시 계산됩니다. 그러면 대시보드 및 필터에 동적으로 업데이트되는 매개 변수 경로가 만들어집니다. 그렇지 않을 경우 테이블 확장 프로그램 스크립트로 값이 전달됩니다.
        
        참고: 매개 변수가 테이블 확장 프로그램에 사용되는 경우 해당 매개 변수는 확장 프로그램에서 제거될 때까지 삭제할 수 없습니다. 테이블 확장 프로그램에서 호출된 매개 변수를 삭제하면 치명적인 오류가 발생할 수 있습니다.
        
        ![관계형 데이터 원본](/tableau/next/ko-kr/pro/desktop/ko-kr/Img/table_ext_1.PNG)

1. **스크립트** 아래에 스크립트 또는 함수 호출을 입력합니다. 스크립트는 사전 또는 목록의 목록(예: JSON 개체)을 반환해야 합니다. RServe용 스크립트는 data.frame 또는 명명된 목록의 목록을 반환해야 합니다. Python용 스크립트는 사전을 반환해야 합니다.
    - **Python 예:** 명시적 반환 명령 `return df.to_dict(orient='list')`을 사용합니다.
    
    **참고:** TabPy에서 TABPY\_EVALUATE\_ENABLE이 사용되지 않는 경우 테이블 확장 프로그램은 TabPy 끝점에 대한 직접 호출을 지원하지 않습니다.
2. **적용**을 선택하여 스크립트를 실행합니다.
    
    ![스크립트 대화 상자](/tableau/next/ko-kr/pro/desktop/ko-kr/Img/table_ext_2.PNG)
3. _(선택 사항)_ 테이블 확장 프로그램을 데이터 모델의 다른 테이블에 연결하는 경우 각 테이블에서 1개 이상의 필드 간 관계를 정의합니다.
4. **출력** **테이블**의 데이터 그리드에서 **지금 업데이트**를 선택합니다. 출력 테이블 탭에 결과가 나타납니다.
    
    ![결과 출력 테이블](/tableau/next/ko-kr/pro/desktop/ko-kr/Img/table_ext_3.PNG)

**참고**: 데이터 모델의 테이블에 대한 관계를 정의하지 않으면 입력 테이블 탭이 비어 있게 되고 '데이터 미리 보기 사용 불가능'이라는 메시지가 표시됩니다.

1. _(선택 사항)_ **이름** 필드에 새 테이블 확장 프로그램의 고유한 이름을 입력합니다.
2. **시트** 탭으로 이동하여 데이터 탐색 및 시각화를 시작합니다.
3. 통합 문서를 게시하여 공유합니다. 게시 대상()에는 적절한 유형의 분석 확장 프로그램이 사용 설정되고 구성되어 있어야 합니다.

> [!TIP]
> 
> **문제 해결 팁**: 테이블 확장 프로그램에 오류가 발생하는 경우 먼저 모든 코드와 형식이 올바른지 확인하십시오. 그런 다음 툴바에서 순환 모양의 데이터 원본 새로 고침 단추를 사용하거나 적용을 다시 클릭하십시오.

### **확장 프로그램 유형 비교**

다음 제품 중 일부는 서로 관련이 없지만 테이블 확장 프로그램과 분석 확장 프로그램은 여러 기능을 공유합니다. 테이블 확장 프로그램 기능은 분석 확장 프로그램과의 연결을 통해 작동합니다. 각 기능을 살펴보겠습니다.

#### 대시보드 확장 프로그램

[대시보드 확장 프로그램](https://help.tableau.com/current/pro/desktop/ko-kr/dashboard_extensions.htm)에서 대시보드 확장 프로그램 SDK를 사용하여 대시보드에 사용자 지정 웹 응용 프로그램을 추가할 수 있습니다.

#### 테이블 확장 프로그램

테이블 확장 프로그램을 사용하면 데이터 원본에 테이블을 만들고 데이터 및 스크립트를 분석 확장 프로그램으로 전송하여 그 결과로 전체 테이블을 반환할 수 있습니다. 반환된 결과는 데이터 모델에서 테이블로 표시되고 통합 문서에서 측정값 및 차원으로 표시됩니다.

#### 분석 확장 프로그램

[분석 확장 프로그램](https://www.tableau.com/ko-kr/developer/learning/getting-started-analytics-extensions-api) 기능을 사용하면 Tableau 계산을 Python과 같은 프로그래밍 언어, 외부 도구 및 외부 플랫폼으로 확장할 수 있습니다.

분석 확장 프로그램에 대한 연결을 만든 후에는 `SCRIPT_X` 또는 `MODEL_EXTERNAL_X`라는 이름의 계산된 필드를 통해 외부 서버와 통신할 수 있습니다. 여기서 `X`는 예상 반환 값의 데이터 유형입니다. 자세한 내용은 [분석 확장 프로그램으로 식 전달](https://help.tableau.com/current/pro/desktop/ko-kr/r_connection_manage.htm)을 참조하십시오.