--- schema_version: "1" id: e40cc2072ff0458e142181b22bfa95d03c5e27fb54b626e0d82b1e0203b20148 title: Tableau Prep 명령줄 참조서 collection: tableau version: current locale: ko-kr portal_url: https://docs.salesforce.com/tableau/current/ko-kr/prep/prep_command_line_reference.md canonical_url: https://help.tableau.com/current/prep/ko-kr/prep_command_line_reference.htm source_site: help.tableau.com content_type: documentation content_hash: b21f447f216fd05bb4addc0656789d9e30cd5489aab4614eae20d6c682f3298a description: Reference for interacting with Tableau Prep through the command line. --- [주요 콘텐츠로 건너뛰기](#main-content) # Tableau Prep 명령줄 참조서 주 응용 프로그램(Tableau Prep.exe) 또는 명령줄 인터페이스(tableau-prep-cli.bat) 중 하나에서 명령줄을 사용하여 Tableau Prep와 상호 작용할 수 있습니다. - Tableau Prep.exe: 응용 프로그램의 초기화 방식을 구성하는 데 사용됩니다. 예를 들어 설치, 활성화, 라이선스, 사용자 데이터 디렉터리 설정, Electron Shell 문제 해결 등이 있습니다. - tableau-prep-cli.bat: 흐름 실행에 사용됩니다. 예를 들어 시각적 인터페이스를 열지 않고 자격 증명과 매개 변수를 전달하고 데이터 출력을 새로 고칠 수 있습니다. 이 문서는 Tableau Prep에서 지원하며 사용자가 사용할 수 있는 모든 명령줄 구문 옵션을, 해당 옵션이 제공되는 유틸리티별로 구분하여 설명합니다. Tableau 개발자 및 지원 부서에서 사용하는 추가로 지원되는 명령줄 구문은 이 문서에 수록되어 있지 않습니다. ## Tableau Prep 응용 프로그램 Tableau Prep.exe 응용 프로그램의 명령줄에서 다음 동작을 수행할 수 있습니다. ### 설치 관리자가 컴퓨터의 명령줄에서 설치 프로그램 .exe 파일을 실행하여 Tableau Prep을 설치합니다. 자세한 내용은 [명령줄에서 설치](https://help.tableau.com/current/desktopdeploy/ko-kr/desktop_deploy_automate.htm)를 참조하십시오. **참고**: 이 옵션은 Windows에서만 사용할 수 있습니다.
구문설명
tableau_<product_installer_name>.exe /option1 /option2 PROPERTY1 PROPERTY2

관리자가 .exe 파일이 위치한 디렉터리에서 명령을 실행하거나 컴퓨터에서 .exe 파일 위치에 대한 전체 경로를 지정합니다. 공유 디렉터리에서 실행하지 마십시오. 지원되는 설치 프로그램 옵션 목록은 설치 프로그램 옵션을 참조하십시오. 지원되는 설치 프로그램 속성 목록은 설치 프로그램 속성을 참조하십시오.

  • tableau_<product_installer_name>.exe는 설치하는 제품 및 버전에 대한 Tableau 설치 프로그램입니다.

  • option1, option2 등은 설치 프로세스를 실행하는 방법입니다.

  • PROPERTY1, PROPERTY2 등은 설치 프로세스 중에 설치 프로그램이 수행해야 하는 구성 설정을 지정합니다.

예:

tableauPrepBuilder-64bit-2026-2-0.exe /quiet /norestart ACCEPTEULA=1 CRASHDUMP="0" SENDTELEMETRY="0"

이 명령은 Tableau 버전 2026.2를 자동 모드로 설치합니다. 즉, 메시지, UI 또는 라이선스 대화 상자를 표시하지 않습니다. 다시 시작하지 않은 채 설치를 마치고, EULA(최종 사용자 사용권 계약)에 동의하고, 오류 보고 및 사용량 보고를 해제하도록 설정합니다.

### 활성화, 라이선스 및 등록 다음 명령을 사용하여 라이선스를 확인하고 설치 도중 또는 이후에 제품을 활성화하고 제품을 등록할 수 있습니다. 자세한 내용은 [Tableau Desktop 및 Tableau Prep Builder 활성화](https://help.tableau.com/current/desktopdeploy/ko-kr/desktop_deploy_automate.htm#activate-tableau-desktop-and-tableau-prep-builder)를 참조하십시오.
구문설명
--activate <key>

