Memperbarui dan menghapus dokumen

Di Amazon QLDB, revisi dokumen adalah struktur Amazon Ion yang mewakili satu versi dari urutan dokumen yang diidentifikasi oleh ID dokumen unik. Setiap revisi berisi kumpulan data lengkap dokumen, termasuk data pengguna dan metadata yang dihasilkan sistem Anda. Setiap revisi diidentifikasi secara unik dengan kombinasi ID dokumen dan nomor versi berbasis nol.

Ketika Anda memperbarui dokumen, QLDB membuat revisi baru dengan ID dokumen yang sama dan nomor versi bertambah. Siklus hidup dokumen berakhir saat Anda menghapusnya dari tabel. Ini berarti bahwa tidak ada revisi dokumen dengan ID dokumen yang sama dapat dibuat lagi.

Membuat revisi dokumen

Misalnya, pernyataan berikut memasukkan registrasi kendaraan baru, memperbarui kota pendaftaran, dan kemudian menghapus pendaftaran. Ini menghasilkan tiga revisi dokumen.

INSERT INTO VehicleRegistration
{
    'VIN' : '1HVBBAANXWH544237',
    'LicensePlateNumber' : 'LS477D',
    'State' : 'WA',
    'City' : 'Tacoma',
    'PendingPenaltyTicketAmount' : 42.20,
    'ValidFromDate' : `2011-10-26T`,
    'ValidToDate' : `2023-09-25T`,
    'Owners' : {
        'PrimaryOwner' : { 'PersonId': 'KmA3XPKKFqYCP2zhR3d0Ho' },
        'SecondaryOwners' : []
    }
}

catatan

Menyisipkan pernyataan dan pernyataan DML-lainnya mengembalikan ID dari setiap dokumen yang terkena dampak. Sebelum melanjutkan, simpan ID ini karena Anda memerlukannya untuk fungsi riwayat di topik berikutnya. Anda juga dapat menemukan ID dokumen dengan kueri berikut.

SELECT r_id FROM VehicleRegistration AS r BY r_id
WHERE r.VIN = '1HVBBAANXWH544237'

UPDATE VehicleRegistration AS r 
SET r.City = 'Bellevue' 
WHERE r.VIN = '1HVBBAANXWH544237'

DELETE FROM VehicleRegistration AS r 
WHERE r.VIN = '1HVBBAANXWH544237'

Untuk contoh dan informasi selengkapnya tentang sintaks pernyataan DML-ini, lihatPERBARUI danHAPUS dalam referensi PartiQL Amazon QLDB.

Untuk menyisipkan dan menghapus elemen tertentu dalam dokumen, Anda dapat menggunakanUPDATE pernyataan atau pernyataan DML-lain yang dimulai denganFROM kata kunci. Untuk informasi dan contoh, lihatDARI (INSERT, HAPUS, atau SET) referensi.

Setelah Anda menghapus dokumen, Anda tidak dapat lagi menanyainya di tampilan berkomitmen atau pengguna. Untuk mempelajari cara menanyakan riwayat revisi dokumen ini menggunakan fungsi riwayat bawaan, lanjutkan keMelakukan Kueri Riwayat Riwayat Revisi.