Windows 版 Tableau Server 說明

在 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。與舊版 CDP 連接器相比，Salesforce Data Cloud 連接器更易於連線，顯示物件標籤而不是 API 名稱，並且由加速查詢提供支援。

附註：Data Cloud 先前稱為 Customer Data Platform (CDP)。Tableau Server 2023.3 已棄用 CDP 連接器，在 Tableau Server 2024.2 中不可用，並且從 Tableau Server 2025.1 及更高版本中完全移除。使用 CDP 連接器的現有資產必須使用 Salesforce Data Cloud 連接器重新建立。

如果使用的是 Tableau Server 2023.1 或更早版本，請參閱 Tableau Server（版本 2023.1 及更早版本）。

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

  

在 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 連線主題。

警告：Customer Data Platform 已於 2023 年 10 月棄用，無法用於 Tableau Server 2024.2 中的新連現，並且從 Tableau Server 2025.1 及更高版本中完全移除。如果使用的資產使用 CDP 連接器，Tableau 強烈建議升級並使用 Salesforce Data Cloud 連接器。

本區段為您介紹如何透過 OAuth 驗證從 Tableau Server 連線至 Salesforce Customer Data Platform。

在 Tableau Server 中使用 Salesforce Customer Data Platform 需要執行本區段中描述的步驟。

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。

附註：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

建立 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 用戶端設定為 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

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

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

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

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

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

另請參閱

• Salesforce 說明：在客戶資料平台中設定 Tableau
• Salesforce 說明：在 Tableau 中啟用客戶資料平台
• Salesforce 說明：在 Tableau 中使用客戶資料平台資料