Langkah 2: Memverifikasi data Anda di 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

Amazon QLDB menyediakan API untuk meminta bukti untuk ID dokumen tertentu dan blok terkaitnya. Anda juga harus memberikan alamat tip dari intisari yang sebelumnya Anda simpan, seperti yang dijelaskan dalamLangkah 1: Meminta intisari QLDB. Anda dapat menggunakan AWS Management Console, an AWS SDK, atau AWS CLI untuk mendapatkan bukti.

Kemudian, Anda dapat menggunakan bukti yang dikembalikan oleh QLDB untuk memverifikasi revisi dokumen terhadap intisari yang disimpan, menggunakan sisi klien. API Ini memberi Anda kontrol atas algoritme yang Anda gunakan untuk memverifikasi data Anda.

AWS Management Console

Bagian ini menjelaskan langkah-langkah untuk memverifikasi revisi dokumen terhadap intisari yang disimpan sebelumnya menggunakan konsol AmazonQLDB.

Sebelum Anda mulai, pastikan Anda mengikuti langkah-langkahnyaLangkah 1: Meminta intisari QLDB. Verifikasi memerlukan intisari yang disimpan sebelumnya yang mencakup revisi yang ingin Anda verifikasi.

Untuk memverifikasi revisi dokumen (konsol)

1. Buka QLDB konsol Amazon di https://console.aws.amazon.com/qldb.

2. Pertama, kueri buku besar Anda untuk id dan blockAddress revisi yang ingin Anda verifikasi. Bidang ini disertakan dalam metadata dokumen, yang dapat Anda kueri dalam tampilan komit.

   Dokumen id ini adalah string ID unik yang ditetapkan sistem. blockAddressIni adalah struktur Ion yang menentukan lokasi blok tempat revisi dilakukan.

   Di panel navigasi, pilih editor PartiQL.

3. Pilih nama buku besar di mana Anda ingin memverifikasi revisi.

4. Di jendela editor kueri, masukkan SELECT pernyataan dalam sintaks berikut, lalu pilih Jalankan.

   SELECT metadata.id, blockAddress FROM _ql_committed_table_name
   WHERE criteria

   Misalnya, query berikut mengembalikan dokumen dari VehicleRegistration tabel dalam contoh buku besar yang dibuat diMemulai dengan QLDB konsol Amazon.

   SELECT r.metadata.id, r.blockAddress FROM _ql_committed_VehicleRegistration AS r 
   WHERE r.data.VIN = 'KM8SRDHF6EU074761'

5. Salin dan simpan id dan blockAddress nilai yang dikembalikan kueri Anda. Pastikan untuk menghilangkan tanda kutip ganda untuk id bidang tersebut. Di Amazon Ion, tipe data string dibatasi dengan tanda kutip ganda. Misalnya, Anda harus menyalin hanya teks alfanumerik dalam cuplikan berikut.

   "LtMNJYNjSwzBLgf7sLifrG"

6. Sekarang setelah Anda memilih revisi dokumen, Anda dapat memulai proses memverifikasinya.

   Di panel navigasi, pilih Verifikasi.

7. Pada formulir Verifikasi dokumen, di bawah Tentukan dokumen yang ingin Anda verifikasi, masukkan parameter input berikut:

   • Buku besar — Buku besar di mana Anda ingin memverifikasi revisi.

   • Alamat blok — blockAddress Nilai yang dikembalikan oleh kueri Anda di langkah 4.

   • ID Dokumen - id Nilai yang dikembalikan oleh kueri Anda di langkah 4.

8. Di bawah Tentukan intisari yang akan digunakan untuk verifikasi, pilih intisari yang sebelumnya Anda simpan dengan memilih Pilih intisari. Jika file tersebut valid, ini secara otomatis mengisi semua bidang intisari di konsol Anda. Atau, Anda dapat menyalin dan menempelkan nilai berikut secara manual langsung dari file intisari Anda:

   • Digest — digest Nilai dari file digest Anda.

   • Alamat tip intisari — digestTipAddress Nilai dari file intisari Anda.

9. Tinjau dokumen Anda dan intisari parameter input, lalu pilih Verifikasi.

   Konsol mengotomatiskan dua langkah untuk Anda:

   1. Minta bukti dari dokumen QLDB yang Anda tentukan.

   2. Gunakan bukti yang dikembalikan oleh QLDB untuk memanggil sisi klienAPI, yang memverifikasi revisi dokumen Anda terhadap intisari yang disediakan. Untuk memeriksa algoritma verifikasi ini, lihat bagian berikut QLDB API untuk mengunduh contoh kode.

   Konsol menampilkan hasil permintaan Anda di kartu hasil Verifikasi. Untuk informasi selengkapnya, lihat Hasil verifikasi.

QLDB API

Anda juga dapat memverifikasi revisi dokumen dengan menggunakan Amazon QLDB API dengan file AWS SDK atau file. AWS CLI QLDBAPIIni menyediakan operasi berikut untuk digunakan oleh program aplikasi:

• GetDigest— Mengembalikan intisari buku besar di blok komitmen terbaru dalam jurnal. Responsnya mencakup nilai hash 256-bit dan alamat blok.

• GetBlock— Mengembalikan objek blok pada alamat tertentu dalam jurnal. Juga mengembalikan bukti blok yang ditentukan untuk verifikasi jika DigestTipAddress disediakan.

• GetRevision— Mengembalikan objek data revisi untuk ID dokumen tertentu dan alamat blok. Juga mengembalikan bukti revisi yang ditentukan untuk verifikasi jika DigestTipAddress disediakan.

Untuk deskripsi lengkap tentang API operasi ini, lihat. QLDBAPIReferensi Amazon

Untuk informasi tentang memverifikasi data menggunakan AWS CLI, lihat Referensi AWS CLI Perintah.

Aplikasi sampel

Untuk contoh kode Java, lihat GitHub repositori amazon-qldb-dmv-sampleaws-samples/ -java. Untuk petunjuk tentang cara mengunduh dan menginstal aplikasi sampel ini, lihatMenginstal aplikasi sampel Amazon QLDB Java. Sebelum melakukan verifikasi, pastikan Anda mengikuti Langkah 1-3 Tutorial Java untuk membuat buku besar sampel dan memuatnya dengan data sampel.

Kode tutorial di kelas GetRevisionmemberikan contoh meminta bukti untuk revisi dokumen dan kemudian memverifikasi revisi itu. Kelas ini menjalankan langkah-langkah berikut:

1. Meminta intisari baru dari buku besar vehicle-registration sampel.

2. Meminta bukti untuk revisi dokumen sampel dari VehicleRegistration tabel di vehicle-registration buku besar.

3. Memverifikasi revisi sampel menggunakan intisari dan bukti yang dikembalikan.