View a markdown version of this page

Migra da KCL 3.x al formato a tabella singola - Flusso di dati Amazon Kinesis

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Migra da KCL 3.x al formato a tabella singola

Se esegui KCL 3.x con tutte e tre le tabelle di metadati DynamoDB (tabella di lease, tabella delle metriche dei lavoratori e tabella dello stato del coordinatore), puoi migrare al formato a tabella singola per consolidare tutti i metadati nella tabella di lease.

Prerequisiti

  • La tua applicazione esegue KCL 3.x con tutte e tre le tabelle di metadati.

  • La tua applicazione è stabile e tutti i lavoratori sono sani.

  • La tua applicazione ha completato la migrazione a KCL 3.x e non si configura. CoordinatorConfig.clientVersionConfig Non eseguire contemporaneamente la migrazione della tabella e la migrazione della versione del client da 2.x a 3.x.

Per migrare da KCL 3.x al formato a tabella singola, segui il processo di distribuzione in due fasi

  1. Fase 1: aggiorna la dipendenza del tuo progetto a KCL 3.5 o successivo. Implementa con migrateAllEntitiesToLeaseTable set to false (impostazione predefinita). Questa distribuzione installa il nuovo codice che supporta il formato a tabella singola ma non attiva la migrazione.

  2. Attendi il completamento della distribuzione su tutti i lavoratori. Monitora l'ingresso dello stato TableMigration3.5 del coordinatore fino al raggiungimento dei TableMigrationStatus risultati. DEPLOYED Verificate che non vi siano regressioni e concedete un tempo di cottura sufficiente.

  3. Fase 2: eseguire nuovamente la distribuzione con migrateAllEntitiesToLeaseTable set to. true Questa distribuzione avvia la migrazione al formato a tabella singola.

  4. Monitora il. TableMigrationStatus Il lavoratore leader fa avanzare lo stato tramite DEPLOYED, PENDING e COMPLETE.

  5. Una volta raggiunto lo stato COMPLETE, verificate che non vi siano regressioni e concedete un tempo di cottura aggiuntivo per assicurarvi che non siano necessari i rollback.

  6. Elimina manualmente le vecchie tabelle delle metriche dei lavoratori e dello stato dei coordinatori. KCL non elimina queste tabelle automaticamente, ma smette solo di utilizzarle. Se hai configurato CoordinatorConfig.coordinatorStateTableConfig oLeaseManagementConfig.workerUtilizationAwareAssignmentConfig.workerMetricsTableConfig, puoi rimuovere queste configurazioni poiché sono obsolete.

Importante

Non eseguire il rollback dell'applicazione dopo che la migrazione ha raggiunto lo stato COMPLETO. Dopo il completamento, l'applicazione funziona esclusivamente in modalità tabella singola. Anche il rollback del codice alla Fase 1 non comporta il ritorno a più tabelle: la configurazione viene ignorata e l'applicazione continua a utilizzare solo la tabella di lease.

Per dettagli sugli stati di migrazione e sulle opzioni di rollback, vedere. Formato a tabella singola per KCL