Klaviyo 转移作业简介

您可以使用适用于 Klaviyo 的 BigQuery Data Transfer Service 连接器将数据从 Klaviyo 加载到 BigQuery。借助 BigQuery Data Transfer Service，您可以安排周期性转移作业，以将 Klaviyo 中的最新数据添加到 BigQuery。

如需了解如何安排 Klaviyo 转移作业，请参阅 将 Klaviyo 数据加载到 BigQuery。

限制

增量 Klaviyo 转移作业受到以下限制：

  • 您只能选择 TIMESTAMP 列作为水位线列。
  • 仅当资产具有有效的水位线列时，才支持增量提取。
  • 水位线列中的值必须单调递增。
  • 增量转移无法同步源表中的删除操作。
  • 单个转移配置只能支持增量提取或完整提取。
  • 在首次增量提取运行后，您无法更新 asset 列表中的对象。
  • 在首次增量提取运行后，您无法更改转移配置中的写入模式。
  • 在首次增量提取运行后，您无法更改水位线列或主键。
  • 目标 BigQuery 表使用提供的 主键进行聚簇，并受到 聚簇表限制。
  • 首次将现有转移配置更新为增量提取模式时，更新后的首次数据转移作业会转移数据源中的所有可用数据。任何后续增量数据转移作业都只会转移数据源中的新行和更新后的行。

数据注入选项

以下部分介绍了设置 Klaviyo 数据转移作业时可用的数据注入选项。

完整转移或增量转移

在设置 Klaviyo 转移作业时，您可以在转移配置中选择 完整 或 增量 写入偏好设置，以指定数据加载到 BigQuery 的方式。增量转移作业在 预览版中受支持。

您可以配置完整数据转移作业，以便每次数据转移作业都转移 Klaviyo 数据集中的所有数据。

或者，您可以配置 增量 数据转移作业（[预览版](https://cloud.google.com/products#product-launch-stages)），以便仅转移自上次数据转移作业以来发生更改的数据，而不是每次数据转移作业都加载整个数据集。如果您为数据转移选择增量 ，则必须指定附加 或 upsert 写入模式，以定义在增量数据转移期间如何将数据写入 BigQuery。以下各部分介绍了可用的写入模式。

附加写入模式

附加写入模式只会向目标表中插入新行。此选项会严格附加转移的数据，而不检查是否存在现有记录，因此这种模式可能会导致目标表中的数据重复。

选择附加模式时，您必须选择水位线列。Klaviyo 连接器需要一个水位线列来跟踪源表中的更改。

对于 Klaviyo 转移作业，我们建议选择仅在创建记录时更新且不会随后续更新而更改的列，例如 CREATED_AT 列。

Upsert 写入模式

upsert 写入模式会通过检查主键来更新目标表中的行或在其中插入新行。您可以指定主键，以便 Klaviyo 连接器确定需要进行哪些更改才能使目标表与源表保持同步。如果在数据转移期间，指定的主键存在于目标 BigQuery 表中，则 Klaviyo 连接器会使用源表中的新数据更新该行。如果在数据转移期间不存在主键，则 Klaviyo 连接器会插入新行。

选择 upsert 模式时，您必须选择水位线列和主键：

  • Klaviyo 连接器需要一个水位线列来跟踪源表中的更改。
    • 选择一个每次修改行时都会更新的水位线列。我们建议使用类似于 UPDATED_AT 或 LAST_MODIFIED 的列。

  • 主键可以是表中的一列或多列，Klaviyo 连接器需要使用这些列来确定是否需要插入或更新行。

    选择包含非 null 值且在表的所有行中都唯一的列。我们建议使用包含系统生成的标识符、唯一参考代码（例如自动递增的 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 不会产生任何费用。

后续步骤