토큰 데이터 원본

토큰에는 PAT(개인용 액세스 토큰), 새로 고침 토큰 및 OAuth 토큰을 포함하여 사이트의 만료되지 않은 활성 사용자 토큰에 대한 정보가 포함되어 있습니다. 사이트 관리자는 데이터 원본 전체에서 토큰 사용 및 만료를 모니터링하고 필요에 따라 필수 토큰을 교체할 수 있습니다.

데이터 원본에는 다음 토큰이 포함됩니다.

  • OAuth 데이터베이스 - OAuth 연결에 사용되는 액세스 토큰을 관리합니다. 토큰은 Tableau Cloud 사용자가 삭제하거나 데이터 공급자가 철회하지 않는 한 유효합니다. 자세한 내용은 OAuth 연결을 참조하십시오.

  • OAuth 클라이언트 - Tableau Desktop 및 Tableau Prep과 같은 연결된 클라이언트에 사용되는 새로 고침 토큰을 관리합니다. 자세한 내용은 연결된 클라이언트에서 사이트 액세스를 참조하십시오.

  • PAT(개인용 액세스 토큰) - Tableau REST API로 만들어진 자동화 스크립트 및 작업과 같이 Tableau Cloud에 로그인하는 데 사용되는 수명이 긴 인증 토큰을 관리합니다. 자세한 내용은 개인용 액세스 토큰을 참조하십시오.

언제든지 사이트 관리자는 원하지 않는 토큰이 있는 사용자의 라이선스를 취소하여 신속하게 토큰을 해지할 수 있습니다. 사용자에게 라이선스가 다시 부여되면 새 토큰을 생성해야 한다는 주의 사항이 있습니다. 특정 유형의 토큰을 제거하거나 해지하는 단계는 이전 섹션의 링크를 따르십시오.

사용자 지정 뷰 만들기

사이트 관리자 또는 관리자 인사이트 프로젝트에 대한 액세스 권한이 있는 사용자는 Tableau Cloud에서 웹 작성을 사용하거나 Tableau Desktop을 통해 직접 관리자 인사이트 데이터 원본에 액세스하여 사용자 지정 뷰를 작성할 수 있습니다. 관리자 인사이트 데이터 원본에 대한 자세한 내용은 관리자 인사이트를 사용하여 사용자 지정 뷰 만들기를 참조하십시오.

예: OAuth 데이터베이스 토큰은 언제 마지막으로 업데이트되었습니까?

다음 단계에 따라 조직 내에서 OAuth 데이터베이스 토큰의 마지막 업데이트 시점 및 토큰 교체 규정 준수를 측정하는 뷰를 만들 수 있습니다.

  1. 토큰 데이터 원본에서 나열된 절차 중 하나를 사용하여 토큰 데이터 원본에 연결합니다.

  2. 데이터 패널에서 Token Type(토큰 유형)을 필터 선반으로 끌어옵니다. OAuth 데이터베이스 확인란을 선택하고 확인을 클릭합니다.

  3. Database Type(데이터베이스 유형), Database User Name(데이터베이스 사용자 이름)Last Updated(마지막 업데이트) 선반으로 끌어옵니다.

  4. 선반에서 Last Updated(마지막 업데이트)를 마우스 오른쪽 단추로 클릭하고 상황에 맞는 메뉴에서 정확한 날짜를 선택합니다. 필드를 연속형에서 불연속형으로 변경합니다.

  5. 메뉴에서 분석 > 계산된 필드 만들기를 클릭합니다.

    1. 이름: Days Since Last Update

    2. 계산:

      ROUND(TODAY()-[Last Updated])
  6. 확인을 클릭합니다.

  7. 데이터 패널에서 Days Since Last Update(마지막 업데이트 이후 경과 일수)를 행 선반으로 끌어 놓습니다. 필드를 연속형에서 불연속형으로 변경합니다.

예: 내장된 OAuth 데이터베이스 토큰은 언제 만료됩니까?

