您可以將 Datastream 連結至 Salesforce 執行個體,複製歷來資料和變更事件,用於數據分析和資料整合。Salesforce 是雲端式客戶關係管理平台,每個執行個體通常稱為「Salesforce 組織」或「Salesforce org」。
在 Datastream 設定 Salesforce 來源時,請詳閱重要詞彙、複製行為、支援的版本和 API 版本、最佳做法和已知限制。
重要詞彙
Salesforce 的運作方式是使用物件、記錄和欄位:
- 「物件」是類別實體,類似於關聯式資料庫命名法中的資料表。物件可以是標準或自訂物件。Salesforce 預設包含標準物件,而自訂物件則由使用者建立,用於儲存特定用途的資料。
- 「記錄」是物件的特定例項,類似於關聯式資料庫中的資料列。
- 「欄位」是物件的特定屬性,類似於關聯式資料庫中的資料欄。
行為
Datastream 的 Salesforce 來源支援功能仰賴 REST 和 Bulk 2.0 API。Salesforce 會根據您設定的間隔輪詢來源變更,以便控管 API 用量。
從 Salesforce 來源複製資料時,會觀察到下列行為:
- 可複製及查詢的標準物件,具有
SystemModstamp欄位或LastModifiedDate欄位,可供複製。物件必須支援getUpdated()和getDeleted()API 呼叫,才能複製。詳情請參閱 Salesforce 說明文件中的「API Calls for Data Replication」(資料複製的 API 呼叫)。 - 自訂物件可以複製。
- 設定完成後,系統會複製所含物件的所有歷來資料。
- 所有變更 (例如從指定物件插入、更新和刪除) 都會複製。
- Datastream 會根據設定的輪詢間隔輪詢變更。這會反映在串流的資料更新間隔指標中。這項指標最多可增加至設定的輪詢間隔值,並反映自最近一次輪詢以來經過的時間。
版本
Datastream 支援下列 Salesforce 版本:
- Pro Suite
- 開發人員
- 專業
- Enterprise
- 無限制
Datastream 使用 Salesforce API 61.0 版。
如要進一步瞭解可用的 Salesforce 版本,請參閱 Salesforce 說明文件。
最佳做法
本節說明設定 Salesforce 來源,以便與 Datastream 搭配使用的建議最佳做法。
管理 API 配額用量
Salesforce 會限制 24 小時滾動週期內可發出的 API 要求數量。從 Salesforce 複製資料時,這項配額用盡是常見的問題。
您可以在 Datastream 中設定輪詢間隔,減少向 Salesforce 提出的 API 要求數量。縮短輪詢間隔可提高資料更新間隔,但也會增加 API 配額用量。建議您設定輪詢間隔,在所選資料更新間隔與 API 配額限制之間取得平衡,確保資料複製作業能持續進行。如有需要,您可以在 Salesforce 中提高全域 API 要求配額。
已知限制
使用 Salesforce 做為來源的已知限制包括:
- 僅支援可查詢及複製的物件。
- 複合欄位會複製為扁平化欄位。
- 每分鐘最多可刪除 600,000 筆資料 (Salesforce 限制)。
- 串流最多可包含 3,000 個物件。
系統僅部分支援計算結果欄位 (也稱為公式)。複製計算欄位時,須遵守下列限制:
- 不支援跨表格參照。
- 不支援非確定性函式 (例如
NOW()或TODAY()),因為 Datastream 無法判斷這些欄位的值何時會變更。 - 僅支援一組特定的允許函式。如果計算欄位使用清單以外的任何函式,就不會複製該欄位。
以下列出支援的函式:
- 邏輯:
AND、OR、NOT、IF、CASE、ISNULL、ISBLANK、BLANKVALUE、ISPICKVAL - 數學:
ABS、CEILING、MCEILING、FLOOR、MFLOOR、ROUND、MOD、SQRT、EXP、LN、LOG、MAX、MIN - 文字:
BEGINS、BR、CONTAINS、FIND、HYPERLINK、INCLUDES、LEFT、LEN、LOWER、LPAD、MID、RPAD、RIGHT、SUBSTITUTE、TEXT、TRIM、UPPER、VALUE - 日期和時間:
DATE、DATEVALUE、DATETIMEVALUE、DAY、MONTH、YEAR、HOUR、MINUTE、SECOND、MILLISECOND、WEEKDAY、TIMEVALUE、ADDMONTHS - 其他:
REGEX
不支援串流復原。
後續步驟
- 瞭解如何設定 Salesforce 來源,以便與 Datastream 搭配使用。