제공된 제품 키를 사용하여 제품을 활성화합니다. 성공 시 코드 0으로 종료합니다. 그렇지 않으면 오류 코드와 함께 종료됩니다. 대시 하나만 사용할 수도 있습니다(-activate).

설치하는 동안 제품을 활성화하려면 설치 프로그램 옵션 ACTIVATE_KEY "<키>"를 포함하는 명령줄 한 줄을 추가하고 제품 키를 따옴표로 묶어 입력합니다.

--register

제품을 등록합니다. 대시 하나만 사용할 수도 있습니다(-register). 명령줄에서 Tableau를 등록하려면 Tableau Prep Builder를 실행할 각 컴퓨터에서 레지스트리(Windows) 또는 .plist(Mac) 값을 미리 입력해야 합니다.

Windows의 경우 설치 프로그램 옵션 REGISTER="1"을 포함하는 명령줄 한 줄을 추가하여 설치 중에 제품을 등록할 수 있습니다.

자세한 내용은 Tableau Desktop 및 Tableau Prep Builder 등록을 참조하십시오.

--check-license 라이선스가 없는 경우 활성화 UI를 표시합니다.
--refresh

현재 유지 관리 기간이 만료되는 날짜로 라이선스를 업데이트하고 만료 메시지 표시를 중지합니다. 성공 시 코드 0으로 종료합니다. 대시 하나만 사용할 수도 있습니다(-refresh).

Windows: tableau.exe를 --refresh 옵션과 제품 키를 사용하여 실행합니다.

MacOS: /Applications 경로에 있는 Tableau 개체에서 -refresh 옵션을 실행합니다.

--return <key>

제공된 제품 키를 비활성화하여 다시 사용할 수 있도록 합니다. 대시 하나만 사용할 수도 있습니다(-return).

Windows: tableau.exe를 -return 옵션과 제품 키를 사용하여 실행합니다.

MacOS: /Applications 경로에 있는 Tableau 개체에서 -return 옵션을 실행합니다.

### 구성 및 저장소 다음 명령을 사용하여 파일 설정 및 리포지토리 위치를 구성할 수 있습니다.
구문설명
--settings-file <file location>

주어진 파일에서 응용 프로그램 구성 설정을 로드합니다. 모든 사용자가 사용하는 글로벌 프록시 서버 구성과 흐름에 사용되는 특정 데이터베이스 구성이 있는 경우와 같이 계층화된 구성을 지원하기 위해 여러 번 지정할 수 있습니다.

.json 파일 예:

{
 "connection-sources":[
  {
	"endpoint":"prod-db-server.company.com",
	"username":"service_account_admin",
	"password":"secure_password_123"
	}
 ]
}

명령 예:

Windows: "C:\Program Files\Tableau\Tableau Prep Builder 2026.2\Tableau Prep Builder.exe" --settings-file "C:\ProgramData\Tableau\global-proxy-config.json" --settings-file "C:\Users\jsmith\AppData\Roaming\Tableau\db-config.json"

MacOS: /Applications/Tableau\ Prep\ Builder\ 2026.2.app/Contents/MacOS/Tableau\ Prep\ Builder --settings-file "/Library/Tableau/global-proxy-config.json" --settings-file "/Users/jsmith/Library/Application Support/Tableau/db-config.json"

--repository-location <file path>

리포지토리 디렉터리를 설정합니다. 기본적으로 Tableau Prep은 설치 중에 문서 폴더에 My Tableau Prep Repository(내 Tableau Prep 리포지토리)라는 폴더를 만듭니다. 이 폴더에는 흐름, 데이터 원본, 연결, 로그 파일 및 임시 캐시용 폴더가 포함됩니다. 서버 또는 자동화 환경에서 이 명령을 사용하여 대체 리포지토리 위치를 지정하고 흐름 실행이 해당 위치를 가리키도록 할 수 있습니다.

예:

Windows: "C:\Program Files\Tableau\Tableau Prep Builder 2026.2\Tableau Prep Builder.exe" --repository-location "D:\Tableau_Data\My_Prep_Repo"

