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.
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 campodataHash
. 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
ysequenceNo
.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'