REDACT_ REVISION gespeicherte Prozedur in Amazon QLDB - Amazon Quantum Ledger-Datenbank (AmazonQLDB)
Überlegungen und Einschränkungen bei der BearbeitungSyntaxArgumenteRückgabewertBeispiele

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

REDACT_ REVISION gespeicherte Prozedur in Amazon QLDB

Wichtig

Hinweis zum Ende des Supports: Bestandskunden können Amazon QLDB bis zum Ende des Supports am 31.07.2025 nutzen. Weitere Informationen finden Sie unter Migrieren eines Amazon QLDB Ledgers zu Amazon Aurora SQL Postgre.

Anmerkung

Alle Ledger, die vor dem 22. Juli 2021 erstellt wurden, können derzeit nicht bearbeitet werden. Sie können die Erstellungszeit Ihres Ledgers auf der QLDB Amazon-Konsole einsehen.

Verwenden Sie in Amazon die REDACT_REVISION gespeicherte ProzedurQLDB, um eine einzelne, inaktive Dokumentversion sowohl im Indexspeicher als auch im Journalspeicher dauerhaft zu löschen. Diese gespeicherte Prozedur löscht alle Benutzerdaten in der angegebenen Version. Die Journalsequenz und die Metadaten des Dokuments, einschließlich Dokument-ID und Hash, bleiben jedoch unverändert. Dieser Vorgang ist irreversibel.

Bei der angegebenen Dokumentrevision muss es sich um eine inaktive Revision in der Historie handeln. Die letzte aktive Version eines Dokuments kann nicht geschwärzt werden.

Nachdem Sie durch Ausführen dieser gespeicherten Prozedur eine Schwärzungsanforderung eingereicht haben, QLDB verarbeitet die Schwärzung der Daten asynchron. Nach Abschluss einer Schwärzung werden die Benutzerdaten der angegebenen Version (dargestellt durch die data Struktur) durch ein neues Feld ersetzt. dataHash Der Wert dieses Feldes ist der Amazon Ion-Hash der entfernten data Struktur. Dadurch behält das Hauptbuch seine allgemeine Datenintegrität bei und bleibt im Rahmen der bestehenden Verifizierungsvorgänge kryptografisch überprüfbar. API

Ein Beispiel für einen Schwärzungsvorgang mit Beispieldaten finden Sie unter. Beispiel für redaktionelle Bearbeitung Revisionen von Dokumenten redigieren

Anmerkung

Informationen zur Steuerung des Zugriffs zur Ausführung dieses PartiQL-Befehls für bestimmte Tabellen finden Sie unterErste Schritte mit dem Standardberechtigungsmodus in Amazon QLDB.

Überlegungen und Einschränkungen bei der Bearbeitung

Bevor Sie mit der Datenredaktion in Amazon beginnenQLDB, sollten Sie sich mit den folgenden Überlegungen und Einschränkungen vertraut machen:

  • Die REDACT_REVISION gespeicherte Prozedur zielt auf Ihre Benutzerdaten in einer einzelnen, inaktiven Dokumentenrevision ab. Um mehrere Versionen zu redigieren, müssen Sie die gespeicherte Prozedur für jede Revision einmal ausführen. Sie können eine Revision pro Transaktion redigieren.

  • Um bestimmte Felder innerhalb einer Dokumentrevision zu schwärzen, müssen Sie zunächst eine separate Anweisung zur Datenmanipulationssprache (DML) verwenden, um die Revision zu ändern. Weitere Informationen finden Sie unter Ein bestimmtes Feld innerhalb einer Revision redigieren.

  • Nachdem Sie QLDB eine Schwärzungsanfrage erhalten haben, können Sie die Anfrage nicht mehr stornieren oder ändern. Um zu überprüfen, ob eine Bearbeitung abgeschlossen ist, können Sie überprüfen, ob die data Struktur einer Revision durch ein dataHash Feld ersetzt wurde. Weitere Informationen hierzu finden Sie unter Es wird geprüft, ob eine Schwärzung abgeschlossen ist.

  • Die Schwärzung hat keine Auswirkungen auf QLDB Daten, die außerhalb des Dienstes repliziert werden. QLDB Dazu gehören alle Exporte nach Amazon S3 und Streams zu Amazon Kinesis Data Streams. Sie müssen andere Datenaufbewahrungsmethoden verwenden, um alle außerhalb von QLDB gespeicherten Daten zu verwalten.

  • Die Schwärzung hat keinen Einfluss auf Literalwerte in PartiQL-Anweisungen, die im Journal aufgezeichnet werden. Es hat sich bewährt, parametrisierte Anweisungen programmgesteuert auszuführen, indem Sie Platzhalter für Variablen anstelle von Literalwerten verwenden. Ein Platzhalter wird in das Journal als Fragezeichen (?) geschrieben und nicht als vertrauliche Informationen, die möglicherweise geschwärzt werden müssen.

    Informationen zum programmgesteuerten Ausführen von PartiQL-Anweisungen mithilfe des QLDB Treibers finden Sie in den Tutorials für jede unterstützte Programmiersprache unter. Erste Schritte mit dem Treiber

Syntax

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

Argumente

`block-address`

Der Journalblock-Speicherort der Dokumentrevision, die redigiert werden soll. Eine Adresse ist eine Amazon Ion-Struktur mit zwei Feldern: strandId undsequenceNo.

Dies ist ein Ion-Literalwert, der durch Backticks gekennzeichnet wird. Beispielsweise:

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

Informationen zum Ermitteln der Blockadresse finden Sie unter. Metadaten von Dokumenten werden abgefragt

'table-id'

Die eindeutige ID der Tabelle, deren Dokumentversion Sie redigieren möchten, gekennzeichnet durch einfache Anführungszeichen.

Informationen zum Ermitteln der Tabellen-ID finden Sie unter. Der Systemkatalog wird abgefragt

'document-id'

Die eindeutige Dokument-ID der zu redigierenden Version, gekennzeichnet durch einfache Anführungszeichen.

Informationen zum Ermitteln der Dokument-ID finden Sie unter. Metadaten von Dokumenten werden abgefragt

Rückgabewert

Eine Amazon Ion-Struktur, die die zu redigierende Dokumentrevision im folgenden Format darstellt.

{
  blockAddress: {
    strandId: String,
    sequenceNo: Int
  },
  tableId: String,
  documentId: String,
  version: Int
}
Strukturfelder zurückgeben

  • blockAddress— Der Speicherort der zu redigierenden Revision im Journalblock. Eine Adresse hat die folgenden zwei Felder.

    • strandId— Die eindeutige ID des Journalstrangs, der den Block enthält.

    • sequenceNo— Eine Indexnummer, die die Position des Blocks innerhalb des Strangs angibt.

  • tableId— Die eindeutige ID der Tabelle, deren Version Sie redigieren.

  • documentId— Die eindeutige Dokument-ID der Revision, die redigiert werden soll.

  • version— Die Versionsnummer der Dokumentrevision, die redigiert werden soll.

Das Folgende ist ein Beispiel für die Rückgabestruktur mit Beispieldaten.

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

Beispiele

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