REDACT_ prosedur REVISION tersimpan di Amazon QLDB - Database Buku Besar Amazon Quantum (AmazonQLDB)
Pertimbangan dan batasan redaksiSintaksPendapatNilai yang dikembalikanContoh

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

REDACT_ prosedur REVISION tersimpan di Amazon QLDB

penting

Pemberitahuan akhir dukungan: Pelanggan yang ada akan dapat menggunakan Amazon QLDB hingga akhir dukungan pada 07/31/2025. Untuk detail selengkapnya, lihat Memigrasi QLDB Buku Besar Amazon ke Amazon Aurora Postgre. SQL

catatan

Buku besar apa pun yang dibuat sebelum 22 Juli 2021 saat ini tidak memenuhi syarat untuk redaksi. Anda dapat melihat waktu pembuatan buku besar Anda di QLDB konsol Amazon.

Di AmazonQLDB, gunakan prosedur REDACT_REVISION tersimpan untuk menghapus secara permanen revisi dokumen individual yang tidak aktif di penyimpanan terindeks dan penyimpanan jurnal. Prosedur tersimpan ini menghapus semua data pengguna dalam revisi yang ditentukan. Namun, ia meninggalkan urutan jurnal dan metadata dokumen, termasuk ID dokumen dan hash, tidak berubah. Operasi ini tidak dapat diubah.

Revisi dokumen yang ditentukan harus merupakan revisi tidak aktif dalam sejarah. Revisi aktif terbaru dari dokumen tidak memenuhi syarat untuk redaksi.

Setelah Anda mengirimkan permintaan redaksi dengan menjalankan prosedur tersimpan ini, QLDB proses redaksi data secara asinkron. Setelah redaksi selesai, data pengguna dari revisi yang ditentukan (diwakili oleh data struktur) digantikan oleh bidang barudataHash. Nilai bidang ini adalah hash Amazon Ion dari data struktur yang dihapus. Akibatnya, buku besar mempertahankan integritas data secara keseluruhan dan tetap dapat diverifikasi secara kriptografis melalui operasi verifikasi yang ada. API

Untuk contoh operasi redaksi dengan data sampel, lihat Contoh redaksi diMenyunting revisi dokumen.

catatan

Untuk mempelajari cara mengontrol akses untuk menjalankan perintah PartiQL ini pada tabel tertentu, lihat. Memulai dengan mode izin standar di Amazon QLDB

Pertimbangan dan batasan redaksi

Sebelum Anda memulai dengan redaksi data di AmazonQLDB, pastikan Anda meninjau pertimbangan dan batasan berikut:

  • Prosedur yang REDACT_REVISION disimpan menargetkan data pengguna Anda dalam revisi dokumen individual yang tidak aktif. Untuk menyunting beberapa revisi, Anda harus menjalankan prosedur tersimpan satu kali untuk setiap revisi. Anda dapat menyunting satu revisi per transaksi.

  • Untuk menyunting bidang tertentu dalam revisi dokumen, Anda harus menggunakan pernyataan bahasa manipulasi data (DML) terpisah untuk memodifikasi revisi terlebih dahulu. Untuk informasi selengkapnya, lihat Menyunting bidang tertentu dalam revisi.

  • Setelah QLDB menerima permintaan redaksi, Anda tidak dapat membatalkan atau mengubah permintaan. Untuk mengonfirmasi apakah redaksi selesai, Anda dapat memeriksa apakah data struktur revisi telah diganti dengan dataHash bidang. Untuk mempelajari selengkapnya, lihat Memeriksa apakah redaksi selesai.

  • Redaksi tidak berdampak pada QLDB data apa pun yang direplikasi di luar layanan. QLDB Ini termasuk ekspor apa pun ke Amazon S3 dan streaming ke Amazon Kinesis Data Streams. Anda harus menggunakan metode penyimpanan data lain untuk mengelola data apa pun yang disimpan di luarQLDB.

  • Redaksi tidak berdampak pada nilai literal dalam pernyataan PartiQL yang dicatat dalam jurnal. Sebagai praktik terbaik, Anda harus menjalankan pernyataan berparameter secara terprogram dengan menggunakan placeholder variabel alih-alih nilai literal. Placeholder ditulis dalam jurnal sebagai tanda tanya (?) alih-alih informasi sensitif apa pun yang mungkin memerlukan redaksi.

    Untuk mempelajari cara menjalankan pernyataan PartiQL secara terprogram menggunakan QLDB driver, lihat tutorial untuk setiap bahasa pemrograman yang didukung di. Memulai dengan pengemudi

Sintaks

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

Pendapat

`block-address`

Lokasi blok jurnal dari revisi dokumen yang akan disunting. Alamat adalah struktur Amazon Ion yang memiliki dua bidang: strandId dansequenceNo.

Ini adalah nilai literal Ion yang dilambangkan dengan backticks. Sebagai contoh:

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

Untuk mempelajari cara menemukan alamat blokir, lihatMeminta metadata dokumen.

'table-id'

ID unik dari tabel yang revisi dokumennya ingin Anda edit, dilambangkan dengan tanda kutip tunggal.

Untuk mempelajari cara menemukan ID tabel, lihatMenanyakan katalog sistem.

'document-id'

ID dokumen unik dari revisi yang akan disunting, dilambangkan dengan tanda kutip tunggal.

Untuk mempelajari cara menemukan ID dokumen, lihatMeminta metadata dokumen.

Nilai yang dikembalikan

Struktur Amazon Ion yang mewakili revisi dokumen yang akan disunting, dalam format berikut.

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

  • blockAddress— Lokasi blok jurnal revisi yang akan disunting. Sebuah alamat memiliki dua bidang berikut.

    • strandId— ID unik untai jurnal yang berisi blok.

    • sequenceNo— Nomor indeks yang menentukan lokasi blok di dalam untai.

  • tableId— ID unik dari tabel yang revisinya Anda edit.

  • documentId— ID dokumen unik dari revisi yang akan disunting.

  • version— Nomor versi revisi dokumen yang akan disunting.

Berikut ini adalah contoh struktur pengembalian dengan data sampel.

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

Contoh

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