Langkah 1: Meminta intisari di QLDB - Amazon Quantum Ledger Database (Amazon QLDB)

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

Langkah 1: Meminta intisari di QLDB

Amazon QLDB menyediakan API untuk meminta intisari yang mencakup ujung jurnal saat ini di buku besar Anda. Tip jurnal mengacu pada blok komitmen terbaru pada saat QLDB menerima permintaan Anda. Anda dapat menggunakan AWS Management Console, AWS SDK, atau AWS Command Line Interface (AWS CLI) untuk mendapatkan intisari.

AWS Management Console

Ikuti langkah-langkah ini untuk meminta intisari menggunakan konsol QLDB.

Untuk meminta intisari (konsol)
  1. Masuk ke AWS Management Console, dan buka konsol QLDB Amazon di https://console.aws.amazon.com/qldb.

  2. Di panel navigasi, pilih Buku Besar.

  3. Dalam daftar buku besar, pilih nama buku besar yang ingin Anda minta intisari.

  4. Pilih Dapatkan intisari. Kotak dialog Get digest menampilkan detail intisari berikut:

    • Digest — Nilai hash SHA-256 dari intisari yang Anda minta.

    • Alamat tip intisari — Lokasi blok terbaru dalam jurnal yang dicakup oleh intisari yang Anda minta. Sebuah alamat memiliki dua bidang berikut:

      • strandId— ID unik untai jurnal yang berisi blok.

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

    • Buku Besar — Nama buku besar yang Anda minta intisari.

    • Tanggal — Stempel waktu saat Anda meminta intisari.

  5. Tinjau informasi intisari. Lalu, pilih Simpan. Anda dapat menyimpan nama file default, atau memasukkan nama baru.

    catatan

    Anda mungkin memperhatikan bahwa nilai hash dan alamat tip intisari Anda berubah bahkan ketika Anda tidak memodifikasi data apa pun di buku besar Anda. Ini karena konsol mengambil katalog sistem buku besar setiap kali Anda menjalankan kueri di editor PartiQL. Ini adalah transaksi baca yang berkomitmen pada jurnal dan menyebabkan alamat blok terbaru berubah.

    Langkah ini menyimpan file plaintext dengan konten dalam format Amazon Ion. File ini memiliki ekstensi nama file .ion.txt dan berisi semua informasi intisari yang tercantum pada kotak dialog sebelumnya. Berikut ini adalah contoh isi file digest. Urutan bidang dapat bervariasi tergantung pada browser Anda.

    { "digest": "42zaJOfV8iGutVGNaIuzQWhD5Xb/5B9lScHnvxPXm9E=",   "digestTipAddress": "{strandId:\"BlFTjlSXze9BIh1KOszcE3\",sequenceNo:73}",   "ledger": "my-ledger",   "date": "2019-04-17T16:57:26.749Z" }
  6. Simpan file ini di mana Anda dapat mengaksesnya di masa depan. Kemudian, Anda dapat menggunakan file ini untuk memverifikasi revisi dokumen terhadap.

    penting

    Revisi dokumen yang Anda verifikasi nanti harus dicakup oleh intisari yang Anda simpan. Artinya, nomor urut alamat dokumen harus kurang dari atau sama dengan nomor urut alamat tip Digest.

QLDB API

Anda juga dapat meminta intisari dari buku besar Anda dengan menggunakan Amazon QLDB API dengan SDK atau file. AWS AWS CLI QLDB API 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.

Untuk informasi tentang meminta intisari menggunakan AWS CLI, lihat perintah get-digest di Referensi Perintah.AWS CLI

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 meminta intisari, pastikan Anda mengikuti Langkah 1-3 tutorial java untuk membuat buku besar sampel dan memuatnya dengan data sampel.

Kode tutorial di kelas GetDigestmemberikan contoh meminta intisari dari buku besar vehicle-registration sampel.

Untuk memverifikasi revisi dokumen menggunakan intisari yang Anda simpan, lanjutkan ke. Langkah 2: Memverifikasi data Anda di QLDB