Consultar el estado de la adición de datos a la tabla

Esta API se utiliza para consultar el estado de procesamiento de las tareas de adición de datos a la tabla.

Método de la solicitud

GET

Endpoint

https://api-${endpoint}.gptbots.ai/v1/database/query/import-results

Autenticación

Para obtener más información, consulte la descripción del método de autenticación en Visión general de la API.

Solicitud

Ejemplo de solicitud

curl -X GET 'https://api-${endpoint}.gptbots.ai/v1/database/query/import-results?ids=68ec7ad3e307920f002648cd' \ -H 'Authorization: Bearer ${API Key}'

                      
                      curl -X GET 'https://api-${endpoint}.gptbots.ai/v1/database/query/import-results?ids=68ec7ad3e307920f002648cd' \
-H 'Authorization: Bearer ${API Key}'

Este bloque de código en una ventana flotante

Cabeceras de la solicitud

Campo	Tipo	Descripción
Authorization	Bearer ${API Key}	Se usa `Authorization: Bearer ${API Key}` para la autenticación. La clave de API se obtiene en la página «API Key».

Parámetros de consulta

Campo	Tipo	Obligatorio	Descripción
ids	list	Sí	Conjunto de ID de tareas de adición de datos.

Respuesta

Ejemplo de respuesta

[ { "id": "68ec7ad3e307920f002648cd", "progress": 1, "status": "FAIL", "total_count": 4, "success_count": 0, "fail_count": 4, "fail_detail": [ { "row": null, "row_number_start": 1, "row_number_end": 2, "fail_reason": "(1062, \"Duplicate entry '14' for key 'product_feed_090833.id'\")" }, { "row": 2, "row_number_start": 0, "row_number_end": 0, "fail_reason": "`id` must be unique, but the value '14' is duplicated (first at row `1`)." }, { "row": 4, "row_number_start": 0, "row_number_end": 0, "fail_reason": "`no` is required and must have a value; the current value is invalid or the property is missing. `no` must be unique, but the value is empty or the property is missing." } ] } ]

                      
                      [
    {
        "id": "68ec7ad3e307920f002648cd",
        "progress": 1,
        "status": "FAIL",
        "total_count": 4,
        "success_count": 0,
        "fail_count": 4,
        "fail_detail": [
            {
                "row": null,
                "row_number_start": 1,
                "row_number_end": 2,
                "fail_reason": "(1062, \"Duplicate entry '14' for key 'product_feed_090833.id'\")"
            },
            {
                "row": 2,
                "row_number_start": 0,
                "row_number_end": 0,
                "fail_reason": "`id` must be unique, but the value '14' is duplicated (first at row `1`)."
            },
            {
                "row": 4,
                "row_number_start": 0,
                "row_number_end": 0,
                "fail_reason": "`no` is required and must have a value; the current value is invalid or the property is missing. `no` must be unique, but the value is empty or the property is missing."
            }
        ]
    }
]

Este bloque de código en una ventana flotante

Respuesta correcta

Campo	Tipo	Descripción
id	string	ID único de la tarea.
progress	int	Porcentaje de progreso de la tarea, de 1 a 100.
status	string	Estado de la tarea. `"FAIL"` indica error, `"PENDING_PARSE"` indica que el archivo se está analizando y `"AVAILABLE"` indica que al menos un registro se añadió correctamente.
total_count	int	Número total de elementos procesados.
success_count	int	Número de elementos procesados correctamente.
fail_count	int	Número de elementos fallidos.
fail_detail	Array<Object>	Posiciones y motivos de los fallos de adición.
row	int	Indica el número de fila en el que se produjo el error. Si es `null`, el error no se puede asignar a una fila específica.
row_number_start	int	Indica el inicio del rango de error (en bloques de diez filas).
row_number_end	int	Indica el final del rango de error (en bloques de diez filas).
fail_reason	string	Descripción del motivo del error.

Respuesta de error

Campo	Tipo	Descripción
code	int	Código de error.
message	string	Detalles del error.

Códigos de error

Código	Mensaje
50000	Error interno del sistema

Cómo interpretar la respuesta?

Caso de error 1: Si los datos importados entran en conflicto con datos ya existentes en la tabla de datos, no se importará ninguno de los datos.
- "fail_count" será igual a "total_count".
- "row" será null.
- En este caso, revise "fail_reason" para localizar el problema.
- "row_number_start" y "row_number_end" pueden no coincidir con los números de fila reales, por lo que pueden ignorarse.
Caso de error 2: Si existe un conflicto dentro de los datos importados, el primer registro conflictivo se importará y el segundo se descartará.
- "row" mostrará el número de fila del segundo registro conflictivo.
- "row_number_start" y "row_number_end" serán 0.
Otros errores: Si los datos importados no cumplen el formato o las reglas requeridos, ese registro no se importará.
- "row" mostrará el número de fila del registro no válido.
- "row_number_start" y "row_number_end" serán 0.