Meminta ekspor jurnal di QLDB

Amazon QLDB menyediakan API untuk meminta ekspor blok jurnal Anda untuk rentang tanggal dan waktu tertentu serta tujuan bucket Amazon S3 yang ditentukan. Pekerjaan ekspor jurnal dapat menulis objek data baik dalam teks atau representasi biner format Amazon Ion, atau dalam format teks JSON Lines. Anda dapat menggunakan AWS Management Console, AWS SDK, atau AWS Command Line Interface (AWS CLI) untuk membuat pekerjaan ekspor.

AWS Management Console

Ikuti langkah-langkah berikut untuk mengirimkan permintaan ekspor jurnal di QLDB menggunakan konsol QLDB.

Untuk meminta ekspor (konsol)

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

2. Di panel navigasi, pilih Ekspor.

3. Pilih Buat pekerjaan ekspor.

4. Pada halaman Create export job, masukkan pengaturan ekspor berikut:

   • Ledger — Buku besar yang jurnalnya memblokir Anda ingin mengekspor.

   • Tanggal dan waktu mulai — Stempel waktu mulai inklusif di Coordinated Universal Time (UTC) dari rentang blok jurnal yang akan diekspor. Stempel waktu ini harus lebih awal dari tanggal dan waktu Akhir. Jika Anda memberikan stempel waktu awal yang lebih awal dari buku besar, CreationDateTime QLDB mendefaultkannya ke buku besar. CreationDateTime

   • Tanggal dan waktu akhir - Stempel waktu akhir eksklusif (UTC) dari rentang blok jurnal yang akan diekspor. Tanggal dan waktu ini tidak mungkin di masa depan.

   • Tujuan untuk blok jurnal — Bucket Amazon S3 dan nama awalan tempat pekerjaan ekspor Anda menulis objek data. Gunakan format URI Amazon S3 berikut.

     s3://DOC-EXAMPLE-BUCKET/prefix/

     Anda harus menentukan nama bucket S3 dan nama awalan opsional untuk objek keluaran. Berikut adalah contohnya.

     s3://DOC-EXAMPLE-BUCKET/journalExport/

     Nama bucket dan awalan harus mematuhi aturan dan konvensi penamaan Amazon S3. Untuk informasi selengkapnya tentang penamaan bucket, lihat Pembatasan dan batasan bucket di Panduan Pengembang Amazon S3. Untuk informasi selengkapnya tentang awalan nama kunci, lihat Kunci objek dan metadata.

     catatan

     Ekspor lintas wilayah tidak didukung. Bucket Amazon S3 yang ditentukan harus Wilayah AWS sama dengan buku besar Anda.

   • Enkripsi S3 - Pengaturan enkripsi yang digunakan oleh pekerjaan ekspor Anda untuk menulis data dalam bucket Amazon S3. Untuk mempelajari lebih lanjut tentang opsi enkripsi sisi server di Amazon S3, lihat Melindungi data menggunakan enkripsi sisi server di Panduan Pengembang Amazon S3.

     • Enkripsi default bucket — Gunakan pengaturan enkripsi default bucket Amazon S3 yang ditentukan.

     • AES-256 - Gunakan enkripsi sisi server dengan kunci terkelola Amazon S3 (SSE-S3).

     • AWS-KMS — Gunakan enkripsi sisi server dengan AWS KMS kunci terkelola (SSE-KMS).

       Jika Anda memilih jenis ini bersama dengan AWS KMS key opsi Pilih yang berbeda, Anda juga harus menentukan kunci KMS enkripsi simetris dalam format Amazon Resource Name (ARN) berikut.

       arn:aws:kms:aws-region:account-id:key/key-id

   • Akses layanan — Peran IAM yang memberikan izin menulis QLDB di bucket Amazon S3 Anda. Jika berlaku, peran IAM juga harus memberikan izin QLDB untuk menggunakan kunci KMS Anda.

     Untuk meneruskan peran ke QLDB saat meminta ekspor jurnal, Anda harus memiliki izin untuk melakukan iam:PassRole tindakan pada sumber daya peran IAM.

     • Buat dan gunakan peran layanan baru — Biarkan konsol membuat peran baru untuk Anda dengan izin yang diperlukan untuk bucket Amazon S3 yang ditentukan.

     • Gunakan peran layanan yang ada — Untuk mempelajari cara membuat peran ini secara manual di IAM, lihatIzin ekspor.

   • Format output - Format output dari data jurnal yang diekspor

     • Teks ion - (Default) Representasi teks Amazon Ion

     • Biner ion — Representasi biner dari Amazon Ion

     • JSON - Format teks JSON yang dibatasi Newline

       Jika Anda memilih JSON, QLDB menurunkan data jurnal Ion menjadi JSON di objek data yang diekspor. Untuk informasi selengkapnya, lihat Down-convert ke JSON.

