--- schema_version: "1" id: e18e67565216af32920d3e024d58c4e93df092aa0195088ce1cb343eb2ed7fc9 title: Tableau 데이터 추출 명령줄 유틸리티 collection: tableau version: next locale: ko-kr portal_url: https://docs.salesforce.com/tableau/next/ko-kr/pro/desktop/extracting_TDE.md canonical_url: https://help.tableau.com/v0.0/pro/desktop/ko-kr/extracting_TDE.htm source_site: help.tableau.com content_type: documentation content_hash: 174b1cb2bf87dc9e1306570e8e5ff46e8f0533abfccd29c438a51629d3619d88 description: Automate extract refresh tasks using the Tableau Data Extract Command-Line Utility. --- [주요 콘텐츠로 건너뛰기](#main-content) # Tableau 데이터 추출 명령줄 유틸리티 Tableau 데이터 추출 명령줄 유틸리티를 사용하여 추출 새로 고침 작업을 자동화할 수 있습니다. 이것은 Tableau Desktop과 함께 제공되는 명령줄 유틸리티이며, 이를 통해 게시된 추출 데이터 원본을 새로 고치거나 파일의 데이터를 게시된 데이터 원본에 추가할 수 있습니다. 다음은 Tableau 데이터 추출 명령줄 유틸리티를 사용하기 위한 요구 사항입니다. - 이 유틸리티는 Windows에서 Tableau Desktop과 함께 사용할 수 있으며 Windows 시스템에서만 실행할 수 있습니다. - Tableau Desktop의 평가판 버전에서 사용할 수 없습니다. - OAuth를 사용하지 않는 추출 데이터 원본에 이 유틸리티를 사용할 수 있습니다. - 이 유틸리티를 사용하여 단일 연결 데이터 원본만 새로 고칠 수 있습니다. 다중 연결 데이터 원본에서는 작동하지 않습니다. **2022년 10월에 사용 중단됨:** Tableau Cloud의 [다단계 인증](https://help.tableau.com/current/online/ko-kr/to_security_mfa.htm) 요구 사항으로 인해 이 유틸리티는 이후 릴리스에서 사용할 수 없습니다. Tableau Cloud에서 직접 연결할 수 없는 데이터 원본 또는 가상 연결 데이터를 새로 고치려면 대신 Tableau Bridge를 사용하십시오. 자세한 내용은 [Bridge 새로 고침 일정 설정](https://help.tableau.com/current/online/ko-kr/to_sync_schedule.htm)을 참조하십시오. 스크립트를 사용하여 새로 고침 작업을 시작하려면 tabcmd [refreshextracts](https://help.tableau.com/current/server/ko-kr/tabcmd_cmd.htm#refreshextracts-workbookname-or-datasourcename) 또는 REST API [추출 새로 고침 작업 실행](https://help.tableau.com/current/api/rest_api/ko-kr/REST/rest_api_ref.htm#run_extract_refresh_task)을 사용하십시오. ## 유틸리티 실행 1. 관리자로 명령 프롬프트를 열고 Tableau Desktop bin 디렉터리로 변경합니다. 예: `cd C:\Program Files\Tableau\Tableau 2022.4\bin` 2. 아래 표에 설명되어 있는 매개 변수를 추가하여 다음 명령 중 하나를 사용합니다. - `tableau refreshextract` - `tableau addfiletoextract` **참고:** 유틸리티를 사용하는 경우 항상 명령줄 또는 스크립트에서 `tableau.exe`가 아닌 `tableau`를 지정하십시오. **참고:** 문제를 해결하려면 \\내 Tableau 리포지토리\\로그 폴더에 있는 tableaucom.txt 파일에서 로그를 확인하십시오. **참고:** 다중 사이트 환경에서 명령이 적용될 사이트를 지정합니다. ## tableau refreshextract 명령의 구문 및 매개 변수 `tableau refreshextract`를 사용하여 Tableau Server 또는 Tableau Cloud에 대한 추출 항목을 새로 고칩니다. 추출을 새로 고치면 마지막 새로 고침 작업 이후 데이터 원본에 적용된 수정 내용으로 기존 추출이 업데이트됩니다. 이 명령에 대한 도움말을 보려면 Windows 명령 프롬프트에서 다음 명령을 입력하십시오. `tableau help refreshextract` ### 매개 변수 사용 - 모든 옵션에는 두 개의 하이픈과 함께 사용하는 전체 형식이 있습니다(예: `--server`). - 또한 일부 옵션에는 한 개의 하이픈과 함께 사용하는 짧은 형식이 있습니다(예: `-s`). - 옵션 값에 공백이 포함된 경우 해당 값을 따옴표로 묶습니다. - 새로 고치는 원본은 추출(`.hyper`)이 아닌 원래 데이터 원본이어야 합니다. ### tableau refreshextract 명령 옵션
짧은 형식전체 형식설명
 --source-username <user name>

