View a markdown version of this page

Migrasi 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.

Migrasi 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 mengkonfigurasi. 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 penyebaran selesai pada semua pekerja. Pantau entri status TableMigration3.5 koordinator hingga TableMigrationStatus mencapaiDEPLOYED. Verifikasi bahwa tidak ada regresi dan berikan waktu memanggang yang cukup.

  3. Fase 2: Terapkan lagi dengan migrateAllEntitiesToLeaseTable set ketrue. Penerapan ini memulai migrasi ke format tabel tunggal.

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

  5. Setelah status mencapai LENGKAP, verifikasi bahwa tidak ada regresi dan berikan waktu pemanggangan tambahan untuk memastikan tidak ada rollback yang diperlukan.

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

penting

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

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