View a markdown version of this page

Wechseln Sie nach einem Rollback von KCL 3.5.x zu KCL 3.5.x - 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.

Wechseln Sie nach einem Rollback von KCL 3.5.x zu KCL 3.5.x

In diesem Thema werden die Schritte erläutert, mit denen Sie Ihren Kunden nach einem Rollback wieder auf KCL 3.5.x umstellen können. Wenn Sie einen Rollforward durchführen müssen, müssen Sie einen zweistufigen Prozess durchlaufen:

  1. Führen Sie das KCL Migration Tool aus.

  2. Stellen Sie den Phase-2-Code bereit.

Schritt 1: Ausführen des KCL Migration Tools

Führen Sie das KCL-Migrationstool mit dem folgenden Befehl aus, um zu KCL 3.5.x zu wechseln:

python3 ./KclMigrationTool.py --region <region> --mode rollforward [--application_name <applicationName>] [--lease_table_name <leaseTableName>]

Parameter

  • --region: Ersetze durch deine. <region> AWS-Region

  • --application_name: Dieser Parameter ist erforderlich, wenn Sie den Standardnamen für Ihre Leasing-Tabelle verwenden. Wenn Sie einen benutzerdefinierten Namen für die Leasing-Tabelle angegeben haben, können Sie diesen Parameter weglassen. Ersetzen Sie ihn <applicationName> durch Ihren tatsächlichen KCL-Anwendungsnamen. Das Tool verwendet diesen Namen, um den Standardtabellennamen abzuleiten, falls kein benutzerdefinierter Name angegeben wird.

  • --lease_table_name (optional): Dieser Parameter wird benötigt, wenn Sie in Ihrer KCL-Konfiguration einen benutzerdefinierten Namen für die Leasing-Tabelle festgelegt haben. Wenn Sie den Standardtabellennamen verwenden, können Sie diesen Parameter weglassen. Ersetzen Sie ihn <leaseTableName> durch den benutzerdefinierten Tabellennamen, den Sie für Ihre Leasingtabelle angegeben haben.

Nachdem Sie das Migrationstool im Roll-Forward-Modus ausgeführt haben, erstellt KCL die folgende DynamoDB-Ressource, die für KCL 3.5.x erforderlich ist:

  • einen globalen sekundären Index für die Leasetabelle

Anmerkung

KCL 3.5.x erstellt während der Migration keine separaten Worker-Metriken oder Koordinator-Statustabellen. Alle Metadaten werden in der Leasing-Tabelle gespeichert.

Schritt 2: Stellen Sie den Code mit der Phase-2-Konfiguration bereit

Nachdem Sie das KCL-Migrationstool für einen Rollforward ausgeführt haben, stellen Sie Ihren Code mit der KCL 3.5.x Phase 2-Konfiguration (CLIENT_VERSION_CONFIG_COMPATIBLE_WITH_2X) für Ihre Mitarbeiter bereit. Folgen Sie den Anweisungen, Schritt 8: Schließen Sie die Migration ab um Ihre Migration abzuschließen.