View a markdown version of this page

Migrieren Sie von KCL 3.x zum Einzeltabellenformat - Amazon Kinesis Data Streams

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Migrieren Sie von KCL 3.x zum Einzeltabellenformat

Wenn Sie KCL 3.x mit allen drei DynamoDB-Metadatentabellen (Leasing-Tabelle, Worker-Metriktabelle und Coordinator-State-Tabelle) ausführen, können Sie zum Einzeltabellenformat migrieren, um alle Metadaten in der Leasing-Tabelle zu konsolidieren.

Voraussetzungen

  • In Ihrer Anwendung wird KCL 3.x mit allen drei Metadatentabellen ausgeführt.

  • Ihre Anwendung ist stabil und alle Mitarbeiter sind gesund.

  • Ihre Anwendung hat die KCL 3.x-Migration abgeschlossen und kann nicht konfiguriert werden. CoordinatorConfig.clientVersionConfig Führen Sie die Tabellenmigration und die Migration der Client-Version von 2.x auf 3.x nicht gleichzeitig durch.

Um von KCL 3.x zum Einzeltabellenformat zu migrieren, folgen Sie dem zweistufigen Bereitstellungsprozess

  1. Phase 1: Aktualisieren Sie Ihre Projektabhängigkeit auf KCL 3.5 oder höher. Bereitstellen mit migrateAllEntitiesToLeaseTable Einstellung auf false (Standardeinstellung). Diese Bereitstellung installiert den neuen Code, der das Einzeltabellenformat unterstützt, die Migration jedoch nicht aktiviert.

  2. Warten Sie, bis die Bereitstellung für alle Worker abgeschlossen ist. Überwachen Sie den Status des TableMigration3.5 Koordinators, bis TableMigrationStatus er erreicht istDEPLOYED. Stellen Sie sicher, dass keine Regressionen auftreten, und lassen Sie ausreichend Backzeit einplanen.

  3. Phase 2: Erneut bereitstellen, wobei auf migrateAllEntitiesToLeaseTable gesetzt ist. true Mit dieser Bereitstellung beginnt die Migration zum Einzeltabellenformat.

  4. Überwachen Sie dieTableMigrationStatus. Der führende Arbeiter erhöht den Status über EINGESETZT, AUSSTEHEND und ABGESCHLOSSEN.

  5. Wenn der Status COMPLETE erreicht hat, stellen Sie sicher, dass keine Regressionen vorliegen, und planen Sie zusätzliche Backzeit ein, um sicherzustellen, dass keine Rollbacks erforderlich sind.

  6. Löschen Sie die alten Worker-Metriken und die Koordinator-Statustabellen manuell. KCL löscht diese Tabellen nicht automatisch — es verwendet sie nur nicht mehr. Wenn Sie CoordinatorConfig.coordinatorStateTableConfig oder konfiguriert haben, können Sie diese Konfigurationen entfernenLeaseManagementConfig.workerUtilizationAwareAssignmentConfig.workerMetricsTableConfig, da sie veraltet sind.

Wichtig

Führen Sie kein Rollback Ihrer Anwendung durch, nachdem die Migration den Status COMPLETE erreicht hat. Nach COMPLETE arbeitet die Anwendung ausschließlich im Einzeltabellenmodus. Selbst bei einem Code-Rollback zu Phase 1 wird nicht zu mehreren Tabellen zurückgewechselt — die Konfiguration wird ignoriert und die Anwendung verwendet weiterhin nur die Leasetabelle.

Einzelheiten zu den Migrationszuständen und Rollback-Optionen finden Sie unter. Einzeltabellenformat für KCL