Tableau Prep 도움말

관리자가 .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(최종 사용자 사용권 계약)에 동의하고, 오류 보고 및 사용량 보고를 해제하도록 설정합니다.

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

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

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

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

자세한 내용은 Tableau Desktop 및 Tableau Prep Builder 등록(링크가 새 창에서 열림)을 참조하십시오.

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

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

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

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

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

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

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

.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"

리포지토리 디렉터리를 설정합니다. 기본적으로 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"

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"

지정된 .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 패키지 흐름 파일을 엽니다.

예:

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"

데이터 원본 및 서버에 대한 자격 증명이 포함된 .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

흐름의 기본 매개 변수 값을 재정의하는 .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

서버에서 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

디버그 모드를 사용하도록 설정합니다. 문제 해결을 위해 리포지토리 폴더에 세부적인 로그를 생성합니다. 로그 파일이 저장되는 위치: 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

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

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