Guía de solución de problemas de ingesta por lotes

Esta documentación ayudará a responder a las preguntas más frecuentes sobre las API de Adobe Experience Platform Batch Data Ingestion.

Llamadas de API por lotes

¿Los lotes están activos inmediatamente después de recibir HTTP 200 OK de la API CompleteBatch?

La respuesta 200 OK de la API significa que el lote se ha aceptado para su procesamiento; no está activo hasta que pasa a su estado final, como Activo o Fallo.

¿Es seguro volver a intentar la llamada de API CompleteBatch después de que falle?

Sí: es seguro volver a intentar la llamada de API. A pesar del fallo, es posible que la operación haya tenido éxito y que el lote haya sido aceptado con éxito. Sin embargo, se espera que los clientes tengan mecanismos de reintento en caso de que falle la API y, de hecho, se les recomienda que lo vuelvan a intentar. Si la operación se realiza correctamente, la API devolverá un error, incluso después de volver a intentarlo.

¿Cuándo se debe utilizar la API de carga de archivos grandes?

El tamaño de archivo recomendado para usar la API de carga de archivos grandes es de 256 MB o más. Puede encontrar más información sobre cómo utilizar la API de carga de archivos grandes aquí.

¿Por qué falla la llamada a la API Large File Complete?

Si se encuentran fragmentos de un archivo grande superpuestos o que faltan, el servidor responde con una solicitud incorrecta HTTP 400. Esto puede ocurrir porque es posible cargar fragmentos superpuestos, ya que las validaciones de rango se realizan en el momento de la finalización del archivo, cuando los fragmentos del archivo se unen.

Compatibilidad con Ingesta

¿Cuáles son los formatos de ingesta compatibles?

Actualmente, tanto Parquet como JSON son compatibles. El CSV se admite en base a elementos heredados. Aunque los datos se promocionarán para realizar comprobaciones maestras y preliminares, no se admitirán funciones modernas, como conversión, partición o validación de filas.

¿Dónde se debe especificar el formato de entrada por lotes?

El formato de entrada debe especificarse en el momento de creación del lote dentro de la carga útil. A continuación se muestra un ejemplo de cómo especificar el formato de entrada por lotes:

curl -X POST "https://platform.adobe.io/data/foundation/import/batches" \
  -H "accept: application/json" \
  -H "x-gw-ims-org-id: {IMS_ORG}" \
  -H "Authorization: Bearer {ACCESS_TOKEN}" \
  -H "x-api-key : {API_KEY}"
  -d '{
          "datasetId": "{DATASET_ID}",
           "inputFormat": {
                "format": "json"
           }
    }'

¿Por qué los datos cargados no aparecen en el conjunto de datos?

Para que los datos aparezcan en el conjunto de datos, el lote debe marcarse como completado. Todos los archivos que desee introducir deben cargarse antes de marcar el lote como completo. A continuación se muestra un ejemplo de marca de un lote como completo:

curl -X POST "https://platform.adobe.io/data/foundation/import/batches/{BATCH_ID}?action=COMPLETE" \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-api-key : {API_KEY}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'

¿Cómo se incorpora JSON multilínea?

Para ingerir JSON multilínea, el indicador isMultiLineJson debe configurarse en el momento de la creación del lote. A continuación se puede ver un ejemplo de esto:

curl -X POST "https://platform.adobe.io/data/foundation/import/batches" \
  -H "accept: application/json" \
  -H "x-gw-ims-org-id: {IMS_ORG}" \
  -H "Authorization: Bearer {ACCESS_TOKEN}" \
  -H "x-api-key : {API_KEY}"
  -d '{
          "datasetId": "{DATASET_ID}",
           "inputFormat": {
                "format": "json",
                "isMultiLineJson": true
           }
      }'

¿Cuál es la diferencia entre las líneas JSON (JSON de una sola línea) y JSON de varias líneas?

Para las líneas JSON, hay un objeto JSON por línea. Por ejemplo:

{"string":"string1","int":1,"array":[1,2,3],"dict": {"key": "value1"}}
{"string":"string2","int":2,"array":[2,4,6],"dict": {"key": "value2"}}
{"string":"string3","int":3,"array":[3,6,9],"dict": {"key": "value3", "extra_key": "extra_value3"}}

Para el JSON multilínea, un objeto puede ocupar varias líneas, mientras que todos los objetos están ajustados en una matriz JSON. Por ejemplo:

[
    {"string":"string1","int":1,"array":[1,2,3],"dict": {"key": "value1"}},
    {"string":"string2","int":2,"array":[2,4,6],"dict": {"key": "value2"}},
    {
        "string": "string3",
        "int": 3,
        "array": [
            3,
            6,
            9
        ],
        "dict": {
            "key": "value3",
            "extra_key": "extra_value3"
        }
    }
]

