Procedimiento almacenado REDACT_REVISION en Amazon QLDB - Amazon Quantum Ledger Database (Amazon QLDB)

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Procedimiento almacenado REDACT_REVISION en Amazon QLDB

nota

Cualquier libro mayor que se haya creado antes del 22 de julio de 2021 actualmente no es apto para la edición. Puede ver la hora de creación de su libro mayor en la consola de Amazon QLDB.

En Amazon QLDB, utilice el procedimiento almacenado REDACT_REVISION para eliminar permanentemente una revisión de documento individual e inactiva tanto en el almacenamiento indexado como en el almacenamiento del diario. Este procedimiento almacenado elimina todos los datos de usuario de la revisión especificada. Sin embargo, no modifica la secuencia del diario y los metadatos del documento, incluidos el identificador del documento y el hash. La operación es irreversible.

La revisión del documento especificada debe ser una revisión inactiva en el historial. La última revisión activa de un documento no es apta para ser editada.

Cuando envía una solicitud de edición ejecutando el procedimiento almacenado, la QLDB procesa la edición de los datos de forma asíncrona. Una vez finalizada la edición, los datos de usuario de la revisión especificada (representados por la estructura data) se sustituyen por un nuevo campo dataHash. El valor de este campo es el hash de Amazon Ion de la estructura data eliminada. Como resultado, el libro mayor mantiene la integridad general de sus datos y sigue siendo verificable criptográficamente mediante las operaciones de la API de verificación existentes.

Para ver un ejemplo de una operación de edición con datos de muestra, consulte Ejemplo de edición en Editar revisiones de documentos.

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.

Condiciones y limitaciones de edición

Antes de empezar con la edición de datos en Amazon QLDB, asegúrese de revisar las siguientes consideraciones y limitaciones:

  • El procedimiento almacenado REDACT_REVISION se centra en los datos de usuario en una revisión de documento individual e inactiva. Para editar varias revisiones, debe ejecutar el procedimiento almacenado una vez para cada revisión. Puede editar una revisión por transacción.

  • Para editar campos concretos de una revisión de un documento, primero debe utilizar una instrucción de lenguaje de manipulación de datos (DML) independiente para modificar la revisión. Para obtener más información, consulte Editar un campo concreto de una revisión.

  • Una vez que QLDB reciba una solicitud de edición, no podrá cancelarla ni modificarla. Para confirmar si una edición está completa, puede comprobar si la estructura data de la revisión se ha sustituido por un campo dataHash. Para obtener más información, consulte Comprobar si una edición está completa.

  • La edición no afecta a ningún dato de QLDB que se replique fuera del servicio de QLDB. Esto incluye cualquier exportación a Amazon S3 y las transmisiones a Amazon Kinesis Data Streams. Debe utilizar otros métodos de retención de datos para gestionar los datos almacenados fuera de la QLDB.

  • La edición no afecta a los valores literales de las instrucciones PartiQL que se registran en el diario. Como práctica recomendada, se deben ejecutar instrucciones parametrizadas mediante programación utilizando marcadores de posición de variables en lugar de valores literales. Los marcadores de posición se escriben en el diario como un signo de interrogación (?) y no como información confidencial que pueda requerir edición.

    Para aprender a ejecutar instrucciones PartiQL mediante programación con el controlador QLDB, consulte los tutoriales de cada lenguaje de programación compatible en Introducción al controlador.

Sintaxis

EXEC REDACT_REVISION `block-address`, 'table-id', 'document-id'

Argumentos

`block-address`

La ubicación en el bloque del diario de la revisión del documento que se va a editar. La dirección es una estructura de Amazon Ion que consta de dos campos: strandId y sequenceNo.

Se trata de un valor literal de Ion que se indica con acentos graves. Por ejemplo:

`{strandId:"JdxjkR9bSYB5jMHWcI464T", sequenceNo:17}`

Para obtener información sobre cómo encontrar la dirección del bloque, consulte Consulta de los metadatos del documento.

'table-id'

El identificador único de la tabla cuya revisión del documento desea editar, indicado entre comillas simples.

Para obtener información sobre cómo encontrar el identificador de la tabla, consulte Consulta del catálogo del sistema.

'document-id'

El identificador único del documento cuya revisión desea editar, indicado entre comillas simples.

Para obtener información sobre cómo encontrar el identificador del documento, consulte Consulta de los metadatos del documento.

Valor devuelto

Una estructura de Amazon Ion que representa la revisión del documento que se va a editar, en el siguiente formato.

{ blockAddress: { strandId: String, sequenceNo: Int }, tableId: String, documentId: String, version: Int }
Devolver los campos de estructura
  • blockAddress: la ubicación en el bloque del diario de la revisión que se va a editar. Una dirección tiene los dos campos siguientes:

    • strandId: el identificador único de la cadena del diario que contiene el bloque.

    • sequenceNo: un número de índice que especifica la ubicación del bloque dentro de la cadena.

  • tableId: el identificador único de la tabla cuya revisión está editando.

  • documentId: el identificador único del documento de la revisión que se va a editar.

  • version: el número de versión del documento de la revisión que se va a editar.

A continuación se muestra un ejemplo de estructura de retorno con datos de ejemplo.

{ blockAddress: { strandId: "CsRnx0RDoNK6ANEEePa1ov", sequenceNo: 134 }, tableId: "6GZumdHggklLdMGyQq9DNX", documentId: "IXlQPSbfyKMIIsygePeKrZ", version: 0 }

Ejemplos

EXEC REDACT_REVISION `{strandId:"7z2P0AyQKWD8oFYmGNhi8D", sequenceNo:7}`, '8F0TPCmdNQ6JTRpiLj2TmW', '05K8zpGYWynDlEOK5afDRc'