뷰 로드 오류 및 추출 새로 고침 실패와 같은 중단을 방지하려면 내장된 OAuth 데이터베이스 토큰의 만료를 모니터링하는 것이 중요합니다. 사용자가 사전에 자격 증명을 새로 고칠 수 있도록 만료가 임박한 토큰을 식별하는 뷰를 만들려면 다음 단계를 따르십시오.

참고: Tableau는 OAuth 데이터베이스 토큰의 만료 시간을 저장하지 않습니다. 이 정보를 얻으려면 데이터베이스 관리자에게 문의하여 각 데이터베이스 유형에 대한 만료 세부 정보를 확인해야 합니다.

  1. 토큰 데이터 원본에 연결합니다.

  2. 데이터 패널에서 Token Type(토큰 유형)을 필터 선반으로 끌어옵니다. OAuth 데이터베이스 확인란을 선택하고 확인을 클릭합니다.

  3. Database Type(데이터베이스 유형)Owner Email(소유자 이메일)을 행 선반으로 끌어옵니다.

  4. 메뉴에서 분석 > 계산된 필드 만들기를 클릭합니다. 다음 예에서는 만료 기간이 90일인 Snowflake 데이터베이스를 사용합니다.

    1. 이름: Expires At (all tokens)

    2. 계산:

      IF [Token Type] = 'OAuth Database'
      THEN
      IF [Database Type] = 'snowflake'
      THEN DATEADD('day', 90, [Last Updated])
      // add conditions for other database types here //
      ELSE NULL
      END
      ELSE [Expires At]
      END
  5. 메뉴에서 분석 > 계산된 필드 만들기를 클릭합니다.

    1. 이름: Days Until Expiration

    2. 계산:

      DATEDIFF('day', TODAY(), [Expires At (all tokens)])
  6. Days Until Expiration(만료까지 남은 일수)을 행 선반으로 끌어옵니다. 필드를 연속형에서 불연속형으로 변경합니다.

  7. Days Until Expiration(만료까지 남은 일수)을 필터 선반으로 끌어옵니다. All Values(모든 값)를 선택하고 최대값을 14로 설정합니다. 이는 향후 14일 이내에 만료되는 토큰이나 이미 만료된 토큰을 필터링합니다. 필요에 맞게 조정하면 됩니다.

  8. 결과 값을 사용하여 토큰 만료 예정으로 설정된 사용자에게 연락합니다.

예: 사이트에서 PAT를 소유한 사용자는 누구입니까?

다음 예에서는 사이트에서 PAT를 소유한 사용자의 이름과 사이트 역할을 표시합니다. 다른 토큰 유형을 위해 필터를 조정할 수 있습니다.

  1. 토큰 및 TS 사용자 데이터 원본에 연결합니다.

  2. 데이터 > 혼합 관계 편집을 선택합니다.

  3. 혼합 관계 대화 상자에서 주 데이터 원본을 토큰 으로 설정하고 사용자 지정 라디오 버튼을 선택합니다.

  4. 추가를 클릭합니다.

  5. 필드 매핑 추가/편집 대화 상자에서 Owner Email(소유자 이메일)User Email(사용자 이메일)에 매핑하고 확인 > 확인을 클릭합니다.

  6. 데이터 패널에서 Token Type(토큰 유형)을 필터 선반으로 끌어옵니다. PAT 확인란을 선택하고 확인을 클릭합니다.

  7. 데이터 패널에서 User Name(사용자 이름), User Site Role(사용자 사이트 역할), Expires At(만료 시간)Last Used At(마지막 사용 시간) 선반으로 끌어옵니다.

  8. User Email(사용자 이메일)데이터 패널에서 연결된 필드인지 확인합니다. 끊긴 링크가 있으면 필드명 옆에 있는 아이콘을 클릭하여 두 데이터 원본을 연결합니다.
  9. 선반에서 Expires At(만료 시간)을 마우스 오른쪽 단추로 클릭하고 상황에 맞는 메뉴에서 정확한 날짜를 선택합니다. 필드를 연속형에서 불연속형으로 변경합니다.

  10. Last Used At(마지막 사용 시간)에 대해 7단계를 반복합니다.

