Ingesta parcial por lotes

La ingesta parcial de lotes es la capacidad de ingerir datos que contengan errores, hasta un umbral determinado. Con esta capacidad, los usuarios pueden ingerir correctamente todos sus datos correctos en Adobe Experience Platform, mientras que todos sus datos incorrectos se procesan por lotes por separado, junto con los detalles de por qué no son válidos.

Este documento proporciona un tutorial para administrar la ingesta parcial de lotes.

Primeros pasos

Este tutorial requiere un conocimiento práctico de los distintos servicios de Adobe Experience Platform implicados en la ingesta parcial de lotes. Antes de comenzar este tutorial, consulte la documentación de los siguientes servicios:

  • Ingesta por lotes: El método que Platform Ingesta y almacena datos de archivos de datos, como CSV y Parquet.
  • Experience Data Model (XDM): El marco normalizado por el cual Platform organiza los datos de experiencia del cliente.

Las secciones siguientes proporcionan información adicional que debe conocer para realizar llamadas a Platform API.

Leer llamadas de API de ejemplo

Esta guía proporciona ejemplos de llamadas a la API para demostrar cómo dar formato a las solicitudes. Estas incluyen rutas de acceso, encabezados necesarios y cargas de solicitud con el formato correcto. También se proporciona el JSON de muestra devuelto en las respuestas de API. Para obtener información sobre las convenciones utilizadas en la documentación para las llamadas de API de ejemplo, consulte la sección sobre cómo leer llamadas de API de ejemplo en el Experience Platform guía de solución de problemas.

Recopilar valores para encabezados necesarios

Para realizar llamadas a Platform API, primero debe completar la variable tutorial de autenticación. Al completar el tutorial de autenticación, se proporcionan los valores para cada uno de los encabezados necesarios en todos los Experience Platform Llamadas de API, como se muestra a continuación:

  • Autorización: Portador {ACCESS_TOKEN}
  • x-api-key: {API_KEY}
  • x-gw-ims-org-id: {ORG_ID}

Todos los recursos de Experience Platform están aisladas para entornos limitados virtuales específicos. Todas las solicitudes a Platform Las API requieren un encabezado que especifique el nombre del simulador para pruebas en el que se realizará la operación:

  • x-sandbox-name: {SANDBOX_NAME}
NOTA

Para obtener más información sobre los entornos limitados en Platform, consulte la documentación general de entorno limitado.

Habilitar un lote para la ingesta parcial de lotes en la API

NOTA

En esta sección se describe cómo habilitar un lote para la ingesta parcial de lotes mediante la API. Para obtener instrucciones sobre el uso de la interfaz de usuario, lea la habilitar un lote para la ingesta parcial de lotes en la interfaz de usuario paso a paso.

Puede crear un nuevo lote con la ingesta parcial activada.

Para crear un nuevo lote, siga los pasos de la sección guía para desarrolladores sobre ingesta por lotes. Una vez que llegue al Crear lote , añada el siguiente campo dentro del cuerpo de la solicitud:

{
    "enableErrorDiagnostics": true,
    "partialIngestionPercent": 5
}
Propiedad Descripción
enableErrorDiagnostics Un indicador que permita Platform para generar mensajes de error detallados sobre el lote.
partialIngestionPercent El porcentaje de errores aceptables antes de todo el lote fallará. Por lo tanto, en este ejemplo, un máximo del 5 % del lote puede ser de errores antes de que falle.

Habilitar un lote para la ingesta parcial de lotes en la interfaz de usuario

NOTA

En esta sección se describe cómo habilitar un lote para la ingesta parcial de lotes mediante la interfaz de usuario. Si ya ha habilitado un lote para la ingesta parcial de lotes mediante la API, puede pasar a la siguiente sección.

Para habilitar un lote para la ingesta parcial a través de la variable Platform La interfaz de usuario de puede crear un nuevo lote a través de conexiones de origen, crear un nuevo lote en un conjunto de datos existente o crear un nuevo lote a través de laAsignación de CSV al flujo XDM".

Crear una nueva conexión de origen

Para crear una nueva conexión de origen, siga los pasos indicados en la sección Resumen de fuentes. Una vez que llegue al Detalles de flujo de datos , tome nota del Ingesta parcial y Diagnóstico de errores campos.

La variable Ingesta parcial permite habilitar o deshabilitar el uso de la ingesta parcial de lotes.

La variable Diagnóstico de errores la opción de alternancia solo aparece cuando la variable Ingesta parcial la opción está desactivada. Esta función permite Platform para generar mensajes de error detallados sobre los lotes ingestados. Si la variable Ingesta parcial activa, los diagnósticos de error mejorados se aplican automáticamente.

La variable Umbral de error permite establecer el porcentaje de errores aceptables antes de que se produzca un error en todo el lote. De forma predeterminada, este valor se establece en 5%.

Usar un conjunto de datos existente

Para utilizar un conjunto de datos existente, comience seleccionando un conjunto de datos. La barra lateral de la derecha se rellena con información sobre el conjunto de datos.

La variable Ingesta parcial permite habilitar o deshabilitar el uso de la ingesta parcial de lotes.

La variable Diagnóstico de errores la opción de alternancia solo aparece cuando la variable Ingesta parcial la opción está desactivada. Esta función permite Platform para generar mensajes de error detallados sobre los lotes ingestados. Si la variable Ingesta parcial activa, los diagnósticos de error mejorados se aplican automáticamente.

La variable Umbral de error permite establecer el porcentaje de errores aceptables antes de que se produzca un error en todo el lote. De forma predeterminada, este valor se establece en 5%.

Ahora puede cargar datos mediante la variable Añadir datos y se incorporará mediante ingesta parcial.

Utilice elAsignación de CSV al esquema XDM" flujo

Para usar elAsignación de CSV al esquema XDM", siga los pasos enumerados en la Asignación de un tutorial de archivo CSV. Una vez que llegue al Añadir datos , tome nota del Ingesta parcial y Diagnóstico de errores campos.

La variable Ingesta parcial permite habilitar o deshabilitar el uso de la ingesta parcial de lotes.

La variable Diagnóstico de errores la opción de alternancia solo aparece cuando la variable Ingesta parcial la opción está desactivada. Esta función permite Platform para generar mensajes de error detallados sobre los lotes ingestados. Si la variable Ingesta parcial activa, los diagnósticos de error mejorados se aplican automáticamente.

Umbral de error permite establecer el porcentaje de errores aceptables antes de que se produzca un error en todo el lote. De forma predeterminada, este valor se establece en 5%.

Pasos siguientes

Este tutorial trata sobre cómo crear o modificar un conjunto de datos para habilitar la ingesta parcial de lotes. Para obtener más información sobre la ingesta por lotes, lea la guía para desarrolladores sobre ingesta por lotes.

Para obtener información sobre la monitorización de los errores de ingesta parcial, lea la guía de diagnóstico de errores de ingesta por lotes.

En esta página