데이터 원본 연결에 대해 유효한 사용자 이름입니다.

이 옵션을 --source-password와 함께 사용하거나

--original-file을 사용자 이름 및 암호 옵션 대신 사용합니다.

참고: 데이터 원본이 내장된 자격 증명으로 원래 게시된 경우에도 게시된 추출을 새로 고칠 때 사용자 이름과 암호를 입력해야 합니다.

 --source-password "<password>"

데이터 원본 사용자의 암호입니다.

 

--original-file <path and file name>

또는

--original-file <path and folder name>

서버에서 새로 고칠 데이터 원본에 대한 경로 및 파일 이름입니다. 예: --original-file c:\folder\file.csv

여러 파일로 구성된 데이터 원본을 새로 고치려면 데이터 파일이 포함된 폴더의 경로를 전달합니다. 예: --original-file c:\folder.

파일이 네트워크 공유에 있는 경우 경로에 UNC 형식을 사용합니다. \\server\path\filename.csv

 --force-full-refresh

데이터 원본이 증분 새로 고침이 가능하도록 설정된 경우 이 옵션을 사용하여 전체 추출 새로 고침을 실행합니다. 이 옵션을 포함하지 않으면 증분 새로 고침이 수행됩니다. 일부 데이터 원본은 증분 새로 고침을 지원하지 않습니다.

-s <server http address>--server <URL>

데이터가 게시되는 Tableau Server의 URL입니다.

Tableau Cloud의 경우 https://online.tableau.com을 지정합니다.

-t <site id>--site <siteid>

다중 사이트 환경에서 명령이 적용될 사이트를 지정합니다. Tableau Cloud의 경우 사용자 이름이 둘 이상의 사이트와 연결되어 있다면 이 인수를 사용하십시오. Tableau Server의 경우 사이트를 지정하지 않으면 기본 사이트가 사용됩니다.

사이트 ID는 사이트 이름과 독립적이며 브라우저에서 사이트를 볼 때 URL에 표시됩니다. 예를 들어 Tableau Cloud에 로그온한 후 표시되는 페이지의 URL은 다음과 같습니다.

https://online.tableau.com/t/vernazza/views

사이트 ID는 vernazza입니다.

 --datasource <datasource>

Tableau Server 또는 Tableau Cloud에 게시되는 데이터 원본의 이름입니다.

 --project <projectname>

데이터 원본이 속한 프로젝트입니다. 이 옵션을 포함하지 않으면 기본 프로젝트가 사용됩니다.

지정하려는 프로젝트가 프로젝트 계층 내의 중첩된 하위 프로젝트인 경우 이 매개 변수를 --parent-project-path 매개 변수와 함께 사용해야 합니다.

 --parent-project-path path/to/project

데이터 원본이 게시되는 프로젝트가 프로젝트 계층의 최상위 수준에 없는 경우 이 매개 변수를 --project 매개 변수와 함께 사용하여 중첩된 프로젝트의 경로를 지정해야 합니다.

