REDACT_ procedimiento REVISION almacenado en Amazon QLDB

importante

Aviso de fin del soporte: los clientes actuales podrán utilizar Amazon QLDB hasta que finalice el soporte, el 31 de julio de 2025. Para obtener más información, consulte Migración de un Amazon QLDB Ledger a Amazon Aurora SQL Postgre.

nota

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

En AmazonQLDB, usa el procedimiento REDACT_REVISION almacenado para eliminar permanentemente una revisión individual de un documento inactivo tanto en el almacenamiento indexado como en el almacenamiento de diarios. 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.

Tras enviar una solicitud de redacción mediante este procedimiento almacenado, QLDB procesa la redacció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 verificación existentes. API

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 Cómo empezar con el modo de permisos estándar en Amazon QLDB.

Condiciones y limitaciones de edición

Antes de empezar con la redacción de datos en AmazonQLDB, asegúrate 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 redactar campos concretos de una revisión de un documento, primero debes utilizar una declaració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 redacció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 redacción no afecta a ningún QLDB dato que se replique fuera del servicio. 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. 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 sentencias PartiQL mediante programación mediante el QLDB controlador, 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'