Retención y eliminación de datos
La retención es parte de un contrato de evento. Decida cuánto tiempo sigue siendo útil una tabla, qué identificadores contiene y si los compromisos legales o del cliente requieren un ciclo de vida más corto antes de enviar datos de producción.
Establecer retención por tabla
Las tablas con diferentes propósitos no deben heredar una política accidental. Los eventos operativos de gran volumen pueden necesitar un período más corto que los hitos de facturación o los registros de auditoría de bajo volumen.
Utilice las tablas API para establecer o borrar un período de retención:
curl -X PATCH https://api.telemetry.sh/tables/api_requests/retention \
-H "Authorization: Bearer $TELEMETRY_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "retention_days": 30 }'
El Referencia de tablas API documenta el contrato de solicitud y respuesta actual.
Eliminar filas o una tabla
La eliminación selectiva reescribe los datos almacenados afectados de forma asincrónica. La eliminación de toda la tabla elimina el uso normal de la tabla mientras continúa la limpieza. Dado que la eliminación es destructiva, primero resuelva la tabla exacta y el predicado con una consulta de solo lectura.
SELECT COUNT(*) AS rows_to_delete
FROM product_events
WHERE account_id = 'account_123';
Luego utilice el punto final de eliminación admitido que se describe en Eliminar referencia API. Mantenga la tabla de destino, el predicado, el solicitante, la aprobación y la evidencia de finalización en el sistema responsable de la solicitud de eliminación. No copie el contenido de la fila privada en ese registro.
Diseño para la eliminabilidad
Utilice identificadores de usuario y de cuenta opacos estables cuando una tabla deba admitir la eliminación a nivel de asunto. El texto de formato libre y los identificadores inconsistentes dificultan la búsqueda segura de cada fila aplicable.
En primer lugar, evite enviar secretos, datos de pago, cuerpos de solicitud o mensajes sin formato. La eliminación no sustituye a la minimización de datos.
Verificar el ciclo de vida
Después de cambiar la retención, obtenga los metadatos de la tabla y confirme la política almacenada. Después de la eliminación, consulte el predicado exacto hasta que se complete la operación. Valide paneles y consultas guardadas que esperaban el historial eliminado.
Revise la retención cuando se introduzca un nuevo identificador, fuente de evento, región o compromiso del cliente. Continúe con redactar datos confidenciales y columnas de partición.