REDACT_ procédure REVISION stockée sur Amazon QLDB

Important

Avis de fin de support : les clients existants pourront utiliser Amazon QLDB jusqu'à la fin du support le 31 juillet 2025. Pour plus de détails, consultez Migrer un Amazon QLDB Ledger vers Amazon Aurora SQL Postgre.

Note

Les registres créés avant le 22 juillet 2021 ne sont actuellement pas éligibles à la rédaction. Vous pouvez consulter l'heure de création de votre registre sur la QLDB console Amazon.

Sur AmazonQLDB, utilisez la procédure REDACT_REVISION stockée pour supprimer définitivement une révision de document individuelle inactive à la fois dans le stockage indexé et dans le stockage des journaux. Cette procédure stockée supprime toutes les données utilisateur de la révision spécifiée. Cependant, la séquence du journal et les métadonnées du document, y compris l'identifiant et le hachage du document, restent inchangées. Cette opération est irréversible.

La révision de document spécifiée doit être une révision inactive dans l'historique. La dernière révision active d'un document n'est pas éligible à la rédaction.

Une fois que vous avez soumis une demande de suppression en exécutant cette procédure stockée, QLDB traite la rédaction des données de manière asynchrone. Une fois la rédaction terminée, les données utilisateur de la révision spécifiée (représentées par la data structure) sont remplacées par un nouveau dataHash champ. La valeur de ce champ est le hachage Amazon Ion de la data structure supprimée. Par conséquent, le registre conserve l'intégrité globale de ses données et reste vérifiable cryptographiquement grâce aux opérations de vérification existantes. API

Pour un exemple d'opération de rédaction avec des exemples de données, voir Exemple de rédaction dansRédaction de révisions de documents.

Note

Pour savoir comment contrôler l'accès afin d'exécuter cette commande partiQL sur des tables spécifiques, consultez. Commencer à utiliser le mode d'autorisation standard sur Amazon QLDB

Considérations et limites relatives à la rédaction

Avant de commencer à rédiger des données sur AmazonQLDB, assurez-vous de prendre connaissance des considérations et limites suivantes :

• La procédure REDACT_REVISION stockée cible vos données utilisateur dans le cadre d'une révision de document individuelle et inactive. Pour supprimer plusieurs révisions, vous devez exécuter la procédure stockée une fois pour chaque révision. Vous pouvez supprimer une révision par transaction.

• Pour supprimer des champs spécifiques dans une révision de document, vous devez d'abord utiliser une instruction Data Manipulation Language (DML) distincte pour modifier la révision. Pour plus d’informations, consultez Rédaction d'un champ particulier dans une révision.

• Après avoir QLDB reçu une demande de rédaction, vous ne pouvez ni annuler ni modifier la demande. Pour vérifier si une rédaction est terminée, vous pouvez vérifier si la data structure d'une révision a été remplacée par un dataHash champ. Pour en savoir plus, veuillez consulter la section Vérifier si une rédaction est complète.

• La rédaction n'a aucun impact sur QLDB les données répliquées en dehors du QLDB service. Cela inclut toutes les exportations vers Amazon S3 et les flux vers Amazon Kinesis Data Streams. Vous devez utiliser d'autres méthodes de conservation des données pour gérer les données stockées en dehors deQLDB.

• La rédaction n'a aucun impact sur les valeurs littérales des instructions partiQL enregistrées dans le journal. Il est recommandé d'exécuter des instructions paramétrées par programmation en utilisant des espaces réservés aux variables plutôt que des valeurs littérales. Un espace réservé est écrit dans le journal sous forme de point d'interrogation (?) au lieu de toute information sensible susceptible de nécessiter une rédaction.

  Pour savoir comment exécuter par programmation des instructions partiQL à l'aide du QLDB pilote, consultez les didacticiels relatifs à chaque langage de programmation pris en charge dans. Commencer à utiliser le chauffeur

Syntaxe

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

Arguments

`block-address`

Emplacement du bloc de journal de la révision du document à supprimer. Une adresse est une structure Amazon Ion qui comporte deux champs : strandId etsequenceNo.

Il s'agit d'une valeur littérale ionique qui est indiquée par des backticks. Par exemple :

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

Pour savoir comment trouver l'adresse bloquée, consultezInterrogation des métadonnées d'un document.

'table-id'

L'ID unique du tableau dont vous souhaitez supprimer la révision du document, indiqué par des guillemets simples.

Pour savoir comment trouver l'ID de la table, consultezInterrogation du catalogue du système.

'document-id'

L'ID de document unique de la révision à supprimer, indiqué par des guillemets simples.

Pour savoir comment trouver l'ID du document, voirInterrogation des métadonnées d'un document.

Valeur renvoyée

Une structure Amazon Ion qui représente la révision du document à rédiger, au format suivant.

{
  blockAddress: {
    strandId: String,
    sequenceNo: Int
  },
  tableId: String,
  documentId: String,
  version: Int
}

Champs de structure de retour

• blockAddress— L'emplacement du bloc de journal de la révision à supprimer. Une adresse comporte les deux champs suivants.

  • strandId— L'identifiant unique du volet du journal qui contient le bloc.

  • sequenceNo— Numéro d'index qui indique l'emplacement du bloc dans le fil.

• tableId— L'identifiant unique de la table dont vous êtes en train de supprimer la révision.

• documentId— L'ID de document unique de la révision à supprimer.

• version— Le numéro de version de la révision du document à supprimer.

Voici un exemple de structure de retour avec des exemples de données.

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

Exemples

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