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 (Leasetabelle, Worker-Metriktabelle und Koordinatorstatentabelle) ausführen, können Sie zum Einzeltabellenformat migrieren, um alle Metadaten in der Leasetabelle 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 zweiphasigen Bereitstellungsprozess

  1. Phase 1: Aktualisieren Sie Ihre Projektabhängigkeit auf KCL 3.5 oder höher. Stellen Sie das Deployment so migrateAllEntitiesToLeaseTable ein, dass es auf eingestellt ist false (Standardeinstellung). Bei dieser Bereitstellung wird der neue Code installiert, der das Einzeltabellenformat unterstützt, die Migration jedoch nicht aktiviert.

  2. Warten Sie, bis die Bereitstellung für alle Mitarbeiter abgeschlossen ist. Überwachen Sie den Eintrag des TableMigration3.5 Koordinatorstaates, bis der Status TableMigrationStatus erreicht istDEPLOYED. Vergewissern Sie sich, dass keine Regressionen vorliegen, und achten Sie darauf, dass genügend Backzeit eingeplant ist.

  3. Phase 2: Erneute Bereitstellung mit migrateAllEntitiesToLeaseTable Einstellung auf. true Mit dieser Bereitstellung beginnt die Migration zum Einzeltabellenformat.

  4. Überwachen Sie dieTableMigrationStatus. Der leitende Mitarbeiter bringt den Status in den Stufen DEPLOYED, PENDING und COMPLETE weiter.

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

  6. Löschen Sie die alten Tabellen mit den Arbeitskennzahlen und den Koordinatorstatus manuell. KCL löscht diese Tabellen nicht automatisch, sondern 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 für Ihre Anwendung kein Rollback durch, nachdem die Migration den Status COMPLETE erreicht hat. Nach COMPLETE arbeitet die Anwendung ausschließlich im Einzeltabellenmodus. Selbst ein Code-Rollback zu Phase 1 führt nicht zu mehreren Tabellen zurück — die Konfiguration wird ignoriert und die Anwendung verwendet weiterhin nur die Leasetabelle.

Einzelheiten zu Migrationsstatus und Rollback-Optionen finden Sie unter. Einzeltabellenformat für KCL