Ingesta parcial por lotes
La ingesta parcial por lotes es la capacidad de ingerir datos que contengan errores, hasta un determinado umbral. Con esta capacidad, los usuarios pueden introducir correctamente todos sus datos correctos en Adobe Experience Platform, mientras que todos sus datos incorrectos se agrupan por separado, junto con los detalles de por qué no es válido.
Este documento proporciona un tutorial para administrar la ingesta parcial por lotes.
Primeros pasos
Este tutorial requiere un conocimiento práctico de los distintos servicios de Adobe Experience Platform implicados en la ingesta parcial por lotes. Antes de comenzar este tutorial, revise la documentación de los siguientes servicios:
- Ingesta por lotes: el método que Platform incorpora y almacena datos de archivos de datos, como CSV y Parquet.
- Experience Data Model (XDM): El marco estandarizado mediante el cual Platform organiza los datos de experiencia del cliente.
Las secciones siguientes proporcionan información adicional que deberá conocer para poder realizar llamadas correctamente a Platform API.
Leer llamadas de API de muestra
Esta guía proporciona ejemplos de llamadas API para mostrar cómo dar formato a las solicitudes. Estas incluyen rutas, encabezados obligatorios 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 de 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 los encabezados obligatorios
Para realizar llamadas a Platform API, primero debe completar el tutorial de autenticación. Al completar el tutorial de autenticación, se proporcionan los valores para cada uno de los encabezados necesarios en todas las 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 zonas protegidas virtuales específicas. Todas las solicitudes a Platform Las API requieren un encabezado que especifique el nombre de la zona protegida en la que se realizará la operación:
- x-sandbox-name:
{SANDBOX_NAME}
Habilite un lote para la ingesta parcial por lotes en la API enable-api
Puede crear un nuevo lote con la ingesta parcial habilitada.
Para crear un nuevo lote, siga los pasos de la guía para desarrolladores de ingesta por lotes. Una vez que llegue al Crear lote paso, agregue el siguiente campo dentro del cuerpo de la solicitud:
{
"enableErrorDiagnostics": true,
"partialIngestionPercent": 5
}
enableErrorDiagnostics
partialIngestionPercent
Habilitar un lote para la ingesta parcial por lotes en la IU enable-ui
Para habilitar un lote para la ingesta parcial mediante Platform IU, 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 la "Asignar CSV a flujo XDM".
Crear una nueva conexión de origen new-source
Para crear una nueva conexión de origen, siga los pasos indicados en la sección Resumen de orígenes. Una vez que llegue al Detalles del flujo de datos paso, tome nota de la Ingesta parcial y Diagnósticos de error campos.
El Ingesta parcial permite activar o desactivar el uso de la ingesta parcial por lotes.
El Diagnósticos de error La opción 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 ingeridos. Si la variable Ingesta parcial se activa, los diagnósticos de error mejorados se aplican automáticamente.
El Umbral de error le permite establecer el porcentaje de errores aceptables antes de que falle todo el lote. De forma predeterminada, este valor se establece en 5%.
Usar un conjunto de datos existente existing-dataset
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.
El Ingesta parcial permite activar o desactivar el uso de la ingesta parcial por lotes.
El Diagnósticos de error La opción 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 ingeridos. Si la variable Ingesta parcial se activa, los diagnósticos de error mejorados se aplican automáticamente.
El Umbral de error le permite establecer el porcentaje de errores aceptables antes de que falle todo el lote. De forma predeterminada, este valor se establece en 5%.
Ahora, puede cargar datos mediante el Añadir datos y se incorporará mediante la ingesta parcial.
Utilice el "Asignar CSV a esquema XDM" flujo map-flow
Para usar el complemento "Asignar CSV a esquema XDM", siga los pasos que se indican en la Tutorial sobre asignación de un archivo CSV. Una vez que llegue al Añadir datos paso, tome nota de la Ingesta parcial y Diagnósticos de error campos.
El Ingesta parcial permite activar o desactivar el uso de la ingesta parcial por lotes.
El Diagnósticos de error La opción 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 ingeridos. Si la variable Ingesta parcial se activa, los diagnósticos de error mejorados se aplican automáticamente.
Umbral de error le permite establecer el porcentaje de errores aceptables antes de que falle todo el lote. De forma predeterminada, este valor se establece en 5%.
Pasos siguientes next-steps
En este tutorial se explica cómo crear o modificar un conjunto de datos para habilitar la ingesta parcial por lotes. Para obtener más información sobre la ingesta por lotes, lea la guía para desarrolladores de ingesta por lotes.
Para obtener información sobre la monitorización de los errores de ingesta parcial, lea la guía de diagnósticos de error de ingesta por lotes.