tabcmd

참고: tabcmd 명령줄 유틸리티 버전 2.0은 Tableau tabcmd(링크가 새 창에서 열림)에서 사용할 수 있습니다. 이 새 버전을 사용하면 MacOS 및 Linux에서 tabcmd 명령을 실행하고 PAT(개인용 액세스 토큰)를 사용하여 인증할 수 있습니다. 버전 2.0은 Python 기반 Tableau Server 클라이언트(TSC)에서 사용할 수 있는 공개 끝점에 구축됩니다. 이 최신 버전은 Tableau Server를 제한적으로 지원합니다.

Tableau는 Tableau Server 사이트에서 사이트 관리 작업을 자동화하는 데 사용할 수 있는 tabcmd 명령줄 유틸리티를 제공합니다. 사용자, 프로젝트, 그룹을 만들거나 삭제하는 작업의 스크립트를 예로 들 수 있습니다.

참고: tabcmd 유틸리티는 Tableau Server에 포함되어 있으며 서버 노드에 자동으로 설치됩니다. 그러나 설치 프로그램이 포함되어 있지 않으므로 Tableau Server 설치에 속하지 않은 컴퓨터에서 tabcmd를 실행하려면 Tableau 웹 사이트에서 설치 프로그램을 다운로드해야 합니다. 자세한 내용은 아래에서 tabcmd 설치를 참조하십시오.

tabcmd 설치

참고: 이러한 지침은 tabcmd 1.0 명령줄 유틸리티 설치에 대한 것입니다. tabcmd 2.0 명령줄 유틸리티를 설치하려면 Tableau tabcmd(링크가 새 창에서 열림)(새 창)로 이동하십시오.

Tableau Server 또는 Tableau Cloud를 새 버전으로 업그레이드할 때 업데이트된 tabcmd 버전이 필요한 경우 Tableau 웹 사이트의 Tableau Server 릴리스 페이지에서 다운로드할 수 있습니다.

