Windows 기반 Tableau Server 도움말

참고: Data Cloud의 이전 명칭은 Customer Data Platform이었습니다.

Tableau Server(버전 2023.3 이상)

Salesforce Data Clou 커넥터는 Tableau Desktop 및 Tableau Prep 2023.2 버전용으로, Tableau Cloud 2023년 6월 버전용으로 그리고 Tableau Server 2023.3 버전용으로 출시되었습니다. 이 커넥터를 사용하면 Tableau가 Data Cloud에 원활하게 연결되며 Tableau Desktop, Tableau Cloud, Tableau Server 및 Tableau Prep에서 사용할 수 있습니다. 이전 Customer Data Platform 커넥터에 비해 Salesforce Data Cloud 커넥터는 설정이 더 간단하고, 데이터 공간을 인식하며, 개체 레이블을 더 명확하게 표시하고, 가속화된 쿼리로 구동됩니다. 아래의 단계를 참조하십시오.

참고: Customer Data Platform 커넥터는 Tableau Server 2023.3에서 사용 중단되었으며 Tableau Server 2024.2부터 새 연결에 사용할 수 없습니다. Customer Data Platform 커넥터를 사용하는 기존 통합 문서, 데이터 원본 및 기타 자산은 커넥터가 완전히 제거될 때까지(일반적으로 사용 중단 후 1~2번의 릴리스) 계속 작동합니다. 기존 자산이 계속 작동하도록 하기 위해 Tableau는 고객이 Salesforce Data Cloud 커넥터를 사용하도록 기존 자산을 수정할 것을 강력히 권장합니다.

1단계: Salesforce의 연결된 앱 만들기

Salesforce Data Cloud 커넥터를 사용하려면 Salesforce에서 연결된 앱을 만들어야 합니다.

Salesforce Data Cloud 커넥터와 Salesforce 커넥터 둘 다 동일한 연결된 앱을 공유합니다. 따라서, Salesforce 커넥터를 이미 사용하고 있는 경우 기존 연결된 앱에 7단계에 나열된 세 가지 Customer Data Platform 범위만 추가하면 됩니다.

1. Salesforce.com 개발자 계정에 로그인하고 오른쪽 위에 있는 사용자 이름을 클릭한 다음 설정을 선택합니다.
   
2. 왼쪽 탐색 열의 Apps(앱) 아래에서 App Manager(앱 관리자)를 선택합니다.
   
3. Connected Apps(연결된 앱) 섹션에서 New Connected App(새 연결된 앱)을 클릭합니다.
   
4. Basic Information(기본 정보)에서 앱 이름을 지정하고 API 필드 탭으로 이동합니다. 올바른 형식으로 자동 입력되면 앱의 담당자 이메일을 입력합니다.
5. API [Enable OAuth Settings](API[OAuth 설정 사용]) 섹션에서 Enable OAuth Settings(OAuth 설정 사용)를 선택합니다.
6. 나타난 새 OAuth 설정에서 Callback URL(콜백 URL)에 대해 https 프로토콜을 사용하는 서버의 정규화된 도메인 이름을 입력하고 URL 끝에 auth/add_oauth_token 텍스트를 추가합니다.
   예를 들면 다음과 같습니다.
   https://www.your_tableau_server.com/auth/add_oauth_token
7. 다음 항목을 Available OAuth Scopes(사용 가능한 OAuth 범위)에서 Selected OAuth Scopes(선택된 OAuth 범위)로 이동합니다.
   • ID URL 서비스 액세스(id, profile, email, address, phone)
   • API를 통해 사용자 데이터 관리(api)
   • 언제든지 요청 수행(refresh_token, offline access)
   • Customer Data Platform 데이터에서 ANSI SQL 쿼리 수행(cdp_query_api)
   • Customer Data Platform 프로필 데이터 관리(cdp_profile_api)
   • Customer Data Platform 수집 API 데이터 관리(cdp_ingest_api)
8. 저장을 클릭합니다.

앱을 저장하면 API 섹션에 Salesforce에서 Tableau Server를 구성하는 데 사용할 다음 ID가 입력됩니다.