슬래시 문자(/)를 사용하여 계층의 프로젝트 수준을 구분합니다. 백슬래시 문자(\)를 사용하여 프로젝트 이름에서 슬래시 또는 백슬래시 문자의 인스턴스를 이스케이프합니다.

예를 들어 최상위 수준이 Marketing이고 프로젝트 Social에 포함된 Sandbox라는 이름의 프로젝트의 경우 다음과 같습니다.

--project Sandbox --parent-project-path Marketing/Social

-u <user name>--username <username>

올바른 Tableau Server 또는 Tableau Cloud 사용자입니다.

-p "<password>"--password "<password>"

지정한 Tableau Server 또는 Tableau Cloud 사용자의 비밀번호입니다.

 --proxy-username <username>

프록시 서버의 사용자 이름입니다.

 --proxy-password "<password>"

프록시 서버의 암호입니다.

-c "<path and file name>"--config-file "<path and file name>"

명령의 구성 옵션을 포함하는 파일에 대한 경로 및 파일 이름 정보입니다. 경로는 항상 큰따옴표로 묶습니다. 자세한 내용은 아래에서 구성 파일 사용을 참조하십시오.

### 샘플 tableau refreshextract 명령 다음 명령은 Tableau Server 온-프레미스에 게시된 CurrentYrOverYrStats라는 추출을 새로 고칩니다. 이 명령은 다음을 지정합니다. - Tableau Server의 이름 - 서버 사용자 이름 및 암호 - 프로젝트 이름 - 새로 고칠 데이터 원본의 이름과 데이터 원본 사용자 이름 및 암호 `C:\Program Files\Tableau\Tableau 2022.4\bin>tableau refreshextract --server https://our_server_name --username OurServerSignIn --password "OurServerPwd" --project "New Animations" --datasource "CurrentYrOverYrStats" --source-username OurDatabaseSignIn --source-password "OurDatabasePassword" ` 다음 명령은 Tableau Cloud에 게시된 CurrentYrOverYrStats라는 추출을 새로 고칩니다. 이 명령은 다음을 지정합니다. - Tableau Cloud 사용자 및 비밀번호 - Tableau Cloud 사이트 및 프로젝트 이름 - 데이터 원본(이 경우 Salesforce.com과 같은 클라우드 기반 데이터 원본 공급자에 의해 호스팅됨)과 호스팅된 데이터 원본에 로그인하기 위한 사용자 이름 및 암호 `C:\Program Files\Tableau\Tableau 2022.4\bin>tableau refreshextract --server https://online.tableau.com --username email@domain.com --password "OurServerPwd" --site vernazza --project "New Animations" --datasource "CurrentYrOverYrStats" --source-username database_user@hosted_datasource_provider.com --source-password "db_password"` 파일 기반 데이터 원본의 추출을 새로 고치려면 추출을 만든 원래 파일에 대한 경로를 제공합니다. 파일이 네트워크 공유에 있는 경우 매핑된 드라이브 대신 UNC 형식을 사용합니다. `C:\Program Files\Tableau\Tableau 2022.4\bin>tableau refreshextract --server https://online.tableau.com --username email@domain.com --password "OurServerPwd" --site vernazza --project "New Animations" --datasource "CurrentYrOverYrStats" --original-file "\\server\path\filename.csv"` ## tableau addfiletoextract에 대한 구문 `tableau addfiletoextract`를 사용하여 Tableau Server 또는 Tableau Cloud에 게시된 추출 항목에 파일 콘텐츠를 추가합니다. 이 명령은 두 파일을 결합합니다. 단순히 기존 추출을 최신 변경 내용으로 업데이트하려는 경우에는 대신 `refreshextract` 명령을 사용하십시오. `addfiletoextract`를 사용하여 기존 추출을 업데이트하면 데이터가 복제됩니다. 이 명령에 대한 도움말을 보려면 Windows 명령 프롬프트에서 다음 명령을 입력하십시오. `tableau help addfiletoextract` 모든 옵션에는 두 개의 하이픈과 함께 사용하는 전체 형식이 있습니다(예: `--server`). 또한 일부 옵션에는 한 개의 하이픈과 함께 사용하는 짧은 형식이 있습니다(예: `-s`). 옵션 값에 공백이 포함된 경우 해당 값을 따옴표로 묶습니다. ### tableau addfiletoextract 명령 옵션
짧은 형식전체 형식설명
 --file <path and file name>

