Klaviyo 轉移作業簡介

您可以使用 Klaviyo 連接器的 BigQuery 資料移轉服務，將資料從 Klaviyo 載入 BigQuery。您可以使用 BigQuery 資料移轉服務，安排週期性移轉工作，將 Klaviyo 的最新資料新增至 BigQuery。

如要瞭解如何排定 Klaviyo 移轉作業，請參閱「將 Klaviyo 資料載入 BigQuery」。

限制

增量 Klaviyo 移轉作業有下列限制：

  • 浮水印資料欄只能選擇 TIMESTAMP 個資料欄。
  • 只有含有有效浮水印欄的資產，才支援增量擷取。
  • 浮水印資料欄中的值必須單調遞增。
  • 增量轉移作業無法同步處理來源資料表中的刪除作業。
  • 單一轉移設定只能支援增量或完整擷取。
  • 第一次執行增量擷取後，就無法更新 asset 清單中的物件。
  • 首次執行增量擷取後，就無法在轉移設定中變更寫入模式。
  • 第一次執行遞增式擷取作業後，就無法變更時間戳記欄或主鍵。
  • 目的地 BigQuery 資料表會使用您提供的主鍵進行叢集，並受叢集資料表限制約束。
  • 首次將現有轉移設定更新為增量擷取模式時，更新後的第一次資料轉移會從資料來源轉移所有可用資料。後續的增量資料轉移作業只會轉移資料來源中的新資料列和更新資料列。

資料擷取選項

這些章節說明設定 Klaviyo 資料轉移時的資料擷取選項。

完整或累加轉移

設定 Klaviyo 轉移作業時，請在轉移設定中選取「完整」或「增量」寫入偏好設定，指定資料載入 BigQuery 的方式。預先發布版支援增量轉移。

您可以設定完整資料轉移，在每次資料轉移時，轉移 Klaviyo 資料集的所有資料。

或者，您也可以設定增量資料移轉作業 ([預覽](https://cloud.google.com/products#product-launch-stages))，只移轉上次資料移轉作業後變更的資料，而非在每次資料移轉作業中載入整個資料集。如果為資料移轉選取「Incremental」(增量)，請務必指定「Append」(附加) 或「Upsert」(新增或更新) 寫入模式，定義增量資料移轉期間資料寫入 BigQuery 的方式。以下各節說明可用的寫入模式。

附加寫入模式

附加寫入模式只會將新資料列插入目的地資料表。這個選項會嚴格附加移轉的資料，不會檢查現有記錄，因此這個模式可能會導致目的地表格中的資料重複。

選取附加模式時，必須選取浮水印欄。Klaviyo 連接器必須使用浮水印資料欄，才能追蹤來源資料表的變更。

如果是 Klaviyo 轉移作業，建議選取只在記錄建立時更新的欄，且不會隨著後續更新而變更，例如 CREATED_AT 欄。

Upsert 寫入模式

系統會檢查主鍵，以更新資料列或在目標資料表中插入新資料列。您可以指定主鍵，讓 Klaviyo 連接器判斷需要進行哪些變更，才能讓目的地資料表與來源資料表保持同步。如果在資料移轉期間，指定的主鍵出現在目標 BigQuery 資料表中，Klaviyo 連接器就會使用來源資料表中的新資料更新該資料列。如果資料轉移期間沒有主鍵，Klaviyo 連接器就會插入新列。

選取「新增或更新」模式時，必須選取浮水印欄和主鍵：

  • Klaviyo 連接器必須使用水位線資料欄，才能追蹤來源資料表中的變更。
    • 選取每次修改資料列時都會更新的水印資料欄。建議使用與 UPDATED_AT 或 LAST_MODIFIED 欄類似的資料欄。

  • 主鍵可以是資料表上的一或多個資料欄，Klaviyo 連接器會根據這些資料欄判斷是否需要插入或更新資料列。

    選取包含非空值的資料欄，這些值在資料表的所有資料列中都是不重複的。建議您使用包含系統產生的 ID、不重複的參照代碼 (例如自動遞增 ID) 或不可變動的時間序列 ID 的資料欄。

    為避免資料遺失或損毀，您選取的主鍵資料欄必須具有不重複的值。如果您對所選主鍵欄的唯一性有疑慮，建議改用附加寫入模式。

資料類型對應

下表列出 Klaviyo 資料類型對應的 BigQuery 資料類型：

Klaviyo 資料類型 BigQuery 資料類型
String STRING
Text STRING
Integer INTEGER
Boolean BOOLEAN
Date (YYYY-MM-DD HH:MM:SS) TIMESTAMP
List ARRAY

定價

這項功能處於預覽階段時，將 Klaviyo 資料移轉至 BigQuery 不會產生費用。

後續步驟