• 소비자 키
• 소비자 암호
• 콜백 URL

  

2단계: Salesforce.com OAuth에 대해 Tableau Server 구성

Salesforce에서 연결된 앱을 만들고 고객 키, 고객 암호 및 콜백 URL을 확인한 후에는 Salesforce 데이터 연결과 출력 및 Einstein Discovery에 대해 Tableau Server를 구성할 수 있습니다.

1. Tableau Server 컴퓨터의 명령 프롬프트에서 다음 명령을 실행합니다.
   tsm configuration set -k oauth.salesforce.client_id -v <your_customer_key>
tsm configuration set -k oauth.salesforce.client_secret -v <your_customer_secret>
tsm configuration set -k oauth.salesforce.redirect_uri -v <your_redirect_URL>
2. (선택 사항) 기본 로그인 서버를 변경하려면 다음 명령을 입력합니다.
   tsm configuration set -k oauth.salesforce.server_base_url -v <URL>
3. 다음 명령을 입력하여 변경 사항을 적용합니다.
   tsm pending-changes apply
   보류 중인 변경 내용을 적용하려면 서버를 다시 시작해야 하는 경우 pending-changes apply 명령은 서버가 다시 시작됨을 알리는 메시지를 표시합니다. 서버가 중지된 경우에도 이 메시지가 표시되지만 이 경우 다시 시작은 없습니다. --ignore-prompt 옵션을 사용하여 이 메시지를 표시하지 않을 수 있지만 다시 시작 동작은 변경되지 않습니다. 변경 내용을 적용해도 다시 시작할 필요가 없는 경우 메시지 없이 변경 내용이 적용됩니다. 자세한 내용은 tsm pending-changes apply를 참조하십시오.

사이트에 대해 사용자 지정 OAuth 구성

설정 지침은 OAuth 연결 항목을 참조하십시오.

Tableau Server(버전 2023.1 이하)

경고: Customer Data Platform은 2023년 10월에 사용 중단되었으며 Tableau Server 2024.2 이상에서 사용할 수 없습니다. 자산이 계속 작동하도록 하기 위해 Tableau는 고객이 Salesforce Data Cloud 커넥터를 사용하도록 기존 자산을 수정할 것을 권장합니다.

이 섹션에서는 OAuth 인증을 통해 Tableau Server에서 Salesforce Customer Data Platform에 연결하는 방법을 설명합니다.

이 섹션에 설명된 단계는 Tableau Server에서 Salesforce Customer Data Platform을 사용할 때 필요합니다.

1단계: 커넥터 설정

1. Tableau Exchange 커넥터 사이트에서 최신 Salesforce Customer Data Platform 커넥터(Salesforce_CDP.taco 파일)를 다운로드합니다.
2. .taco 파일을 Tableau 커넥터 폴더로 이동합니다.

• Windows: C:\Users[Windows User]\Documents\My Tableau Repository\Connectors
• Linux: /opt/tableau/connectors 또는 /var/opt/tableau_server/data/tabsvc/vizqlserver/Connectors/

3. Tableau Server를 다시 시작합니다.

2단계: Customer Data Platform JDBC 드라이버 설치

참고: Server용 Tableau 버전 2023.1은 JDBC 드라이버 버전 18 이상과만 호환됩니다.