추가할 데이터를 포함하는 데이터 파일에 대한 경로 및 파일 이름 정보입니다. 파일은 Excel, Access, Tableau 데이터 추출 또는 구분 기호로 분리된 텍스트 파일일 수 있습니다. 파일을 암호로 보호할 수는 없습니다. 파일이 네트워크 공유에 있는 경우 UNC 형식을 사용합니다. 예를 들어 \\server\path\filename.csv입니다.

-s <server http address>--server <URL>

데이터가 게시되는 Tableau Server의 URL입니다.

Tableau Cloud의 경우 https://online.tableau.com을 지정합니다.

-t <site id>--site <site id>

다중 사이트 환경에서 명령이 적용될 사이트를 지정합니다. Tableau Cloud의 경우 사용자 이름이 둘 이상의 사이트와 연결되어 있다면 이 인수를 포함해야 합니다. Tableau Server의 경우 사이트를 지정하지 않으면 기본 사이트가 사용됩니다.

 --datasource <datasource>

Tableau Server 또는 Tableau Cloud에 게시되는 데이터 원본의 이름입니다.

 --project <projectname>

데이터 원본이 속한 프로젝트입니다. 이 옵션을 포함하지 않으면 기본 프로젝트가 사용됩니다.

지정하려는 프로젝트가 프로젝트 계층 내의 중첩된 하위 프로젝트인 경우 이 매개 변수를 --parent-project-path 매개 변수와 함께 사용해야 합니다.

 --parent-project-path path/to/project

데이터 원본이 게시되는 프로젝트가 프로젝트 계층의 최상위 수준에 없는 경우 이 매개 변수를 --project 매개 변수와 함께 사용하여 중첩된 프로젝트의 경로를 지정해야 합니다.

슬래시 문자(/)를 사용하여 계층의 프로젝트 수준을 구분합니다. 백슬래시 문자(\)를 사용하여 프로젝트 이름에서 슬래시 또는 백슬래시 문자의 인스턴스를 이스케이프합니다.

예를 들어 최상위 수준이 Marketing이고 프로젝트 Social에 포함된 Sandbox라는 이름의 프로젝트의 경우 다음과 같습니다.

--project Sandbox --parent-project-path Marketing/Social

-u <username>--username <username>

올바른 Tableau Server 또는 Tableau Cloud 사용자입니다.

-p "<password>"--password "<password>"

지정한 Tableau Server 또는 Tableau Cloud 사용자의 비밀번호입니다.

 --proxy-username <username>

프록시 서버의 사용자 이름입니다.

 --proxy-password "<password>"

프록시 서버의 암호입니다.

-c "<path and filename>"--config-file "<path and filename>"

명령의 구성 옵션을 포함하는 파일에 대한 경로 및 파일 이름 정보입니다. 경로는 항상 큰따옴표로 묶습니다. 자세한 내용은 아래에서 구성 파일 사용을 참조하십시오.

