部分批摄取

部分批摄取是指能够摄取包含错误的数据,最高可达到某个阈值。 借助此功能,用户可以成功将其所有正确数据收录到Adobe Experience Platform,同时将其所有错误数据分别进行批量处理,并详细说明其无效的原因。

本文档提供了有关管理部分批摄取的教程。

入门指南

本教程需要对与部分批摄取相关的各种Adobe Experience Platform服务有一定的工作知识。 在开始本教程之前,请查阅以下服务的文档:

以下各节提供了成功调用Platform API所需了解的其他信息。

读取示例API调用

本指南提供示例API调用,以演示如何设置请求的格式。 这包括路径、必需的标头和格式正确的请求负载。 还提供API响应中返回的示例JSON。 有关示例API调用文档中使用的约定的信息,请参阅Experience Platform疑难解答指南中关于如何读取示例API调用🔗的部分。

收集所需标题的值

要调用Platform API,您必须首先完成身份验证教程。 完成身份验证教程后,将为所有Experience Platform API调用中每个所需标头提供值,如下所示:

  • 授权:承载{ACCESS_TOKEN}
  • x-api-key:{API_KEY}
  • x-gw-ims-org-id:{IMS_ORG}

Experience Platform中的所有资源都隔离到特定虚拟沙箱。 对Platform API的所有请求都需要一个头,该头指定操作将在中执行的沙箱的名称:

  • x-sandbox-name:{SANDBOX_NAME}
注意

有关Platform中沙箱的详细信息,请参阅沙箱概述文档

在API中启用批处理以进行部分批摄取

注意

本节介绍如何使用API为部分批摄取启用批处理。 有关使用UI的说明,请阅读在UI步骤中启用批以进行部分批摄取。

您可以创建启用了部分摄取的新批。

要创建新批,请按照批摄取开发人员指南中的步骤操作。 到达​Create batch​步骤后,在请求正文中添加以下字段:

{
    "enableErrorDiagnostics": true,
    "partialIngestionPercentage": 5
}
属性 描述
enableErrorDiagnostics 允许Platform生成有关批的详细错误消息的标志。
partialIngestionPercentage 在整个批处理失败之前可接受错误的百分比。 因此,在此示例中,最多5%的批可能是错误,然后才会失败。

在UI中启用批以进行部分批摄取

注意

本节介绍如何使用UI启用批以进行部分批摄取。 如果您已使用API启用了批以进行部分批摄取,则可以跳到下一节。

要通过Platform UI启用批处理以进行部分摄取,您可以通过源连接创建新批处理,在现有数据集中创建新批处理,或通过“Map CSV to XDM flow”创建新批处理。

新建源连接

要创建新的源连接,请按照源概述中列出的步骤操作。 到达​Dataflow detail​步骤后,请注意​Partial ingestion​和​Error diagnostics​字段。

通过​Partial ingestion​切换,可启用或禁用部分批摄取。

Error diagnostics​切换仅在​Partial ingestion​切换关闭时才显示。 此功能允许Platform生成有关所摄取批次的详细错误消息。 如果​Partial ingestion​切换打开,将自动实施增强的错误诊断。

Error threshold​允许您在整个批处理失败之前设置可接受错误的百分比。 默认情况下,此值设置为5%。

使用现有数据集

要使用现有数据集,请通过选择开始集进行数据集。 右侧的提要栏会填充有关数据集的信息。

通过​Partial ingestion​切换,可启用或禁用部分批摄取。

Error diagnostics​切换仅在​Partial ingestion​切换关闭时才显示。 此功能允许Platform生成有关所摄取批次的详细错误消息。 如果​Partial ingestion​切换打开,将自动实施增强的错误诊断。

Error threshold​允许您在整个批处理失败之前设置可接受错误的百分比。 默认情况下,此值设置为5%。

现在,您可以使用​添加数据​按钮上传数据,并且将使用部分摄取来摄取数据。

使用“Map CSV to XDM schema”流

要使用“Map CSV to XDM schema”流,请按照映射CSV文件教程中列出的步骤操作。 到达​Add data​步骤后,请注意​Partial ingestion​和​Error diagnostics​字段。

通过​Partial ingestion​切换,可启用或禁用部分批摄取。

Error diagnostics​切换仅在​Partial ingestion​切换关闭时才显示。 此功能允许Platform生成有关所摄取批次的详细错误消息。 如果​Partial ingestion​切换打开,将自动实施增强的错误诊断。

Error threshold 允许您在整个批处理失败之前设置可接受错误的百分比。默认情况下,此值设置为5%。

后续步骤

本教程介绍了如何创建或修改数据集以启用部分批摄取。 有关批摄取的详细信息,请阅读批摄取开发人员指南

有关监视部分摄取错误的信息,请阅读批摄取错误诊断指南

在此页面上