이 페이지가 도움이 되셨나요?
아니요
의견이 있으신가요? 여기에 남겨주세요. 의견을 주셔서 감사합니다!
모든 Tableau 도움말 > Tableau Desktop 및 웹 작성 도움말 >
적용 대상: Tableau Desktop

Tableau 데이터 추출 명령줄 유틸리티

Tableau 데이터 추출 명령줄 유틸리티를 사용하여 추출 새로 고침 작업을 자동화할 수 있습니다. 이것은 Tableau Desktop과 함께 제공되는 명령줄 유틸리티이며, 이를 통해 게시된 추출 데이터 원본을 새로 고치거나 파일의 데이터를 게시된 데이터 원본에 추가할 수 있습니다.

다음은 Tableau 데이터 추출 명령줄 유틸리티를 사용하기 위한 요구 사항입니다.

유틸리티를 실행하기 전에

Tableau 10.4 이하에서 만든 추출(즉, .tde 추출)에 대해 추출 새로 고침 또는 데이터 추가가 수행되면 추출이 자동으로 .hyper 추출로 업그레이드됩니다. .hyper 추출로 업그레이드하면 많은 이점이 있지만 이전 버전의 Tableau Desktop에서 추출을 열 수 없게 됩니다.

자세한 내용은 .hyper 형식으로 추출 업그레이드를 참조하십시오.

유틸리티 실행

  1. 관리자로 명령 프롬프트를 열고 Tableau Desktop bin 디렉터리로 변경합니다. 예를 들면 다음과 같습니다.

    cd C:\Program Files\Tableau\Tableau 2018.2\bin

  2. 아래 표에 설명되어 있는 매개 변수를 추가하여 다음 명령 중 하나를 사용합니다.

참고: 유틸리티를 사용하는 경우 항상 명령줄 또는 스크립트에서 tableau.exe가 아닌 tableau를 지정하십시오.

tableau refreshextract 명령의 구문 및 매개 변수

tableau refreshextract를 사용하여 Tableau Server 또는 Tableau Online에 대한 추출 항목을 새로 고칩니다. 추출을 새로 고치면 마지막 새로 고침 작업 이후 데이터 원본에 적용된 수정 내용으로 기존 추출이 업데이트됩니다.

이 명령에 대한 도움말을 보려면 Windows 명령 프롬프트에서 다음 명령을 입력하십시오.

tableau refreshextract --help

매개 변수 사용

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 Online의 경우 https://online.tableau.com을 지정합니다.

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

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

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

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

사이트 ID는 vernazza입니다.

  --datasource <datasource>

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

  --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 Online 사용자입니다.

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

지정한 Tableau Server 또는 Tableau Online 사용자의 암호입니다.

  --proxy-username <username>

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

  --proxy-password "<password>"

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

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

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

샘플 tableau refreshextract 명령

다음 명령은 Tableau Server 온-프레미스에 게시된 CurrentYrOverYrStats라는 추출을 새로 고칩니다. 이 명령은 다음을 지정합니다.

C:\Program Files\Tableau\Tableau 2018.2\bin>tableau refreshextract --server https://our_server_name --username OurServerSignIn --password "OurServerPwd" --project "New Animations" --datasource "CurrentYrOverYrStats" --source-username OurDatabaseSignIn --source-password "OurDatabasePassword"

다음 명령은 Tableau Online에 게시된 CurrentYrOverYrStats라는 추출을 새로 고칩니다. 이 명령은 다음을 지정합니다.

C:\Program Files\Tableau\Tableau 2018.2\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 2018.2\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 Online에 게시된 추출 항목에 파일 콘텐츠를 추가합니다. 이 명령은 두 파일을 결합합니다.

단순히 기존 추출을 최신 변경 내용으로 업데이트하려는 경우에는 대신 refreshextract 명령을 사용하십시오. addfiletoextract를 사용하여 기존 추출을 업데이트하면 데이터가 복제됩니다.

이 명령에 대한 도움말을 보려면 Windows 명령 프롬프트에서 다음 명령을 입력하십시오.

tableau addfiletoextract --help

모든 옵션에는 두 개의 하이픈과 함께 사용하는 전체 형식이 있습니다(예: --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 Online의 경우 https://online.tableau.com을 지정합니다.

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

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

  --datasource <datasource>

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

  --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 Online 사용자입니다.

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

지정한 Tableau Server 또는 Tableau Online 사용자의 암호입니다.

  --proxy-username <username>

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

  --proxy-password "<password>"

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

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

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

샘플 tableau addfiletoextract 명령

C:\Program Files\Tableau\Tableau 2018.2\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 2018.2\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 Online에 게시되는 호스팅된 데이터 원본의 추출(서버https://online.tableau.com):

server=https://online.tableau.com
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 "<path>"

예를 들어 구성 파일 만들기 섹션의 샘플에 지정한 추출을 새로 고치려면 다음 명령을 실행합니다. 이때 사용 중인 Tableau Desktop 버전의 bin 디렉터리에서 작업을 수행하고 있는지 확인하십시오.

C:\Program Files\Tableau\Tableau 2018.2\bin>tableau refreshextract --config-file "C:\Users\user1\Documents\config.txt"

구성 파일의 구문 차이점

구성 파일 내에서 옵션을 지정하기 위한 구문은 명령줄에서 사용하는 구문과 다음과 같이 다릅니다.

Windows 작업 스케줄러를 사용하여 추출 새로 고침

Windows 작업 스케줄러를 Tableau 데이터 추출 명령줄 유틸리티와 함께 사용하여 회사 방화벽 내에서 Tableau Desktop 데이터 원본에 대한 정기 업데이트를 자동화할 수 있습니다. 하루에 한 번, 일주일에 한 번, 한 달에 한 번 또는 특정 시스템 이벤트 이후에 발생하도록 작업을 구성할 수 있습니다. 예를 들어 컴퓨터가 시작될 때 작업을 실행합니다.

자세한 내용은 Microsoft TechNet 라이브러리의 작업 스케줄러 방법... 페이지를 참조하십시오.