### 샘플 tableau addfiletoextract 명령 `C:\Program Files\Tableau\Tableau 2022.4\bin>tableau addfiletoextract --server https://our_server_name --username OurServerSignIn --password "OurServerPwd" --project "New Animations" --datasource "CurrentYrOverYrStats" --file "C:\Users\user1\Documents\DataUploadFiles\AprMay.csv"` `C:\Program Files\Tableau\Tableau 2022.4\bin>tableau addfiletoextract --server https://online.tableau.com --username email@domain.com --password "OurServerPwd" --site vernazza --project "New Animations" --datasource "CurrentYrOverYrStats" --file "C:\Users\user2\Documents\DataUploadFiles\AprMay.csv"` ## 구성 파일 사용 메모장이나 텍스트 편집과 같은 일반 텍스트 에디터에서 `tableau refreshextract` 또는 `tableau addfiletoextract`와 함께 사용할 수 있는 구성 파일을 만들 수 있습니다. 시간 경과에 따라 동일한 데이터 원본을 정기적으로 업데이트하려는 경우 구성 파일이 유용할 수 있습니다. 명령을 실행할 때마다 동일한 옵션을 입력하는 대신 구성 파일을 지정합니다. 구성 파일은 명령줄에서 사용자 이름과 암호가 노출되지 않는 이점도 있습니다. ### 구성 파일 만들기 예를 들어 config.txt라는 파일을 만들어 Documents 폴더에 저장했으며, 이 파일에 아래에 나와 있는 매개 변수 정보를 포함했다고 가정해 보겠습니다. Tableau Server에 게시되는 추출: `server=https://our_server_name username=OurServerSignIn password=OurServerPwd project=New Animations datasource=CurrentYrOverYrStats` Tableau Cloud에 게시되는 호스팅된 데이터 원본의 추출(**서버**는 **https://online.tableau.com**): `server=https://online.tableau.com site=vernazza username=email@domain.com password=OurPassword project=New Animations datasource=CurrentYrOverYrStats source-username=database_user@hosted_datasource_provider.com source-password=db_password` ### 명령줄에서 구성 파일 참조 구성 파일을 만든 후에 구성 파일을 명령줄에서 사용하는 유일한 옵션으로 지정하고 구성 파일 경로는 큰따옴표로 묶어 `tableau refreshextract` 또는 `tableau addfiletoextract` 명령을 실행합니다. 구문은 다음과 같습니다. `tableau refreshextract --config-file ""` 예를 들어 [구성 파일 만들기](#Create) 섹션의 샘플에 지정한 추출을 새로 고치려면 다음 명령을 실행합니다. 이때 사용 중인 Tableau Desktop 버전의 bin 디렉터리에서 작업을 수행하고 있는지 확인하십시오. `C:\Program Files\Tableau\Tableau 2022.4\bin>tableau refreshextract --config-file "C:\Users\user1\Documents\config.txt"` ### 구성 파일의 구문 차이점 구성 파일 내에서 옵션을 지정하기 위한 구문은 명령줄에서 사용하는 구문과 다음과 같이 다릅니다. - 옵션 이름이 대시 또는 하이픈으로 시작하지 않습니다. - 공백 없이 등호를 사용하여 옵션 이름과 옵션 값을 구분합니다. - 값에 공백이 포함된 경우에도 값을 따옴표로 묶지 않아도 되며 그렇게 해서도 안 됩니다(앞서 살펴본 예제에서 `project` 옵션). ## Windows 작업 스케줄러를 사용하여 추출 새로 고침 Windows 작업 스케줄러를 Tableau 데이터 추출 명령줄 유틸리티와 함께 사용하여 회사 방화벽 내에서 Tableau Desktop 데이터 원본에 대한 정기 업데이트를 자동화할 수 있습니다. 하루에 한 번, 일주일에 한 번, 한 달에 한 번 또는 특정 시스템 이벤트 이후에 발생하도록 작업을 구성할 수 있습니다. 예를 들어 컴퓨터가 시작될 때 작업을 실행합니다. 자세한 내용은 Microsoft TechNet 라이브러리의 [작업 스케줄러 방법...](http://technet.microsoft.com/ko-kr/library/cc766428.aspx) 페이지를 참조하십시오.