REDACT_ procedura REVISION memorizzata in Amazon QLDB

Importante

Avviso di fine del supporto: i clienti esistenti potranno utilizzare Amazon QLDB fino alla fine del supporto il 31/07/2025. Per ulteriori dettagli, consulta Migrare un Amazon QLDB Ledger ad Amazon Aurora Postgre. SQL

Nota

I registri creati prima del 22 luglio 2021 non sono attualmente idonei alla redazione. Puoi visualizzare l'ora di creazione del tuo libro mastro sulla QLDB console Amazon.

In AmazonQLDB, utilizza la procedura REDACT_REVISION memorizzata per eliminare definitivamente una singola revisione inattiva di un documento sia nell'archiviazione indicizzata che nell'archiviazione del diario. Questa procedura memorizzata elimina tutti i dati utente nella revisione specificata. Tuttavia, lascia invariati la sequenza del diario e i metadati del documento, inclusi l'ID e l'hash del documento. Questa operazione è irreversibile.

La revisione del documento specificata deve essere una revisione inattiva nella cronologia. L'ultima revisione attiva di un documento non è idonea per la redazione.

Dopo aver inviato una richiesta di redazione eseguendo questa procedura memorizzata, QLDB elabora la redazione dei dati in modo asincrono. Una volta completata la redazione, i dati utente della revisione specificata (rappresentata dalla data struttura) vengono sostituiti da un nuovo campo. dataHash Il valore di questo campo è l'hash Amazon Ion della data struttura rimossa. Di conseguenza, il registro mantiene l'integrità complessiva dei dati e rimane verificabile crittograficamente attraverso le operazioni di verifica esistenti. API

Per un esempio di operazione di redazione con dati di esempio, vedere in. Esempio di redazione Redazione delle revisioni dei documenti

Nota

Per informazioni su come controllare l'accesso per eseguire questo comando PartiQL su tabelle specifiche, vedere. Guida introduttiva alla modalità di autorizzazione standard in Amazon QLDB

Considerazioni e limitazioni sulla redazione

Prima di iniziare con la redazione dei dati in AmazonQLDB, assicurati di leggere le seguenti considerazioni e limitazioni:

• La procedura REDACT_REVISION memorizzata riguarda i dati utente in una singola revisione inattiva del documento. Per redigere più revisioni, è necessario eseguire la stored procedure una volta per ogni revisione. È possibile redigere una revisione per transazione.

• Per oscurare determinati campi all'interno di una revisione del documento, è necessario utilizzare un'istruzione separata del linguaggio di manipolazione dei dati (DML) per modificare prima la revisione. Per ulteriori informazioni, consulta Oscurare un particolare campo all'interno di una revisione.

• Dopo aver QLDB ricevuto una richiesta di redazione, non è possibile annullare o modificare la richiesta. Per confermare se una redazione è completa, puoi verificare se la data struttura di una revisione è stata sostituita da un campo. dataHash Per ulteriori informazioni, consulta Verifica se una redazione è completa.

• La redazione non ha alcun impatto sui QLDB dati replicati all'esterno del servizio. QLDB Ciò include tutte le esportazioni verso Amazon S3 e gli stream verso Amazon Kinesis Data Streams. È necessario utilizzare altri metodi di conservazione dei dati per gestire i dati archiviati all'esterno di. QLDB

• La redazione non ha alcun impatto sui valori letterali nelle istruzioni PartiQl registrate nel journal. È consigliabile eseguire istruzioni con parametri a livello di codice utilizzando segnaposto variabili anziché valori letterali. Un segnaposto viene scritto nel diario come punto interrogativo (?) invece di qualsiasi informazione sensibile che potrebbe richiedere una redazione.

  Per informazioni su come eseguire a livello di codice istruzioni PartiQL utilizzando il QLDB driver, consulta i tutorial per ogni linguaggio di programmazione supportato in. Guida introduttiva al driver

Sintassi

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

Argomenti

`block-address`

La posizione nel blocco journal della revisione del documento da redigere. Un indirizzo è una struttura Amazon Ion con due campi: strandId esequenceNo.

Si tratta di un valore letterale Ion indicato da backtick. Per esempio:

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

Per informazioni su come trovare l'indirizzo del blocco, consulta. Interrogazione dei metadati dei documenti

'table-id'

L'ID univoco della tabella di cui desideri redigere la revisione del documento, indicato da virgolette singole.

Per informazioni su come trovare l'ID della tabella, consulta. Interrogazione del catalogo di sistema

'document-id'

L'ID univoco del documento della revisione da oscurare, indicato da virgolette singole.

Per informazioni su come trovare l'ID del documento, consulta. Interrogazione dei metadati dei documenti

Valore restituito

Una struttura Amazon Ion che rappresenta la revisione del documento da redigere, nel seguente formato.

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

Restituisci campi della struttura

• blockAddress— La posizione nel blocco del journal della revisione da redigere. Un indirizzo ha i due campi seguenti.

  • strandId— L'ID univoco del filone di giornale che contiene il blocco.

  • sequenceNo— Un numero indice che specifica la posizione del blocco all'interno del trefolo.

• tableId— L'ID univoco della tabella di cui state oscurando la revisione.

• documentId— L'ID univoco del documento della revisione da oscurare.

• version— Il numero di versione della revisione del documento da redigere.

Di seguito è riportato un esempio della struttura restituita con dati di esempio.

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

Esempi

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