5. Ketika pengaturan seperti yang Anda inginkan, pilih Buat pekerjaan ekspor.

   Jumlah waktu yang dibutuhkan untuk menyelesaikan pekerjaan ekspor Anda bervariasi tergantung pada ukuran data. Jika pengiriman permintaan Anda berhasil, konsol akan kembali ke halaman Ekspor utama dan mencantumkan pekerjaan ekspor Anda dengan statusnya saat ini.

6. Anda dapat melihat objek ekspor Anda di konsol Amazon S3.

   Buka konsol Amazon S3 di https://console.aws.amazon.com/s3/.

   Untuk mempelajari lebih lanjut tentang format objek keluaran ini, lihatOutput ekspor jurnal dalam QLDB.

catatan

Pekerjaan ekspor berakhir tujuh hari setelah selesai. Untuk informasi selengkapnya, lihat Kedaluwarsa pekerjaan ekspor.

QLDB API

Anda juga dapat meminta ekspor jurnal dengan menggunakan Amazon QLDB API dengan SDK AWS atau file. AWS CLI QLDB API menyediakan operasi berikut untuk digunakan oleh program aplikasi:

• ExportJournalToS3— Mengekspor konten jurnal dalam rentang tanggal dan waktu dari buku besar tertentu ke ember Amazon S3 tertentu. Pekerjaan ekspor dapat menulis data sebagai objek baik dalam teks atau representasi biner format Amazon Ion, atau dalam format teks JSON Lines.

• DescribeJournalS3Export— Mengembalikan informasi rinci tentang pekerjaan ekspor jurnal. Outputnya mencakup statusnya saat ini, waktu pembuatan, dan parameter permintaan ekspor asli Anda.

• ListJournalS3Exports— Mengembalikan daftar deskripsi pekerjaan ekspor jurnal untuk semua buku besar yang terkait dengan saat ini Akun AWS dan Wilayah. Output dari setiap deskripsi pekerjaan ekspor mencakup detail yang sama yang dikembalikan olehDescribeJournalS3Export.

• ListJournalS3ExportsForLedger— Mengembalikan daftar deskripsi pekerjaan ekspor jurnal untuk buku besar yang diberikan. Output dari setiap deskripsi pekerjaan ekspor mencakup detail yang sama yang dikembalikan olehDescribeJournalS3Export.

Untuk deskripsi lengkap tentang operasi API ini, lihat. Referensi API Amazon QLDB

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

Contoh aplikasi (Java)

Untuk contoh kode Java dari operasi ekspor dasar, 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 ekspor, pastikan Anda mengikuti Langkah 1-3 tutorial java untuk membuat buku besar sampel dan memuatnya dengan data sampel.

Kode tutorial di kelas berikut memberikan contoh pembuatan ekspor, memeriksa status ekspor, dan memproses output ekspor.

Kelas	Deskripsi
ExportJournal	Mengekspor blok jurnal dari buku besar vehicle-registration sampel untuk rentang waktu 10 menit yang lalu hingga sekarang. Menulis objek keluaran dalam bucket S3 tertentu, atau buat bucket unik jika tidak disediakan.
DescribeJournalExport	Menjelaskan pekerjaan ekspor jurnal untuk yang ditentukan exportId dalam buku besar vehicle-registration sampel.
ListJournalExports	Mengembalikan daftar deskripsi pekerjaan ekspor jurnal untuk buku besar vehicle-registration sampel.
ValidateQldbHashChain	Memvalidasi rantai hash dari buku besar vehicle-registration sampel menggunakan yang diberikan. exportId Jika tidak disediakan, minta ekspor baru untuk digunakan untuk validasi rantai hash.

Kedaluwarsa pekerjaan ekspor

Pekerjaan ekspor jurnal yang diselesaikan tunduk pada periode retensi 7 hari. Mereka secara otomatis dihapus setelah batas ini kedaluwarsa. Periode kedaluwarsa ini adalah batas yang sulit dan tidak dapat diubah.

Setelah tugas ekspor selesai dihapus, Anda tidak dapat lagi menggunakan konsol QLDB atau operasi API berikut untuk mengambil metadata tentang pekerjaan:

• DescribeJournalS3Export

• ListJournalS3Exports

• ListJournalS3ExportsForLedger

Namun, kedaluwarsa ini tidak berdampak pada data yang diekspor itu sendiri. Semua metadata disimpan dalam file manifes yang ditulis oleh ekspor Anda. Kedaluwarsa ini dirancang untuk memberikan pengalaman yang lebih lancar bagi operasi API yang mencantumkan pekerjaan ekspor jurnal. QLDB menghapus pekerjaan ekspor lama untuk memastikan bahwa Anda hanya melihat ekspor terbaru tanpa harus mengurai beberapa halaman pekerjaan.