Comando DELETE en Amazon QLDB

En Amazon QLDB, utilice el comando DELETE para marcar un documento activo como eliminado en una tabla mediante la creación de una revisión nueva, pero definitiva del documento. Esta última revisión indica que el documento se ha eliminado. Esta operación finaliza el ciclo de vida de un documento, lo que significa que no se pueden crear más revisiones del documento con el mismo identificador de documento.

La operación es irreversible. Aún puede consultar el historial de revisiones de un documento eliminado utilizando Función de historial.

nota

Para obtener información sobre cómo controlar el acceso para ejecutar este comando PartiQL en tablas específicas, consulte Introducción al modo de permisos estándar en Amazon QLDB.

Sintaxis

DELETE FROM table_name [ AS table_alias ] [ BY id_alias ]
[ WHERE condition ]

Parámetros

table_name

Nombre de la tabla de usuario que contiene los datos que se van a eliminar. Las instrucciones de DML solo se admiten en la vista de usuario predeterminada. Cada instrucción solo puede ejecutarse en una sola tabla.

AS table_alias

(Opcional) Un alias definido por el usuario que se extiende a lo largo de una tabla de la que se va a eliminar. La palabra clave AS es opcional.

BY id_alias

(Opcional) Un alias definido por el usuario que se enlaza con el campo id de metadatos de cada documento del conjunto de resultados. El alias debe declararse en la cláusula FROM mediante la palabra clave BY. Esto resulta útil cuando se desea filtrar por identificador del documento al consultar la vista de usuario predeterminada. Para obtener más información, consulte Uso de la cláusula BY para consultar el identificador del documento.

WHERE condition

Criterios de selección para los documentos que se van a eliminar.

nota

Si omite la cláusula WHERE, se eliminarán todos los elementos de la tabla.

Valor devuelto

documentId: el identificador único de cada documento que ha eliminado.

Ejemplos

DELETE FROM VehicleRegistration AS r
WHERE r.VIN = '1HVBBAANXWH544237'

Ejecución mediante programación con el controlador

Para aprender a ejecutar esta instrucción mediante programación con el controlador de QLDB, consulte los siguientes tutoriales en Introducción al controlador:

• Java: Tutorial de inicio rápido | Referencia de libro de recetas

• .NET: Tutorial de inicio rápido | Referencia de libro de recetas

• Go: Tutorial de inicio rápido | Referencia de libro de recetas

• Node.js: Tutorial de inicio rápido | Referencia de libro de recetas

• Python: Tutorial de inicio rápido | Referencia de libro de recetas