將 Tableau Server 與 Salesforce Data Cloud 連線

附註:Data Cloud 之前稱為 Customer Data Platform。

Tableau Server(版本 2023.3 及更高版本)

在 2023.2 版本中發佈適用於 Tableau Desktop 和 Tableau Prep 的 Salesforce Data Cloud 連接器,在 2023 年 6 月發佈適用於 Tableau Cloud 的連接器,在 2023.3 版本中發佈適用於 Tableau Server 的連接器。此連接器將 Tableau 無縫連線到 Data Cloud,並且適用於 Tableau Desktop、Tableau Cloud、Tableau Server 和 Tableau Prep。與之前的 Customer Data Platform 連接器相比,Salesforce Data Cloud 連接器設定更簡單,可識別資料空間,呈現更清晰的物件標籤,並由加速查詢提供支援。請參閱以下步驟。

附註:Tableau Server 2023.3 已棄用 Salesforce Data Cloud 連接器,且從 Tableau Server 2024.2 開始不能用於新連線。使用 Salesforce Data Cloud 連接器的現有工作簿、資料來源和其他資產將繼續運作,直到連接器被完全刪除(通常在過時後 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. 在左側導覽欄的「應用程式」下,選取「應用程式管理員」
  3. 在「已連線的應用程式」區段中,按一下新建已連線的應用程式
  4. 「基本資訊」中為該應用程式命名,並逐一點選 API 欄位,以便使用正確的格式自動填入,然後輸入該應用程式的聯絡電子郵件。
  5. API [啟用 OAuth 設定]區段中,選取啟用 OAuth 設定
  6. 在出現的新 OAuth 設定中,為「回撥 URL」輸入您伺服器的完整網域名稱,使用 https 通訊協定,並在該 URL 中附加文字 auth/add_oauth_token
    例如:
    https://www.your_tableau_server.com/auth/add_oauth_token
  7. 將下列項目從「可用 OAuth 範圍」移到「所選 OAuth 範圍」
    • 存取身分 URL 服務(ID、個人檔案、電子郵件、地址、電話)
    • 透過 API (api) 管理使用者資料
    • 隨時執行請求(refresh_token、離線存取)
    • 對客戶資料平台資料執行 ANSI SQL 查詢 (cdp_query_api)
    • 管理 Customer Data Platform 個人檔案資料 (cdp_profile_api)
    • 管理 Customer Data Platform 攝取 API 資料 (cdp_ingest_api)
  8. 按一下「儲存」

儲存應用程式後,Salesforce 會在 API 區段中填入以下將用於設定 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 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/
  1. 重新啟動 Tableau Server。

步驟 2:安裝客戶資料平台 JDBC 驅動程式

附註:Tableau Server 版本 2023.1 僅與 JDBC 驅動程式版本 18 及更高版本相容。

  1. 從 Salesforce CDP GitHub 站台下載最新的 JDBC 驅動程序(Salesforce-CDP-jdbc-[版本].jar 文件): https://github.com/forcedotcom/Salesforce-CDP-jdbc/releases
  2. 將下載的 Salesforce-CDP-jdbc-[version].jar 檔案移動到以下位置:
  • Windows:C:\Program Files\Tableau\Drivers
  • Linux: /opt/tableau/tableau_driver/jdbc

步驟 3:建立與 Salesforce 連線的應用程式

建立 API 範圍後,使用以下程序建立與 Salesforce 連線的應用程式,以處理來自 Tableau Server 的 OAuth 委派。

  1. 以管理員身分登入 Salesforce Customer Data Platform 帳戶,按一下右上方的使用者名稱,然後選取「設定」

  2. 在左側窗格的應用程式下,選取應用程式管理器

  3. 在「已連線的應用程式」區段中,按一下新建已連線的應用程式

  4. 「基本資訊」中,為已連線應用程式命名(例如 Example.com),並逐步點選 API 欄位,以便其以正確的格式自動填入,然後輸入該應用程式的聯絡電子郵件地址。

  5. API「啟用 OAuth 設定」區段中,選取啟用 OAuth,執行以下操作:

    1. 在出現的新 OAuth 設定中,對於回呼 URL,輸入 Tableau Server 的完整網域名稱 (FQDN),使用 https 協定,並將以下文字附加到 URL:/auth/add_oauth_token

      例如:https://example.com/auth/add_oauth_token

    2. 將下列項目從可用 OAuth 範圍移到所選 OAuth 範圍

      • 透過 API (api) 管理使用者資料
      • 隨時代表您執行請求 (refresh_token、offline_access)
      • 管理 Customer Data Cloud 設定檔資料 (cdp_profile_api)
      • 對客戶資料平台資料執行 ANSI SQL 查詢 (cdp_query_api)

  6. 完成後,請按一下「儲存」

  7. 移至「應用程式管理員」清單,巡覽到已連線應用程式,按一下下拉箭頭,然後選取「管理」

儲存應用程式後,「API(啟用 OAuth 設定)」區段將填充以下識別碼,您將使用這些識別碼設定 Tableau Server:

  • 取用者金鑰
  • 取用者密碼
  • 回呼 URL

    附註:儲存取用者金鑰、密碼和回呼 URL,以在稍後使用。



將 OAuth 與 Customer Data Platform 一同使用

考慮將自訂 OAuth 用戶端設定為 1) 如果是為伺服器設定,則覆寫 OAuth 用戶端;或 2) 啟用支援安全連線到需要唯一 OAuth 用戶端的資料。

