Meminta ekspor jurnal 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 permintaan 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 JSONGaris. Anda dapat menggunakan AWS Management Console, an 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 dalam QLDB menggunakan QLDB konsol.

Untuk meminta ekspor (konsol)

1. Masuk ke AWS Management Console, dan buka QLDB konsol 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 besarCreationDateTime, QLDB defaultkan 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 Amazon S3 URI berikut.

     s3://amzn-s3-demo-bucket/prefix/

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

     s3://amzn-s3-demo-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 (-S3). SSE

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

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

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

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

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

     • 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 manualIAM, 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 yang dibatasi Newline JSON

       Jika Anda memilihJSON, QLDB turunkan data jurnal Ion ke JSON objek data yang diekspor. Untuk informasi selengkapnya, lihat Down-konversi 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 di 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 file AWS SDK atau file AWS CLI. QLDBAPIIni 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 Garis.

• 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 API operasi ini, lihat. QLDBAPIReferensi Amazon

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 pekerjaan ekspor selesai dihapus, Anda tidak dapat lagi menggunakan QLDB konsol atau API operasi 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 untuk API operasi yang mencantumkan pekerjaan ekspor jurnal. QLDBmenghapus pekerjaan ekspor lama untuk memastikan bahwa Anda hanya melihat ekspor terbaru tanpa harus mengurai beberapa halaman pekerjaan.