Tableau 수집기 실행 준비

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 5분

    • 수집기를 실행하기 전에 API 액세스, 인증 및 권한을 설정합니다.

    시작하기 전에

    필요한 역할: 관리자

    이 태스크 정보

    수집기는 Tableau 메타데이터 API를 사용하여 메타데이터를 수집합니다. API(Tableau Server의 경우)를 활성화하고, 사용자 권한을 구성하고, 인증 방법을 선택해야 합니다. 필요한 경우 데이터베이스 별칭에 대한 호스트 이름 매핑을 구성합니다.

    프로시저

    1. Tableau 서버에서 메타데이터 API를 사용하도록 설정합니다.

      Tableau 메타데이터 API 활성화 문서를 참조하십시오.

      주:
      메타데이터 API는 Tableau Cloud에 대해 기본적으로 활성화되어 있습니다. 이 단계는 Tableau Server에만 적용됩니다.
    2. 사용자 권한을 구성하고 개인 액세스 토큰을 생성합니다.

      Tableau 사용자 권한 구성 문서를 참조하십시오.

    3. 옵션: 연결된 앱을 사용하여 JWT 인증을 구성합니다.

      Tableau JWT 인증 구성 문서를 참조하십시오.

    4. 옵션: 데이터베이스 별칭에 대한 호스트 이름 매핑을 구성합니다.

      호스트 이름 매핑을 위한 YAML 파일 설정 문서를 참조하십시오.

    Tableau 메타데이터 API 활성화

    메타데이터 수집을 허용하려면 Tableau 서버에서 메타데이터 API를 활성화합니다.

    시작하기 전에

    필요한 역할: 관리자

    다음이 있어야 합니다.

    • Tableau Server 2019.3 이상
    • Tableau Server에서 서버 관리자 역할이 있는 계정
    • REST API 사용(사용 안 함)
    주:
    메타데이터 API는 Tableau Cloud에 대해 기본적으로 활성화되어 있습니다. 이 절차는 Tableau Server에만 적용됩니다.

    이 태스크 정보

    Tableau 수집기는 메타데이터 API를 사용하여 Tableau Server에서 메타데이터를 수집합니다. 기본적으로 이 API는 Tableau Server에서 비활성화되어 있으며 TSM(Tableau Services Manager) 명령줄 인터페이스를 사용하여 활성화해야 합니다.

    프로시저

    1. Tableau Services Manager(TSM)가 클러스터에 설치된 초기 노드에서 관리자로 명령 프롬프트를 엽니다.
    2. 다음 명령을 실행하여 메타데이터 API를 사용하도록 설정합니다. 
      tsm maintenance metadata-services enable
    3. 데이터 관리 라이센스가 없는 경우 파생된 권한을 활성화합니다.

      파생된 권한을 사용하면 관련 외부 자산을 볼 수 있습니다. 자세한 지침은 Tableau 설명서를 참조하십시오.

    결과

    이제 Tableau Server에서 메타데이터 API를 사용할 수 있으며 메타데이터 수집을 할 준비가 되었습니다.

    Tableau 사용자 권한 구성

    관리자 권한이 있는 Tableau 사용자를 생성하고 개인용 접근 토큰을 생성합니다.

    시작하기 전에

    필요한 역할: 관리자

    Tableau Server 또는 Tableau Cloud에서 사용자를 생성하고 역할을 할당할 수 있는 권한이 있어야 합니다.

    이 태스크 정보

    Tableau 수집기에서 메타데이터에 액세스하고 수집하려면 관리자 권한이 있는 사용자 계정이 필요합니다. 전용 사용자 계정을 만들고 인증을 위한 PAT(개인 액세스 토큰)를 생성합니다.

    프로시저

    1. Tableau에서 관리자 권한이 있는 새 사용자를 생성합니다.
      • Tableau Server의 경우 서버 관리자 역할을 할당합니다. 자세한 내용은 Tableau 설명서 를 참조하십시오
      • Tableau Cloud의 경우 사이트 관리자 역할을 할당합니다. 자세한 내용은 Tableau 설명서 를 참조하십시오
    2. 사용자에 대한 PAT(개인 액세스 토큰)를 생성합니다.

      PAT 생성에 대한 자세한 지침은 Tableau 설명서를 참조하십시오.

    3. 개인 액세스 토큰을 안전하게 저장합니다.

      Tableau 메타데이터 수집기를 구성할 때 이 토큰이 필요합니다.

    Tableau JWT 인증 구성

    JWT 인증을 위해 Tableau에서 연결된 앱 설정

    시작하기 전에

    필요한 역할: 관리자

    Tableau에서 연결된 앱을 생성하고 관리할 수 있는 권한이 있어야 합니다.

    중요사항:
    통합 문서 수정 버전 및 데이터 소스 수정 버전을 가져오는 API는 JWT 인증에서 지원되지 않습니다.

    이 태스크 정보

    Tableau 수집기에서 JWT(JSON 웹 토큰) 인증을 사용하도록 연결된 앱을 구성합니다. 연결된 앱은 JWT 토큰을 생성하는 데 필요한 클라이언트 ID, 비밀 ID 및 비밀 값을 제공합니다.

    프로시저

    1. Tableau 인스턴스에 로그인합니다.
    2. 설정으로 이동합니다.
    3. 연결된 앱을 생성합니다.

      자세한 지침은 Tableau 설명서를 참조하십시오.

    4. 연결된 앱을 활성화합니다.
    5. 연결된 앱에서 비밀을 생성합니다.
    6. 연결된 앱 자격 증명을 저장합니다.

      Tableau 수집기를 구성할 때 사용할 다음 값을 기록합니다.

      • 클라이언트 ID
      • 비밀 ID
      • 비밀 값

      이러한 자격 증명은 인증을 위한 JWT 토큰을 생성하는 데 사용됩니다.

    호스트 이름 매핑을 위한 YAML 파일 설정

    데이터베이스 호스트 이름 별칭을 정식 이름에 매핑하는 YAML 파일을 만듭니다.

    시작하기 전에

    필요한 역할: 관리자

    이 태스크 정보

    동일한 데이터베이스 인스턴스에 대해 여러 서버 이름(별칭)이 있고 데이터베이스 수집기가 Tableau 연결에 정의된 별칭과 다른 별칭을 사용하는 경우 호스트 이름 매핑 파일을 사용합니다. 이 선택적 구성은 일관된 IRI 발행을 위해 데이터베이스 호스트 이름을 정식 이름에 매핑합니다.

    프로시저

    1. hostnames.yml라는 YAML 파일을 만듭니다.
    2. 파일에 호스트 이름 매핑 항목을 추가합니다.

      다음 형식을 사용합니다.

      mappingValues:
                        - originalHostname: "<Original_HostName>"
                        canonicalHostname: "<canonical_HostName>"

      예: Tableau 소스에서 db-server-01.company.local을 사용하지만 데이터베이스 객체 IRI 작성 중에 db.company.com 를 호스트 이름으로 사용하려는 경우:

      mappingValues:
                        - originalHostname: "db-server-01.company.local"
                        canonicalHostname: "db.company.com"
      주:
      암호와 같은 중요한 정보에 파일의 환경 변수를 사용할 수 있습니다.
    3. hostnames.yml 파일을 저장합니다.
    4. 호스트 이름 매핑 파일 옵션을 사용하여 YAML 파일을 수집기에 전달합니다.

      수집기를 실행하여 hostnames.yml 파일을 업로드할 때 호스트 이름 매핑 파일 옵션을 사용합니다.

    결과

    수집기는 데이터베이스 객체 IRI를 작성할 때 원래 호스트 이름 대신 정식 호스트 이름을 사용합니다.