Klaviyo 資料移轉作業簡介

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

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

資料擷取選項

以下各節說明設定 Klaviyo 資料移轉作業時，可用的資料擷取選項。

完整或增量轉移

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

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

或者，您也可以設定增量資料移轉 (預先發布版)，只移轉上次資料移轉後變更的資料，而不是每次資料移轉時都載入整個資料集。如果選取「Incremental」(增量) 做為資料移轉模式，則必須指定「Append」(附加) 或「Upsert」(新增或更新) 寫入模式，定義在增量資料移轉期間，資料寫入 BigQuery 的方式。以下各節將說明可用的寫入模式。

附加寫入模式

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

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

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

更新插入寫入模式

upsert 寫入模式會檢查主鍵，然後更新目的地資料表中的資料列，或插入新的資料列。您可以指定主鍵，讓 Klaviyo 連接器判斷需要進行哪些變更，確保目的地資料表與來源資料表保持最新。如果資料移轉期間，目的地 BigQuery 資料表中有指定的主鍵，Klaviyo 連接器會使用來源資料表的新資料更新該資料列。如果資料移轉期間沒有主鍵，Klaviyo 連接器會插入新資料列。

選取 upsert 模式時，必須選取浮水印欄和主鍵：

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

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

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

    為避免資料遺失或損毀，您選取的主鍵資料欄必須包含不重複的值。如果您不確定所選主鍵欄是否不重複，建議改用附加寫入模式。

資料類型對應

下表將 Klaviyo 資料類型對應至相應的 BigQuery 資料類型：

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

定價

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

後續步驟