Tableau Server의 경우 서버 버전과 일치하는 버전을 다운로드하는 것이 좋습니다. Tableau Cloud의 경우 버전 호환성으로 인한 문제를 방지하려면 항상 최신 버전을 다운로드하는 것이 좋습니다. 어느 경우나 오래된 버전의 tabcmd를 사용하면 오류와 예기치 않은 결과가 발생할 수 있습니다.

  1. 웹 브라우저를 열고 Tableau Server 릴리스(링크가 새 창에서 열림) 페이지로 이동합니다. Tableau Online을 사용하는 경우에도 이 페이지로 이동하십시오.

  2. 다음을 사용하는 경우:

    어느 경우나 확장된 정보에 유지 관리 릴리스가 표시되는 경우 최신 유지 관리 버전 또는 서버 버전과 일치하는 릴리스를 선택합니다.

    사용할 서버 버전 선택(Tableau Cloud의 최신 릴리스)

    선택하면 해결된 문제라고 하는 릴리스 정보 페이지로 이동되며, 이 페이지에서 보안 개선 사항과 해결된 문제를 확인할 수 있습니다.

  3. 아래로 스크롤하여 해결된 문제 아래에 있는 Download Files(파일 다운로드) 섹션으로 이동한 다음 tabcmd 명령을 실행할 컴퓨터와 호환되는 tabcmd 다운로드 링크를 선택합니다. 

    사용할 컴퓨터에 대한 tabcmd 설치 프로그램 선택(32비트 또는 64비트)

    나머지 단계에서는 이 컴퓨터를 “tabcmd 컴퓨터”라고 합니다.

  4. 설치 프로그램을 tabcmd 컴퓨터 또는 해당 컴퓨터에서 액세스할 수 있는 위치에 저장합니다.

  5. tabcmd 컴퓨터의 운영 체제에 맞는 설치 단계를 완료합니다.

    • Windows

      기본적으로 tabcmd는 C:\Program Files\Tableau\Tableau Server\<version>\extras\Command Line Utility에 설치됩니다. 설치 중에 이 위치를 변경할 수 있으며 tabcmd를 C:\ 드라이브의 루트에 있는 tabcmd라는 폴더(C:\tabcmd)에 설치하는 것이 좋습니다. 이렇게 하면 더 쉽게 찾고 실행할 수 있으며 tabcmd 디렉터리를 Windows PATH에 추가하는 경우 Windows 운영 체제와 관련된 몇 가지 제한 사항이 해결됩니다.

      참고 tabcmd 설치 프로그램은 tabcmd 디렉터리를 Windows PATH 변수에 추가하지 않습니다. 수동으로 추가하거나 호출할 때마다 tabcmd에 전체 경로를 포함할 수 있습니다.

      Windows에서 두 가지 방법으로 tabcmd를 설치할 수 있습니다.

      • 설치 프로그램을 두 번 클릭하고 UI의 단계를 따릅니다.

        1. 라이선스 계약을 수락합니다.

        2. 기본값이 아닌 위치에 설치하려는 경우 사용자 지정을 클릭하고 tabcmd를 설치하려는 위치를 입력하거나 찾아보기로 선택합니다.

        3. 설치를 클릭합니다.

          Windows Defender 방화벽 또는 사용자 계정 컨트롤 메시지가 표시되면 액세스 허용을 클릭합니다.

      • 명령 프롬프트에서 설치 프로그램을 실행합니다.

        1. tabcmd 컴퓨터에서 관리자로 명령 프롬프트를 엽니다.

        2. tabcmd 설치 프로그램을 복사한 디렉터리로 이동합니다.

        3. tabcmd를 설치합니다.

          tableau-setup-tabcmd-tableau-<version_code>-x64.exe /quiet ACCEPTEULA=1

          기본 위치가 아닌 위치에 설치하려면:

          tableau-setup-tabcmd-tableau-<version_code>-x64.exe /quiet ACCEPTEULA=1 INSTALLDIR="<path\to\install\directory>"

          예를 들면 다음과 같습니다.

          tableau-setup-tabcmd-tableau-<version_code>-x64.exe /quiet ACCEPTEULA=1 INSTALLDIR="C:\tabcmd"

          tabcmd 설치 프로그램에서 사용할 수 있는 명령줄 옵션의 전체 목록을 보려면 설치 프로그램을 /?과 함께 실행합니다. tabcmd 설치 프로그램 명령줄 옵션에 대한 자세한 내용은 tabcmd의 설치 스위치 및 속성(Windows)을 참조하십시오.

      tabcmd 설치 프로그램은 C:\Users\<user>\AppData\Local\Temp에 로그를 만들며, tabcmd 설치 중에 문제가 발생한 경우 이 로그를 사용할 수 있습니다. 로그에서는 Tableau_Server_Command_Line_Utility_(<version_code>)_##############.log 명명 규칙을 사용합니다.

    • Linux

      참고: Linux 컴퓨터에서 tabcmd를 실행하려면 Java 11이 설치되어 있어야 합니다. RHEL 형식 시스템에서는 tabcmd를 설치할 때 종속 항목으로 설치됩니다. Ubuntu 시스템에서는 Java 11이 설치되어 있지 않은 경우 별도로 설치해야 합니다.

      2022년 7월 기준으로 Debian 배포는 더 이상 지원되지 않습니다. 자세한 내용은 이 Tableau 커뮤니티 게시물(링크가 새 창에서 열림)을 참조하십시오.

      1. tabcmd 컴퓨터에 대한 sudo 액세스 권한이 있는 사용자로 로그온합니다.

      2. 다운로드한 .rpm 또는 .deb 패키지를 복사한 디렉터리로 이동합니다.

        • CentOS를 포함한 RHEL 유사 배포에서 다음 명령을 실행합니다.

          sudo yum install tableau-tabcmd-<version>.noarch.rpm

        • Ubuntu에서 다음 명령을 실행합니다.

          sudo apt-get install ./tableau-tabcmd-<version>_all.deb

    Linux 컴퓨터에서 tabcmd를 제거하려면 실행 중인 Linux 배포판의 설명서를 참조하십시오.

  6. (선택 사항) 명령을 실행할 때마다 위치를 변경하거나 위치를 지정할 필요 없이 tabcmd 명령을 실행할 수 있도록 tabcmd가 설치되어 있는 정규화된 위치를 시스템 경로에 추가합니다. 이 작업을 수행하는 단계는 운영 체제의 유형 및 버전에 따라 달라집니다. 자세한 내용은 PATH_(variable)를 참조하십시오.