MacOS: /Applications/Tableau\ Prep\ Builder\ 2026.2.app/Contents/MacOS/Tableau\ Prep\ Builder --repository-location "/Users/jsmith/Documents/My Tableau Prep Repository"

--user-data-directory <location>

Electron 응용 프로그램 데이터를 저장하는 데 사용되는 디렉터리입니다.

--repository-location은 비즈니스 자산(로그 및 데이터)을 관리하고, --user-data-directory는 응용 프로그램의 내부 엔진을 관리합니다.

관리자는 여러 프로세스가 서로 독립된 응용 프로그램 상태를 유지해야 하는 높은 동시 접속 환경에서 Tableau Prep Builder를 실행 중이거나, 헤드리스 서버에서 지속되는 세션 잠금 오류를 해결할 때 이 플래그를 사용합니다.

참고: 명령을 실행하면 --user-data-directory에 지정된 폴더가 자동으로 만들어집니다. 그러나 스크립트를 실행하는 사용자 계정에는 해당 상위 디렉터리에 대한 '쓰기' 권한이 있어야 합니다.

예:

Windows: "C:\Program Files\Tableau\Tableau Prep Builder 2026.2\Tableau Prep Builder.exe" --user-data-directory "D:\Tableau_Data\Prep_AppData"

MacOS: /Applications/Tableau\ Prep\ Builder\ 2026.2.app/Contents/MacOS/Tableau\ Prep\ Builder --user-data-directory "/Users/jsmith/Library/Application Support/Tableau Prep"

### 파일 열기 다음 명령을 사용하여 Tableau Prep 흐름 파일 .tfl 및 .tflx를 열 수 있습니다.
구문설명
--tfl<file>

지정된 .tfl 흐름 파일을 엽니다. 파일 경로에 공백이 포함된 경우 큰따옴표를 사용하십시오.

예:

Windows: "C:\Program Files\Tableau\Tableau Prep Builder 2026.2\Tableau Prep Builder.exe" -tfl "C:\Users\jsmith\Documents\My Flows\Clean_Sales_Data.tfl"

MacOS: /Applications/Tableau\ Prep\ Builder\ 2026.2.app/Contents/MacOS/Tableau\ Prep\ Builder -tfl "/Users/jsmith/Documents/My Flows/Clean_Sales_Data.tfl"

--tflx<file>

지정된 .tflx 패키지 흐름 파일을 엽니다.

예:

Windows:"C:\Program Files\Tableau\Tableau Prep Builder 2026.2\Tableau Prep Builder.exe" --tflx "C:\Users\jsmith\Desktop\Quarterly_Report.tflx"

MacOS: /Applications/Tableau\ Prep\ Builder\ 2026.2.app/Contents/MacOS/Tableau\ Prep\ Builder --tflx "/Users/jsmith/Desktop/Quarterly_Report.tflx"

## Tableau Prep 명령줄 응용 프로그램 다음 명령은 Tableau Prep 명령줄 인터페이스(tableau-prep-cli.bat)를 사용하여 실행할 수 있습니다. ### 흐름 출력 새로 고침 다음 옵션을 사용하여 명령줄에서 흐름 출력을 새로 고칠 흐름을 실행할 수 있습니다. 이 방법을 사용하면 한 번에 하나의 흐름만 실행할 수 있습니다. 자세한 내용과 제한은 [명령줄에서 흐름 출력 파일 새로 고침](https://help.tableau.com/current/prep/ko-kr/prep_run_commandline.htm)을 참조하십시오.
구문설명
-c, --connections <path>

데이터 원본 및 서버에 대한 자격 증명이 포함된 .json 파일의 경로입니다.

Tableau Prep Builder는 원격 연결이 있을 때 흐름 파일과 자격 증명 .json 파일의 정보를 사용하여 흐름을 실행합니다. 자세한 내용은 자격 증명. json 파일 요구 사항을 참조하십시오.

Snowflake 데이터베이스에 연결하는 경우 역할, 웨어하우스 및 경우에 따라 OAuth 토큰 또는 외부 브라우저 인증과 같은 특정 매개 변수를 포함해야 합니다.

.json 설정 파일 예 - Snowflake:

