部分批次摄取

部分批量摄取是指在一定阈值内摄取包含错误的数据的能力。 借助此功能,用户可以成功地将其所有正确数据摄取到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: {ORG_ID}

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

  • x-sandbox-name: {SANDBOX_NAME}
NOTE
有关Platform中沙盒的更多信息,请参阅沙盒概述文档

在API中为部分批次摄取启用批次 enable-api

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

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

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

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

在UI中为部分批次摄取启用批次 enable-ui

NOTE
本节介绍如何使用UI为部分批次摄取启用批处理。 如果已使用API为部分批次摄取启用批次,则可以跳至下一部分。

要通过Platform UI为部分摄取启用批次,您可以通过源连接创建新批次、在现有数据集中创建新批次或通过“将CSV映射到XDM流”创建新批次。

创建新的源连接 new-source

要创建新的源连接,请按照源概述中列出的步骤操作。 完成​ 数据流详细信息 ​步骤后,请记下​ 部分摄取 ​和​ 错误诊断 ​字段。

通过​ 部分摄取 ​切换,您可以启用或禁用部分批次摄取。

仅当​ 部分摄取 ​切换关闭时,才会显示​ 错误诊断 ​切换。 此功能允许Platform生成有关您摄取的批次的详细错误消息。 如果启用了​ 部分摄取 ​切换,则会自动强制实施增强的错误诊断。

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

使用现有数据集 existing-dataset

要使用现有数据集,请先选择一个数据集。 右侧边栏会填充有关数据集的信息。

通过​ 部分摄取 ​切换,您可以启用或禁用部分批次摄取。

仅当​ 部分摄取 ​切换关闭时,才会显示​ 错误诊断 ​切换。 此功能允许Platform生成有关您摄取的批次的详细错误消息。 如果启用了​ 部分摄取 ​切换,则会自动强制实施增强的错误诊断。

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

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

使用“将CSV映射到XDM架构”流程 map-flow

要使用“将CSV映射到XDM架构”流程,请按照映射CSV文件教程中列出的步骤操作。 完成​ 添加数据 ​步骤后,请记下​ 部分摄取 ​和​ 错误诊断 ​字段。

通过​ 部分摄取 ​切换,您可以启用或禁用部分批次摄取。

仅当​ 部分摄取 ​切换关闭时,才会显示​ 错误诊断 ​切换。 此功能允许Platform生成有关您摄取的批次的详细错误消息。 如果启用了​ 部分摄取 ​切换,则会自动强制实施增强的错误诊断。

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

后续步骤 next-steps

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

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

recommendation-more-help
2ee14710-6ba4-4feb-9f79-0aad73102a9a