1. Salesforce CDP GitHub 사이트(https://github.com/forcedotcom/Salesforce-CDP-jdbc/releases)에서 최신 JDBC 드라이버(Salesforce-CDP-jdbc-[version].jar 파일)를 다운로드합니다.
2. 다운로드한 Salesforce-CDP-jdbc-[version].jar 파일을 다음 위치로 이동합니다.

• Windows: C:\Program Files\Tableau\Drivers
• Linux: /opt/tableau/tableau_driver/jdbc

3단계: Salesforce의 연결된 앱 만들기

API 범위를 만든 후 다음 절차를 사용하여 Tableau Server로부터의 OAuth 위임을 처리할 Salesforce의 연결된 앱을 만듭니다.

1. Salesforce Customer Data Platform 계정에 관리자로 로그인하고 오른쪽 위에 있는 사용자 이름을 클릭한 다음 Setup(설치)를 선택합니다.

   

2. 왼쪽 패널의 Apps(앱) 아래에서 App Manager(앱 관리자)를 선택합니다.

   

3. Connected Apps(연결된 앱) 섹션에서 New Connected App(새 연결된 앱)을 클릭합니다.

   

4. Basic Information(기본 정보)에서 연결된 앱의 이름(예: Example.com)을 지정하고 API 필드 탭으로 이동합니다. 올바른 형식으로 자체 입력되면 앱의 연락처 이메일 주소를 입력합니다.

5. API [Enable OAuth Settings](API[OAuth 설정 사용]) 섹션에서 Enable OAuth Settings(OAuth 설정 사용)를 선택하고 다음을 수행합니다.

   1. 나타난 새 OAuth 설정에서 Callback URL(콜백 URL)에 대해 https 프로토콜을 사용하여 Tableau Server의 FQDN(정규화된 도메인 이름)을 입력하고 URL 끝에 /auth/add_oauth_token 텍스트를 추가합니다.

      예: https://example.com/auth/add_oauth_token

      

   2. 다음 항목을 Available OAuth Scopes(사용 가능한 OAuth 범위)에서 Selected OAuth Scopes(선택된 OAuth 범위)로 이동합니다.

      • API를 통해 사용자 데이터 관리(api)
      • 언제든지 자동으로 요청(refresh_token, offline_access)
      • Customer Data Cloud 프로필 데이터 관리(cdp_profile_api)
      • Customer Data Platform 데이터에서 ANSI SQL 쿼리 수행(cdp_query_api)

      

6. 작업을 마쳤으면 Save(저장)를 클릭합니다.

7. App Manager(앱 관리자) 목록에서 연결된 앱으로 이동하고 드롭다운 화살표를 클릭한 다음 Manage(관리)를 선택합니다.

   

앱을 저장하면 API (Enable OAuth Settings)(API(OAuth 설정 사용)) 섹션에 Tableau Server를 구성하는 데 사용할 다음 ID가 입력됩니다.

• 소비자 키
• 소비자 암호
• 콜백 URL

  참고: 나중에 사용할 수 있도록 소비자 키, 암호 및 콜백 URL을 저장하십시오.

  
  
  

Customer Data Platform에서 OAuth 사용

1) 서버에 구성된 OAuth 클라이언트를 재정의하거나 2) 고유한 OAuth 클라이언트가 필요한 데이터에 대한 안전한 연결을 지원하려면 사용자 지정 OAuth 클라이언트를 구성하는 것이 좋습니다.

Salesforce에서 연결된 앱을 만들고 소비자 키, 소비자 암호 및 콜백 URL을 확인한 후에는 Customer Data Platform OAuth 연결에 대해 Tableau Server를 구성할 수 있습니다. 시작하려면 다음 정보를 수집합니다.

• 소비자 키: Tableau에서 클라이언트 ID라고 하는 소비자 키는 4단계 끝의 절차에서 생성됩니다. 다음 tsm 명령에서 [your_consumer_key]에 이 값을 사용합니다.
• 소비자 암호: Tableau에서 클라이언트 암호라고 하는 소비자 암호는 4단계 끝의 절차에서 생성됩니다. 다음 tsm 명령에서 [your_consumer_secret]에 이 값을 사용합니다.
• 콜백 URL: Tableau에서 리디렉션 URL이라고 하는 콜백 URL은 Tableau Server URL https://example.com에 "/auth/add_oauth_token"이 추가된 것입니다. 다음 tsm 명령에서 [your_callback_url]에 이 값을 사용합니다.
• 구성 ID: 다음 tsm 명령에서 oauth.config.id 매개 변수에 대한 값입니다. customer_360_audience

TSM 명령을 사용하여 OAuth 설정

다음 tsm 명령을 실행하여 OAuth를 구성합니다.

