Tableau Server를 Salesforce Data Cloud에 연결

Tableau Server(버전 2023.3 이상)

2023년 10월에 Salesforce는 Data Cloud와 Tableau Server를 원활하게 연결하는 새로운 Data Cloud 커넥터를 출시했습니다. Salesforce Data Cloud 커넥터는 이전 릴리스의 Tableau Cloud, Tableau Desktop 및 Tableau Prep에서 이미 사용할 수 있습니다.

참고: Tableau Server UI에는 기존 Customer Data Platform 커넥터와 새 Salesforce Data Cloud 커넥터가 모두 표시됩니다. 2023년 10월에 Customer Data Platform 커넥터가 사용 중단되면 Tableau Desktop UI에 Customer Data Platform 커넥터(사용 중단)가 표시됩니다.

Salesforce Data Cloud 커넥터의 장점

  • 이 커넥터는 Tableau Desktop 설치에 자동으로 포함되며 Taco 파일 및 JDBC 드라이버로 커넥터를 설치하는 추가 단계가 없어집니다.
  • 이 커넥터는 데이터 공간을 자동으로 인식하고 Tableau 연결 UI에서 개체 API 이름 대신 개체 레이블을 표시하는 등 사용성이 향상됩니다.
  • 커넥터는 가속화된 쿼리로 구동됩니다.

참고: Salesforce Data Cloud 커넥터를 사용하려면 Tableau Server 2023.3이 필요합니다. Tableau Server 커넥터를 설정하려면 아래 단계를 수행합니다.

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

새로운 Salesforce Data Cloud 커넥터를 사용하려면 아직은 고객이 자신만의 연결된 앱을 만들어야 합니다. Salesforce 커넥터와 Salesforce Data Cloud 커넥터는 동일한 연결된 앱을 공유합니다. 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

    OAuth 설정

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 사용자 인터페이스에서 제거되며 이 커넥터를 사용하는 모든 데이터 원본이 더 이상 예상대로 작동하지 않게 됩니다. 일반적으로 더 이상 사용되지 않는 커넥터는 사용이 중단된 후 1~2번째 릴리스에서 사용 중지됩니다.

신규 사용자: 신규 사용자인 경우 기본 제공되는 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/
  1. 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 계정에 관리자로 로그인하고 오른쪽 위에 있는 사용자 이름을 클릭한 다음 설치를 선택합니다.

  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 커넥터에 대해 저장된 자격 증명을 업데이트하도록 하십시오. 사이트 사용자는 데이터 연결을 위한 저장된 자격 증명 관리에 설명된 절차를 사용하여 저장된 자격 증명을 업데이트할 수 있습니다.

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