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

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

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

  • 이 유틸리티는 Windows에서 Tableau Desktop과 함께 사용할 수 있으며 Windows 시스템에서만 실행할 수 있습니다.

  • Tableau Desktop의 평가판 버전에서 사용할 수 없습니다.

  • OAuth를 사용하지 않는 추출 데이터 원본에 이 유틸리티를 사용할 수 있습니다.

  • 이 유틸리티를 사용하여 단일 연결 데이터 원본만 새로 고칠 수 있습니다. 다중 연결 데이터 원본에서는 작동하지 않습니다.

2022년 10월에 사용 중단됨: Tableau Cloud다단계 인증(링크가 새 창에서 열림) 요구 사항으로 인해 이 유틸리티는 이후 릴리스에서 사용할 수 없습니다. Tableau Cloud에서 직접 연결할 수 없는 데이터 원본 또는 가상 연결 데이터를 새로 고치려면 대신 Tableau Bridge를 사용하십시오. 자세한 내용은 Bridge 새로 고침 일정 설정(링크가 새 창에서 열림)을 참조하십시오.

스크립트를 사용하여 새로 고침 작업을 시작하려면 tabcmd refreshextracts(링크가 새 창에서 열림) 또는 REST API 추출 새로 고침 작업 실행(링크가 새 창에서 열림)을 사용하십시오.

유틸리티 실행

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

예를 들어 구성 파일 만들기 섹션의 샘플에 지정한 추출을 새로 고치려면 다음 명령을 실행합니다. 이때 사용 중인 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 라이브러리의 작업 스케줄러 방법...(링크가 새 창에서 열림) 페이지를 참조하십시오.

피드백을 제공해 주셔서 감사합니다!귀하의 피드백이 제출되었습니다. 감사합니다!