더 많은 데이터 활용

Tableau Prep을 사용하면 다음 필드에서 관리자 인사이트 데이터 원본을 조인하여 사이트에 대한 더 많은 가시성을 확보할 수 있습니다. 여러 Tableau Cloud 사이트의 데이터를 분석하는 경우 "Site LUID = Site LUID"에서도 조인해야 합니다.

  • 토큰 소유자의 사이트 역할을 보려면 “Owner Email” = “User Email”에서 토큰을 TS 사용자에 조인합니다.

  • 토큰 소유자의 그룹 멤버십을 보려면 “Owner Email” = “User Email”에서 토큰을 그룹에 조인합니다.

자세한 내용은 Tableau Prep 도움말에서 데이터 집계, 조인 또는 유니온(링크가 새 창에서 열림)을 참조하십시오.

데이터 스키마

다음 표에는 토큰 데이터 원본에 포함된 필드가 나열되어 있습니다. 각 데이터 행은 토큰 ID와 소유자 이메일의 조합에 해당합니다.

폴더필드명유형설명
데이터베이스자산 키 ID숫자데이터베이스 항목의 ID입니다. OAuth 데이터베이스 토큰에 적용됩니다.
데이터베이스 유형문자열Salesforce, Snowflake 등 데이터베이스 유형입니다. OAuth 데이터베이스 토큰에 적용됩니다.
데이터베이스 사용자 이름문자열데이터베이스 연결된 사용자의 이름입니다. OAuth 데이터베이스 토큰에 적용됩니다.
인스턴스 URL문자열데이터 공급자의 인스턴스 URL입니다(예: https://login.salesforce.com). OAuth 데이터베이스 토큰에 적용됩니다.
마지막 업데이트날짜/시간데이터 원본 자격 증명이 마지막으로 변경된 날짜 및 시간(UTC 기준)입니다. OAuth 데이터베이스 토큰에 적용됩니다.
기기기기 ID문자열토큰과 연관된 연결된 클라이언트의 ID입니다. OAuth 클라이언트 토큰에 적용됩니다.
기기 이름문자열토큰과 연관된 연결된 클라이언트의 이름입니다. OAuth 클라이언트 토큰에 적용됩니다.
사이트사이트 LUID문자열Tableau Cloud 사이트의 LUID입니다. 주로 REST API를 통해 콘텐츠를 참조하는 데 사용됩니다.
사이트 이름문자열Tableau Cloud 사이트의 이름입니다.
토큰만료 시간날짜/시간토큰이 만료되는 날짜 및 시간(UTC 기준)입니다. PAT 및 OAuth 클라이언트 토큰에 적용됩니다.
GUID문자열토큰의 고유 ID입니다. PAT 및 OAuth 클라이언트 토큰에 적용됩니다.
발급 시간날짜/시간토큰이 발급된 날짜와 시간(UTC 기준)입니다.
마지막 사용 시간날짜/시간토큰이 마지막으로 사용된 날짜 및 시간(UTC 기준)입니다. PAT 및 OAuth 클라이언트 토큰에 적용됩니다.
소유자 이메일문자열토큰 소유자의 이메일 주소입니다.
PAT 이름문자열개인용 액세스 토큰의 이름입니다. PAT에 적용됩니다.
토큰 식별자문자열PAT 및 OAuth 클라이언트 토큰의 GUID와 OAuth 데이터베이스 토큰의 자산 키 ID를 사용하여 데이터 행을 고유하게 식별합니다.
토큰 유형문자열토큰 유형에 대한 열거형 값입니다. PAT(개인용 액세스 토큰), OAuth 클라이언트 또는 OAuth 데이터베이스 중 하나입니다.
-관리자 인사이트 게시 시간날짜/시간관리자 인사이트 데이터 원본이 마지막으로 게시된 날짜 및 시간(UTC 기준)입니다.