View a markdown version of this page

Bermigrasi dari KCL 3.x ke format tabel tunggal - Amazon Kinesis Data Streams

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

Bermigrasi dari KCL 3.x ke format tabel tunggal

Jika Anda menjalankan KCL 3.x dengan ketiga tabel metadata DynamoDB (tabel sewa, tabel metrik pekerja, dan tabel status koordinator), Anda dapat bermigrasi ke format tabel tunggal untuk mengkonsolidasikan semua metadata ke dalam tabel sewa.

Prasyarat

  • Aplikasi Anda menjalankan KCL 3.x dengan ketiga tabel metadata.

  • Aplikasi Anda stabil dan semua pekerja sehat.

  • Aplikasi Anda telah menyelesaikan migrasi KCL 3.x dan tidak dikonfigurasi. CoordinatorConfig.clientVersionConfig Jangan melakukan migrasi tabel dan migrasi versi klien dari 2.x ke 3.x secara bersamaan.

Untuk bermigrasi dari KCL 3.x ke format tabel tunggal, ikuti proses penerapan dua fase

  1. Tahap 1: Perbarui ketergantungan proyek Anda ke KCL 3.5 atau yang lebih baru. Terapkan dengan migrateAllEntitiesToLeaseTable set ke false (default). Penerapan ini menginstal kode baru yang mendukung format tabel tunggal tetapi tidak mengaktifkan migrasi.

  2. Tunggu hingga penerapan selesai pada semua pekerja. Pantau entri negara TableMigration3.5 koordinator sampai TableMigrationStatus mencapaiDEPLOYED. Pastikan tidak ada regresi dan berikan waktu memanggang yang cukup.

  3. Tahap 2: Terapkan lagi dengan dis migrateAllEntitiesToLeaseTable etel ketrue. Penerapan ini memulai migrasi ke format tabel tunggal.

  4. PantauTableMigrationStatus. Pekerja pemimpin memajukan status melalui DEPLOYED, PENDING, dan COMPLETE.

  5. Setelah status mencapai SELESAI, verifikasi bahwa tidak ada regresi dan berikan waktu memanggang tambahan untuk memastikan tidak diperlukan rollback.

  6. Hapus metrik pekerja lama dan tabel status koordinator secara manual. KCL tidak menghapus tabel ini secara otomatis—hanya berhenti menggunakannya. Jika Anda telah mengonfigur CoordinatorConfig.coordinatorStateTableConfig asi atauLeaseManagementConfig.workerUtilizationAwareAssignmentConfig.workerMetricsTableConfig, Anda dapat menghapus konfigurasi ini karena tidak digunakan lagi.

penting

Jangan mengembalikan aplikasi Anda setelah migrasi mencapai status LENGKAP. Setelah SELESAI, aplikasi beroperasi secara eksklusif dalam mode tabel tunggal. Bahkan rollback kode ke Tahap 1 tidak beralih kembali ke beberapa tabel — konfigurasi diabaikan dan aplikasi terus menggunakan hanya tabel sewa.

Untuk detail tentang status migrasi dan opsi rollback, lihatFormat tabel tunggal untuk KCL.