tabcmd를 사용하는 방법

tabcmd를 사용하는 기본적인 단계는 다음과 같습니다.

  1. 관리자 자격으로 명령 프롬프트를 엽니다.

    참고: PowerShell을 사용하여 Windows에서 tabcmd 명령을 실행하지 마십시오. PowerShell을 사용하면 예기치 않은 동작이 발생할 수 있습니다.

  2. Windows 컴퓨터에서 초기 노드가 아닌 컴퓨터에 tabcmd를 설치한 경우 tabcmd를 설치한 디렉터리로 변경합니다.

    Linux 컴퓨터에서는 설치 디렉터리를 변경할 필요가 없습니다.

  3. tabcmd 명령을 실행합니다.

tabcmd를 사용할 경우 인증된 서버 세션을 설정해야 합니다. 세션은 서버 또는 Tableau Cloud 사이트 및 세션을 실행 중인 사용자를 식별합니다. 세션을 먼저 시작한 다음 명령을 지정할 수도 있고 세션 시작과 명령 실행을 동시에 수행할 수도 있습니다.

중요: tabcmd를 사용하여 둘 이상의 작업을 수행하는 경우 작업을 동시에(병렬로) 실행하지 말고 하나씩 차례로(연속으로) 실행해야 합니다.

명령(예: login) 및 옵션(예: -s, -u 등)은 대/소문자를 구분하지 않지만 사용자가 제공하는 값(예: User@Example.com)은 대/소문자를 구분합니다.

다음 명령은 tabserver.mycompany.com이라는 Tableau Server에서 세션을 시작하는 방법을 보여 줍니다.

tabcmd login -s http://tabserver.mycompany.com -u admin -p mypassword

다음 예제에서는 Sales_Workbook이라는 통합 문서를 삭제하는 명령을 보여 줍니다.

tabcmd delete "Sales_Workbook" 

명령 하나로 위의 모든 작업을 수행하는 방법은 다음과 같습니다. 이때는 login이 필요 없습니다.

tabcmd delete "Sales_Workbook" -s http://tabserver.mycompany.com -u admin -p mypassword 

Tableau Server는 다중 사이트를 실행할 수 있습니다. 통합 문서가 다중 사이트 서버의 기본 사이트에 있으면 기본(Default)을 지정할 필요가 없으며 위 명령만으로 충분합니다. 하지만 명령이 기본 사이트가 아닌 사이트에 적용되는 경우에는 해당 사이트의 사이트 ID를 지정해야 합니다(login 참조). West Coast Sales 사이트(사이트 ID: wsales)에 있는 통합 문서에 대해 동일한 명령을 실행할 경우에는 다음과 같습니다.

tabcmd delete "Sales_Workbook" -s http://tabserver.mycompany.com -t wsales -u admin -p mypassword 

-s, -t, -u-p 옵션은 tabcmd의 전역 변수 중 일부입니다. 즉, 이러한 옵션은 모든 명령에 사용할 수 있습니다.

자세한 내용은 tabcmd 명령을 참조하십시오.

상태 메시지 및 로그

명령이 성공하면 tabcmd에서 상태 코드 0을 반환합니다. 0이 아닌 상태 코드에 대한 전체 오류 메시지가 stderr에 인쇄됩니다. 또한 정보 또는 진행률 메시지가 stdout에 인쇄될 수 있습니다.

디버깅, 진행률 및 오류 메시지를 포함하는 tabcmd.log라는 전체 로그가 C:\Users\<username>\AppData\Local\Tableau\에 기록됩니다.

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