將 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 範圍。
- 登入您的 Salesforce.com 開發人員帳戶,按一下右上方您的使用者名,然後選取 [設定] 。
- 在左側導覽欄的「應用程式」下,選取「應用程式管理員」。
- 在「已連線的應用程式」區段中,按一下新建已連線的應用程式。
- 在「基本資訊」中為該應用程式命名,並逐一點選 API 欄位,以便使用正確的格式自動填入,然後輸入該應用程式的聯絡電子郵件。
- 在 API [啟用 OAuth 設定]區段中,選取啟用 OAuth 設定。
- 在出現的新 OAuth 設定中,為「回撥 URL」輸入您伺服器的完整網域名稱,使用
https
通訊協定,並在該 URL 中附加文字auth/add_oauth_token
。
例如:https://www.your_tableau_server.com/auth/add_oauth_token
- 將下列項目從「可用 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)
- 按一下「儲存」。
儲存應用程式後,Salesforce 會在 API 區段中填入以下將用於設定 Tableau Server 的 ID:
- 取用者金鑰
- 取用者密碼
- 回呼 URL
第 2 步:為 Salesforce.com OAuth 設定 Tableau Server
在 Salesforce 中建立已連線的應用程式並取得取用者金鑰、取用者密碼和回呼 URL 後,即可為 Salesforce 資料連線和輸出以及 Einstein Discovery 設定 Tableau Server。
- 在 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>
- (可選)要變更預設登入伺服器,請鍵入以下命令:
tsm configuration set -k oauth.salesforce.server_base_url -v <URL>
- 輸入以下命令以套用變更:
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:設定連接器
- 從 Tableau Exchange 連接器站台下載最新的 Salesforce Customer Data Platform 連接器(Salesforce_CDP.taco 檔)。
- 將 .taco 檔移動到 Tableau 連接器資料夾:
- Windows:
C:\Users[Windows User]\Documents\My Tableau Repository\Connectors
- Linux:
/opt/tableau/connectors
或/var/opt/tableau_server/data/tabsvc/vizqlserver/Connectors/
- 重新啟動 Tableau Server。
步驟 2:安裝客戶資料平台 JDBC 驅動程式
附註:Tableau Server 版本 2023.1 僅與 JDBC 驅動程式版本 18 及更高版本相容。
- 從 Salesforce CDP GitHub 站台下載最新的 JDBC 驅動程序(Salesforce-CDP-jdbc-[版本].jar 文件): https://github.com/forcedotcom/Salesforce-CDP-jdbc/releases
- 將下載的 Salesforce-CDP-jdbc-[version].jar 檔案移動到以下位置:
- Windows:
C:\Program Files\Tableau\Drivers
- Linux:
/opt/tableau/tableau_driver/jdbc
步驟 3:建立與 Salesforce 連線的應用程式
建立 API 範圍後,使用以下程序建立與 Salesforce 連線的應用程式,以處理來自 Tableau Server 的 OAuth 委派。
以管理員身分登入 Salesforce Customer Data Platform 帳戶,按一下右上方的使用者名稱,然後選取「設定」。
在左側窗格的應用程式下,選取應用程式管理器。
在「已連線的應用程式」區段中,按一下新建已連線的應用程式。
在「基本資訊」中,為已連線應用程式命名(例如 Example.com),並逐步點選 API 欄位,以便其以正確的格式自動填入,然後輸入該應用程式的聯絡電子郵件地址。
在 API「啟用 OAuth 設定」區段中,選取啟用 OAuth,執行以下操作:
在出現的新 OAuth 設定中,對於回呼 URL,輸入 Tableau Server 的完整網域名稱 (FQDN),使用
https
協定,並將以下文字附加到 URL:/auth/add_oauth_token
。例如:
https://example.com/auth/add_oauth_token
將下列項目從可用 OAuth 範圍移到所選 OAuth 範圍:
- 透過 API (api) 管理使用者資料
- 隨時代表您執行請求 (refresh_token、offline_access)
- 管理 Customer Data Cloud 設定檔資料 (cdp_profile_api)
- 對客戶資料平台資料執行 ANSI SQL 查詢 (cdp_query_api)
完成後,請按一下「儲存」。
移至「應用程式管理員」清單,巡覽到已連線應用程式,按一下下拉箭頭,然後選取「管理」。
儲存應用程式後,「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 URL
https://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 用戶端註冊到您的站台。
- 使用網站管理員認證登入 Tableau Server,並巡覽到「設定」頁面。
- 在 OAuth 用戶端登錄檔下,選取「新增 OAuth 用戶端」按鈕。
- 對於「連線類型」,選取客戶資料平台。
- 對於 OAuth 提供者,選取「自訂 IDP」。
- 輸入「用戶端識別碼」。
- 輸入「用戶端密碼」。
- 輸入「重新導向 URL」。
- 對於選擇 OAuth 組態檔,選取「選擇檔案」按鈕上傳組態檔。
- 選取「新增 OAuth 用戶端」按鈕以完成註冊過程。
- 選取「設定」頁面底部或頂部的「儲存」按鈕以儲存變更。
步驟 2:驗證和更新儲存的認證
為了幫助確保能不間斷進行資料存取,您(和您的站台使用者)必須刪除以前儲存的所有認證並重新新增它們。
- 巡覽至「我的帳戶設定」」頁面。
- 在「儲存的資料來源認證」下,在現有儲存的認證旁選取「刪除」。
- 在同一連接器旁,選取「新增」。
- 按照提示連線到 Customer Data Platform 連接器。
- 選取「儲存」。
步驟 3:通知使用者更新他們儲存的認證
確保通知站台使用者更新其儲存的 Customer Data Platform 連接器認證。站台使用者可以使用「為資料連線管理已儲存認證」中描述的過程來更新他們儲存的認證。
另請參閱
- Salesforce 說明:在客戶資料平台中設定 Tableau
- Salesforce 說明:在 Tableau 中啟用客戶資料平台
- Salesforce 說明:在 Tableau 中使用客戶資料平台資料