部分批量摄取

部分批量摄取是指摄取包含错误的数据(最高可达特定阈值)的功能。 借助此功能,用户可以成功将其所有正确数据摄取到Adobe Experience Platform中,同时将其所有错误数据分别进行批量处理,并提供有关其无效原因的详细信息。

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

快速入门

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

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

读取示例API调用

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

收集所需标题的值

为了调用 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}
注意

有关 Platform,请参阅 沙盒概述文档.

在API中为部分批量摄取启用批处理

注意

此部分介绍如何使用API启用批量获取部分批量。 有关使用UI的说明,请阅读 在UI中为部分批量摄取启用批处理 中。

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

要创建新批,请按照 批量获取开发人员指南. 一旦您到达 创建批处理 步骤,在请求正文中添加以下字段:

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

在UI中为部分批量摄取启用批处理

注意

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

要通过 Platform UI中,您可以通过源连接创建新批次,在现有数据集中创建新批次,或通过“将CSV映射到XDM流程"

创建新源连接

要创建新的源连接,请按照 源概述. 一旦您到达 数据流详细信息 步骤,请注意 部分摄取错误诊断 字段。

部分摄取 切换允许您启用或禁用对部分批量摄取的使用。

错误诊断 仅当 部分摄取 关闭。 此功能允许 Platform 生成有关所摄取批次的详细错误消息。 如果 部分摄取 打开切换开关,将自动强制执行增强的错误诊断。

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

使用现有数据集

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

部分摄取 切换允许您启用或禁用对部分批量摄取的使用。

错误诊断 仅当 部分摄取 关闭。 此功能允许 Platform 生成有关所摄取批次的详细错误消息。 如果 部分摄取 打开切换开关,将自动强制执行增强的错误诊断。

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

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

使用“将CSV映射到XDM架构“流量”

使用“将CSV映射到XDM架构“流”,请按照 映射CSV文件教程. 一旦您到达 添加数据 步骤,请注意 部分摄取错误诊断 字段。

部分摄取 切换允许您启用或禁用对部分批量摄取的使用。

错误诊断 仅当 部分摄取 关闭。 此功能允许 Platform 生成有关所摄取批次的详细错误消息。 如果 部分摄取 打开切换开关,将自动强制执行增强的错误诊断。

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

后续步骤

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

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

在此页面上