部分批次摄取

部分批量摄取是指在一定阈值内摄取包含错误的数据的能力。 借助此功能，用户可以成功地将其所有正确数据摄取到Adobe Experience Platform，同时对其所有不正确的数据进行单独批处理，并且提供有关其无效原因的详细信息。

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

快速入门

本教程需要具备与部分批量摄取相关的各种Adobe Experience Platform服务的实际操作知识。 在开始本教程之前，请查看以下服务的文档：

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

正在读取示例 API 调用

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

收集所需标头的值

要调用Platform API，您必须先完成身份验证教程。 完成身份验证教程会提供所有 Experience Platform API 调用中每个所需标头的值，如下所示：

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

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

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

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

{
    "enableErrorDiagnostics": true,
    "partialIngestionPercent": 5
}

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

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

创建新的源连接 new-source

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

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

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

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

使用现有数据集 existing-dataset

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

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

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

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

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

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

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

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

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

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

后续步骤 next-steps

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

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