tsm configuration set -k oauth.config.clients -v "[{\"oauth.config.id\":\"customer_360_audience\", \"oauth.config.client_id\":\"[your_consumer_key]\", \"oauth.config.client_secret\":\"[your_consumer_secret]\", \"oauth.config.redirect_uri\":\"[your_callback_url]\"}]" --force-keys

tsm pending-changes apply

여러 커넥터 설정

여러 커넥터를 설정해야 하는 경우 단일 명령에 모든 커넥터를 포함해야 합니다. 예를 들면 다음과 같습니다. 

tsm configuration set -k oauth.config.clients -v "[{\"oauth.config.id\":\"custom_360_audience\", \"oauth.config.client_id\":\"[your_consumer_key]\", \"oauth.config.client_secret\":\"[your_consumer_secret]\", \"oauth.config.redirect_uri\":\"[your_callback_url]\"}, {\"oauth.config.id\":\"dremio\", \"oauth.config.client_id\":\"[your_client_id]\", \"oauth.config.client_secret\":\"[your_client_secret]\", \"oauth.config.redirect_uri\":\"[your_server_url]/auth/add_oauth_token\"}, {\"oauth.config.id\":\"azure_sql_dw\", \"oauth.config.client_id\":\"[your_client_id]\", \"oauth.config.client_secret\":\"[your_client_secret]\", \"oauth.config.redirect_uri\":\"[your_server_url]/auth/add_oauth_token\"}, {\"oauth.config.id\":\"azure_sqldb\", \"oauth.config.client_id\":\"[your_client_id]\", \"oauth.config.client_secret\":\"[your_client_secret]\", \"oauth.config.redirect_uri\":\"[your_server_url]/auth/add_oauth_token\"}]" --force-keys

tsm pending-changes apply

1단계: OAuth 클라이언트 ID 및 클라이언트 암호 등록

사용자 지정 OAuth 클라이언트를 사이트에 등록하려면 다음 절차를 완료하십시오.

1. 사이트 관리자 자격 증명을 사용하여 Tableau Server에 로그인하고 설정 페이지로 이동합니다.
2. OAuth 클라이언트 레지스트리에서 OAuth 클라이언트 추가 단추를 선택합니다.
3. 연결 유형으로 Customer Data Platform을 선택합니다.
4. OAuth 공급자로 사용자 지정 IDP를 선택합니다.
5. 클라이언트 ID를 입력합니다.
6. 클라이언트 암호를 입력합니다.
7. 리디렉션 URL을 입력합니다.
8. OAuth 구성 파일 선택에서 파일 선택 단추를 선택하고 구성 파일을 업로드합니다.
9. OAuth 클라이언트 추가 단추를 선택하여 등록 프로세스를 완료합니다.
10. 설정 페이지의 맨 아래 또는 맨 위에 있는 저장 단추를 선택하여 변경 내용을 저장합니다.

2단계: 저장된 자격 증명의 유효성 검사 및 업데이트

중단 없는 데이터 액세스를 보장하려면 관리자(및 사이트 사용자)가 이전에 저장된 자격 증명을 삭제하고 다시 추가해야 합니다.

1. 내 계정 설정 페이지로 이동합니다.
2. 데이터 원본의 저장된 자격 증명 아래에서 저장된 기존 자격 증명 옆의 삭제를 선택합니다.
3. 동일한 커넥터 옆에 있는 추가를 선택합니다.
4. 안내 메시지에 따라 Customer Data Platform 커넥터에 연결합니다.
5. 저장을 선택합니다.

3단계: 사용자에게 저장된 자격 증명을 업데이트하도록 알림

사이트 사용자에게 알려 Customer Data Platform 커넥터에 대해 저장된 자격 증명을 업데이트하도록 하십시오. 사이트 사용자는 데이터 연결을 위한 저장된 자격 증명 관리에 설명된 절차를 사용하여 저장된 자격 증명을 업데이트할 수 있습니다.

참고 항목

• Salesforce 도움말: Customer Data Platform에서 Tableau 설정
• Salesforce 도움말: Tableau에서 Customer Data Platform 활성화
• Salesforce 도움말: Tableau의 Customer Data Platform 데이터 사용