De forma predeterminada, Batch Data Ingestion utiliza JSON de una sola línea.

¿Se admite la ingesta de CSV?

La ingesta de CSV solo es compatible con esquemas planos. Actualmente, no se admite la ingesta de datos jerárquicos en CSV.

Para obtener todas las funciones de ingesta de datos, es necesario utilizar los formatos JSON o Parquet.

¿Qué tipos de validación se realizan en los datos?

Existen tres niveles de validación realizados en los datos:

• Schema - Batch Ingestion garantiza que el esquema del de los datos introducidos coincida con el esquema del conjunto de datos.
• Tipo de datos: la ingesta por lotes garantiza que el tipo de cada campo ingerido coincida con el tipo definido en el esquema del conjunto de datos.
• Restricciones - La Ingesta de lotes garantiza que las restricciones, como "Requerido", "enumeración" y "formato", se definan correctamente en la definición del esquema.

¿Cómo se puede reemplazar un lote ingerido?

Un lote ya ingerido se puede reemplazar mediante la función Reproducción por lotes. Puede encontrar más información sobre la reproducción por lotes aquí.

¿Cómo se controla la ingestión por lotes?

Una vez que se ha señalado un lote para la promoción por lotes, el progreso de la ingesta por lotes puede monitorizarse con la siguiente solicitud:

curl -X GET "https://platform.adobe.io/data/foundation/catalog/batches/{BATCH_ID}" \
  -H "x-gw-ims-org-id: {IMS_ORG}" \
  -H "Authorization: Bearer {ACCESS_TOKEN}" \
  -H "x-api-key : {API_KEY}"

Con esta solicitud, obtendrá una respuesta similar a esta:

200 OK

{
    "{BATCH_ID}":{
        "imsOrg":"{IMS_ORG}",
        "created":1494349962314,
        "createdClient":"{API_KEY}",
        "createdUser":"{USER_ID}",
        "updatedUser":"{USER_ID}",
        "completed":1494349963467,
        "externalId":"{EXTERNAL_ID}",
        "status":"staging",
        "errors":[],
    }
}

Estados de lotes

¿Cuáles son los posibles estados de lote?

Un lote puede, en su ciclo vital, pasar por los siguientes estados:

¿Qué significa "Ensayo" para los lotes?

Cuando un lote se encuentra en "Ensayo", significa que el lote se ha señalado correctamente para su promoción y que los datos se están montando para su consumo descendente.

¿Qué significa cuando un lote está "reintentando"?

Cuando un lote se está "reintentando", significa que la ingesta de datos del lote se ha detenido temporalmente debido a problemas intermitentes. Cuando esto sucede, no requiere la intervención del cliente.

¿Qué significa cuando un lote está "Paralizado"?

Cuando un lote está en "Paralizado", significa que Data Ingestion Services está experimentando dificultades para ingerir el lote y todos los reintentos se han agotado.

¿Qué significa si un lote sigue siendo "Cargando"?

Cuando un lote se encuentra en "Carga", significa que no se ha llamado a la API CompleteBatch para promocionar el lote.

¿Existe alguna forma de saber si un lote se ha introducido correctamente?

Una vez que el estado del lote es "Activo", el lote se ha introducido correctamente. Para averiguar el estado del lote, siga los pasos detallados previous.

¿Qué sucede después de que falla un lote?

Cuando falla un lote, el motivo del error se puede identificar en la sección errors de la carga útil. A continuación se pueden ver ejemplos de errores:

    "errors":[
        {
            "code":"106",
            "description":"Dataset file is empty. Please upload file with data.",
            "rows":[]
        },
        {
            "code":"118",
            "description":"CSV file contains empty header row.",
            "rows":[]
        }
    ]

Una vez corregidos los errores, se puede volver a cargar el lote.

Compatibilidad con lotes

¿Cómo se deben eliminar los lotes?

En lugar de eliminar directamente de Catalog, los lotes deben eliminarse utilizando cualquiera de los métodos que se indican a continuación:

1. Si el lote está en curso, se debe anular el lote.
2. Si el lote se administra correctamente, el lote debe revertirse.

¿Qué métricas a nivel de lote están disponibles?

Las siguientes métricas a nivel de lote están disponibles para lotes en el estado Activo/Correcto:

¿Por qué las métricas no están disponibles en algunos lotes?

Existen dos razones por las que las métricas pueden no estar disponibles en el lote:

1. El lote nunca llegó correctamente al estado Activo/Correcto.
2. El lote se promocionó mediante una ruta de promoción heredada, como la ingesta de CSV.

¿Qué significan los diferentes códigos de estado?