Eliminar

Use la API de eliminación para borrar filas que cumplan una condición o una tabla completa. La eliminación es irreversible.

BORRAR https://api.telemetry.sh/delete

Encabezados

Reglas de alcance:

• DELETE /delete requiere write o read-and-write

Cuerpo

Si se omite where, Telemetry trata la solicitud como una eliminación de toda la tabla.

Respuestas de éxito

Las respuestas de eliminación son reconocimientos de limpieza asincrónicos. El API devuelve 200 OK tan pronto como el paso de eliminación, reescritura o desactivación de tabla se haya programado correctamente.

Eliminar filas coincidentes

{
  "status": "success",
  "message": "Delete rewrite completed; part cleanup is asynchronous"
}

Eliminar una tabla completa

{
  "status": "success",
  "message": "Table disabled; part cleanup is asynchronous"
}

Ejemplo de uso con cURL

Para eliminar todas las filas con más de 3 días de la tabla denominada uber_rides usando cURL, puede usar el siguiente comando:

API_KEY="YOUR_API_KEY"
WHERE_CONDITION="timestamp <= (now() - INTERVAL '3 day')"

curl -X DELETE https://api.telemetry.sh/delete \
  -H "Content-Type: application/json" \
  -H "Authorization: $API_KEY" \
  -d @- <<EOF
{
  "table": "uber_rides",
  "where": "$WHERE_CONDITION"
}
EOF

Si desea eliminar toda la tabla uber_rides, simplemente omita el campo where:

API_KEY="YOUR_API_KEY"

curl -X DELETE https://api.telemetry.sh/delete \
  -H "Content-Type: application/json" \
  -H "Authorization: $API_KEY" \
  -d '{
    "table": "uber_rides"
  }'

Notas importantes

• Eliminación de datos: Tenga cuidado al utilizar el punto final de eliminación. Si no se proporciona la condición where, se eliminará toda la tabla.
• Irreversibilidad: Una vez que se eliminan los datos, no se pueden recuperar.
• Punto final heredado: Prefiera las tablas API para operaciones del ciclo de vida de toda la tabla cuando sea posible. DELETE /delete sigue siendo útil para eliminaciones a nivel de fila con una cláusula where.

Errores comunes

• 400 Bad Request si el cuerpo JSON no es válido
• 400 Bad Request si el nombre de la tabla contiene caracteres no válidos después de la normalización
• 403 Forbidden si la clave API solo tiene alcance read
• 401 Unauthorized si la clave API falta o no es válida
• 404 Not Found si intenta eliminar filas de una tabla que aún no tiene esquema
• 500 Internal Server Error si Telemetry no puede ejecutar la solicitud de eliminación