View a markdown version of this page

Revenir à la phase 2 de KCL 3.5.x+ après une restauration - Amazon DynamoDB

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Revenir à la phase 2 de KCL 3.5.x+ après une restauration

Cette rubrique explique comment transférer votre application client vers KCL 3.5.x+ après une restauration. Lorsque vous devez effectuer une restauration par progression, vous devez suivre un processus en deux étapes :

  1. Exécutez l'outil de migration KCL sur le GitHub site Web.

  2. Déployez le code de phase 2.

Étape 1 : exécuter l’outil de migration de la KCL

Exécutez l'outil de migration KCL avec la commande suivante pour passer à KCL 3.5.x+ :

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

Parameters

--region

Remplacez region par votre Région AWS.

--application_name

Ce paramètre est obligatoire si vous utilisez le nom par défaut pour votre table de baux. Si vous avez spécifié un nom personnalisé pour la table des baux, vous pouvez omettre ce paramètre. Remplacez-le applicationName par le nom actuel de votre application KCL. L'outil utilise ce nom pour dériver le nom de table par défaut si aucun nom personnalisé n'est fourni.

--lease_table_name

Ce paramètre est nécessaire si vous avez défini un nom personnalisé pour la table des baux dans votre configuration KCL. Si vous utilisez le nom de table par défaut, vous pouvez omettre ce paramètre. Remplacez-le leaseTableName par le nom de table personnalisé que vous avez spécifié pour votre tableau des baux.

Après avoir exécuté l'outil de migration en mode roll-forward, KCL crée la ressource DynamoDB suivante requise pour KCL 3.5.x+ :

  • Un index secondaire global sur la table des baux

Note

KCL 3.5.x+ ne crée pas de métriques de travail distinctes ni de tables d'état des coordinateurs distinctes lors de la migration. Toutes les métadonnées sont stockées dans la table des baux.

Étape 2 : Déployer le code avec la configuration de la phase 2

Après avoir exécuté l'outil de migration KCL pour une version ultérieure, déployez votre code avec la configuration KCL 3.5.x+ Phase 2 () CLIENT_VERSION_CONFIG_COMPATIBLE_WITH_2X auprès de vos collaborateurs. Pour terminer votre migration, consultez Step 8: Complete the migration.