在 Salesforce 中建立已連線應用程式並且擁有取用者金鑰、取用者密碼和回呼 URL 後,可以針對 Customer Data Platform OAuth 連線設定 Tableau Server。開始收集以下資訊。

  • 取用者金鑰:取用者金鑰,在 Tableau 中也稱為用戶端識別碼,由步驟 4 結束時的程序產生。在以下 tsm 命令中的 [your_consumer_key] 使用這個值。
  • 取用者密碼:取用者密碼,在 Tableau 中也稱為用戶端密碼,是從步驟 4 結束時的程序產生。在以下 tsm 命令中的 [your_consumer_secret] 使用這個值。
  • 回呼 URL:回呼 URL,在 Tableau 中也稱為重新導向 URL,是 Tableau Server URLhttps://example.com 和附加至其的 「/auth/add_oauth_token」。在以下 tsm 命令中的 [your_callback_url] 使用這個值。
  • 設定 Id:在後續在後續 tsm customer_360_audience 中使用的 oauth.config.id 參數的值。
使用 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 用戶端識別碼和用戶端密碼

完成以下過程以將自訂 OAuth 用戶端註冊到您的站台。

  1. 使用網站管理員認證登入 Tableau Server,並巡覽到「設定」頁面。
  2. OAuth 用戶端登錄檔下,選取「新增 OAuth 用戶端」按鈕。
  3. 對於「連線類型」,選取客戶資料平台。
  4. 對於 OAuth 提供者,選取「自訂 IDP」
  5. 輸入「用戶端識別碼」
  6. 輸入「用戶端密碼」
  7. 輸入「重新導向 URL」
  8. 對於選擇 OAuth 組態檔,選取「選擇檔案」按鈕上傳組態檔。
  9. 選取「新增 OAuth 用戶端」按鈕以完成註冊過程。
  10. 選取「設定」頁面底部或頂部的「儲存」按鈕以儲存變更。

步驟 2:驗證和更新儲存的認證

為了幫助確保能不間斷進行資料存取,您(和您的站台使用者)必須刪除以前儲存的所有認證並重新新增它們。

  1. 巡覽至「我的帳戶設定」」頁面。
  2. 「儲存的資料來源認證」下,在現有儲存的認證旁選取「刪除」
  3. 在同一連接器旁,選取「新增」
  4. 按照提示連線到 Customer Data Platform 連接器。
  5. 選取「儲存」

步驟 3:通知使用者更新他們儲存的認證

確保通知站台使用者更新其儲存的 Customer Data Platform 連接器認證。站台使用者可以使用「為資料連線管理已儲存認證」中描述的過程來更新他們儲存的認證。

另請參閱
感謝您的意見反應!已成功提交您的意見回饋。謝謝!