{
 "connection-sources":[
  {
	"endpoint":"company_account.snowflakecomputing.com",
	"username":"SVC_TABLEAU_PREP",
	"password":"EncryptedPassword123",
	"attributes":{
	 "warehouse": "DATA_LOAD_WH",
	 "role": "TRANSFORM_ROLE"
	}
  }
 ]
}

예:

Windows: "\[Tableau Prep Builder install location]\Tableau Prep Builder <version>\scripts"\tableau-prep-cli.bat -c "path\to\[your credential file name].json" -t "path\to\[your flow file name].tfl"

MacOS: /Applications/Tableau\ Prep\ Builder\ [Tableau Prep Builder version].app/Contents/scripts/./tableau-prep-cli -c path/to/[your credential file name].json -t path/to/[your flow file name].tfl

- p, - - parameters

흐름의 기본 매개 변수 값을 재정의하는 .json 파일의 경로입니다. 이 파일은 credentials.json 파일과 분리된 파일이며 매개 변수 이름과 값을 포함합니다.

자세한 내용은 자격 증명. json 파일 요구 사항에서 '매개 변수 값을 포함하는 흐름 실행'을 참조하십시오.

예:

Windows: "\[Tableau Prep Builder install location]\Tableau Prep Builder <version>\scripts"\tableau-prep-cli.bat -t "path\to\[your flow file name].tfl" -p|--parameters parameters.override.json

MacOS: /Applications/Tableau\ Prep\ Builder\ [Tableau Prep Builder version].app/Contents/scripts/./tableau-prep-cli -t path/to/[your flow file name].tfl -p|--parameters parameters.override.json

-t,--tflFile <file path>Tableau Prep 흐름 파일의 경로입니다.
-inc, --incrementalRefresh

서버에서 Tableau Prep Conductor를 사용하여 흐름 실행을 예약하지 않는 경우 이 명령을 통해 증분 새로 고침을 사용하여 흐름을 실행할 수 있습니다. 자세한 내용은 '증분 새로 고침을 사용하여 흐름 실행'을 참조하십시오.

예:

Windows: "\[Tableau Prep Builder install location]\Tableau Prep Builder <version>\scripts"\tableau-prep-cli.bat --incrementalRefresh -t "path\to\[your flow file name].tfl"

MacOS: /Applications/Tableau\ Prep\ Builder\ [Tableau Prep Builder version].app/Contents/scripts/./tableau-prep-cli --incrementalRefresh -t path/to/[your flow file name].tfl

### 기타 명령 다음 명령을 사용하여 Tableau Prep 버전을 인쇄하고, 디버그 모드를 설정하여 흐름 프로세스를 디버깅하고, SSL 유효성 검사를 사용하지 않도록 설정하는 등의 작업을 수행할 수 있습니다.
구문설명
--versionTableau Prep Builder CLI의 현재 버전을 출력하고 프로세스를 즉시 종료합니다.
-d, --debug

디버그 모드를 사용하도록 설정합니다. 문제 해결을 위해 리포지토리 폴더에 세부적인 로그를 생성합니다. 로그 파일이 저장되는 위치: My Tableau Prep Builder Repository\Command Line Repository\Logs

예:

Windows: "\[Tableau Prep Builder install location]\Tableau Prep Builder <version>\scripts"\tableau-prep-cli.bat --debug -t "[your flow file name].tfl"

MacOS: /Applications/Tableau\ Prep\ Builder\ [Tableau Prep Builder version].app/Contents/scripts/./tableau-prep-cli --debug -t “[your flow file name]”.tfl

-dsv, --disableSslValidation

SSL 인증서 유효성 검사를 사용하지 않도록 설정합니다(일부 내부 서버 환경에 유용함). MacOS에서 이 옵션을 실행하는 경우 키 체인 사용자 및 비밀번호를 묻는 대화 상자가 표시될 수 있습니다.

Tableau Prep Builder 버전 2019.3.2부터 이 추가 매개 변수를 전달하여 이 키 체인 대화 상자를 사용하지 않도록 설정할 수 있습니다.

예:

MacOS: /Applications/Tableau\ Prep\ Builder\ [Tableau Prep Builder version].app/Contents/scripts/./tableau-prep-cli -dsv -c path/to/[your credential file name].json -t path/to/[your flow file name].tfl

-h, --help

명령줄 옵션의 도움말 메뉴를 표시합니다.