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. # Versions des tables globales DynamoDB Deux versions des tables globales DynamoDB sont disponibles : la version 2019.11.21 (actuelle) et la version 2017.11.29 (héritée). Nous recommandons d’utiliser la version 2019.11.21 (actuelle) des tables globales, car elle est plus facile à utiliser, est prise en charge dans un plus grand nombre de régions et coûte moins cher pour la plupart des charges de travail que la version 2017.11.29 (héritée). ## Détermination de la version d’une table globale ### Déterminer la version à l'aide du AWS CLI #### Identification d’une réplica de table globale de la version 2019.11.21 (actuelle) Pour déterminer si une table est une réplica de table globale 2019.11.21 (actuelle), appelez la commande `describe-table` de la table. Si la sortie contient l’attribut `GlobalTableVersion` dont la valeur est « 2019.11.21 », la table est un réplica de table globale de la version 2019.11.21 (actuelle). Exemple de commande CLI pour `describe-table` : ``` aws dynamodb describe-table \ --table-name users \ --region us-east-2 ``` La sortie (abrégée) contient l’attribut `GlobalTableVersion` dont la valeur est « 2019.11.21 ». La table est donc un réplica de table globale de la version 2019.11.21 (actuelle). ``` { "Table": { "AttributeDefinitions": [ { "AttributeName": "id", "AttributeType": "S" }, { "AttributeName": "name", "AttributeType": "S" } ], "TableName": "users", ... "GlobalTableVersion": "2019.11.21", "Replicas": [ { "RegionName": "us-west-2", "ReplicaStatus": "ACTIVE", } ], ... } } ``` #### Identification d’un réplica de table version 2017.11.29 (héritée) La version 2017.11.29 (héritée) des tables globales utilise un ensemble de commandes dédié pour la gestion globale des tables. Pour déterminer si une table est un réplica de tables globales version 2017.11.29 (actuelle), invoquez la commande `describe-global-table` pour la table. Si vous recevez une réponse positive, la table est un réplica de table globale de la version 2017.11.29 (héritée). Si la commande `describe-global-table` renvoie une erreur `GlobalTableNotFoundException`, la table n’est pas un réplica de la version 2017.11.29 (héritée). Exemple de commande CLI pour `describe-global-table` : ``` aws dynamodb describe-global-table \ --table-name users \ --region us-east-2 ``` La commande renvoie une réponse positive, de sorte que la table est un réplica de table globale de la version 2017.11.29 (héritée). ``` { "GlobalTableDescription": { "ReplicationGroup": [ { "RegionName": "us-west-2" }, { "RegionName": "us-east-2" } ], "GlobalTableArn": "arn:aws:dynamodb::123456789012:global-table/users", "CreationDateTime": "2025-06-10T13:55:53.630000-04:00", "GlobalTableStatus": "ACTIVE", "GlobalTableName": "users" } } ``` ### Détermination de la version à l’aide de la console DynamoDB Pour identifier la version d’un réplica de table globale, effectuez les opérations suivantes : 1. [Ouvrez la console DynamoDB à la maison. https://console.aws.amazon.com/dynamodb/](https://console.aws.amazon.com/dynamodb/home) 1. Dans le volet de navigation sur le côté gauche de la console, choisissez **Tables**. 1. Choisissez la table dont vous souhaitez identifier la version des tables globales. 1. Choisissez l’onglet **Tables globales**. La section *Récapitulatif* affiche la version des tables globales utilisée. ## Différences de comportement entre les versions héritées et les versions actuelles La liste suivante décrit les différences de comportement entre les versions héritées et actuelles des tables globales. + La version 2019.11.21 (actuelle) utilise moins de capacité d’écriture pour plusieurs opérations DynamoDB que la version 2017.11.29 (héritée), et est donc plus rentable pour la plupart des clients. Les différences de ces opérations DynamoDB sont les suivantes : + L'appel [PutItem](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_PutItem.html)d'un élément de 1 Ko dans une région et sa réplication vers d'autres régions nécessitent 2 r WRUs par région pour le 29 novembre 2017 (ancien), mais seulement 1 RWru pour le 21 novembre 2019 (actuel). + L'invocation [UpdateItem](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_UpdateItem.html)d'un élément de 1 Ko nécessite 2 r WRUs dans la région source et 1 RWru par région de destination pour le 29 novembre 2017 (ancienne), mais un seul RWru pour les régions source et de destination pour le 21 novembre 2019 (actuel). + L'appel [DeleteItem](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_DeleteItem.html)d'un élément de 1 Ko nécessite 1 RWru dans la région source et 2 r WRUs par région de destination pour le 29 novembre 2017 (ancien), mais un seul RWru pour la région source ou de destination pour le 21 novembre 2019 (actuel). Le tableau suivant montre la consommation rWRU des tables 2017.11.29 (ancienne) et 2019.11.21 (actuelle) pour un élément de 1 Ko dans deux régions. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/amazondynamodb/latest/developerguide/V2globaltables_versions.html) + la version 2017.11.29 (Legacy) n'est disponible que dans la version 11. Régions AWS Cependant, la version 2019.11.21 (actuelle) est disponible dans toutes les Régions AWS. + Vous créez les tables globales de la version 2017.11.29 (Legacy) en créant d'abord un ensemble de tables régionales vides, puis en invoquant l'[CreateGlobalTable](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_CreateGlobalTable.html)API pour former la table globale. Vous créez des tables globales de la version 2019.11.21 (Current) en appelant l'[UpdateTable](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_UpdateTable.html)API pour ajouter une réplique à une table régionale existante. + La version 2017.11.29 (héritée) vous oblige à vider tous les réplicas de la table avant d’ajouter un réplica dans une nouvelle région (y compris lors de la création). La version 2019.11.21 (actuelle) vous permet d’ajouter et de supprimer des réplicas dans les régions d’une table contenant déjà des données. + la version 2017.11.29 (Legacy) utilise l'ensemble de plans de contrôle dédié suivant APIs pour gérer les répliques : + [CreateGlobalTable](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_CreateGlobalTable.html) + [DescribeGlobalTable](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_DescribeGlobalTable.html) + [DescribeGlobalTableSettings](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_DescribeGlobalTableSettings.html) + [ListGlobalTables](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_ListGlobalTables.html) + [UpdateGlobalTable](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_UpdateGlobalTable.html) + [UpdateGlobalTableSettings](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_UpdateGlobalTableSettings.html) la version 2019.11.21 (Current) utilise le [DescribeTable](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_DescribeTable.html)et [UpdateTable](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_UpdateTable.html) APIs pour gérer les répliques. + la version 2017.11.29 (héritée) publie deux enregistrements DynamoDB Streams pour chaque écriture. La version 2019.11.21 (actuelle) ne publie qu’un seul enregistrement DynamoDB Streams pour chaque écriture. + La version 2017.11.29 (héritée) renseigne et met à jour les attributs `aws:rep:deleting`, `aws:rep:updateregion` et `aws:rep:updatetime`. La version 2019.11.21 (actuelle) ne renseigne ni ne met à jour ces attributs. + La version 2017.11.29 (héritée) ne synchronise pas les paramètres [Utilisation de la durée de vie (TTL) dans DynamoDB](TTL.md) entre les réplicas. La version 2019.11.21 (actuelle) synchronise les paramètres TTL entre les réplicas. + la version 2017.11.29 (héritée) ne réplique pas les suppressions TTL vers d’autres réplicas. La version 2019.11.21 (actuelle) réplique les suppressions TTL dans tous les réplicas. + La version 2017.11.29 (héritée) ne synchronise pas les paramètres d’[autoscaling](AutoScaling.md) entre les réplicas. La version 2019.11.21 (actuelle) synchronise les paramètres d’autoscaling entre les réplicas. + La version 2017.11.29 (héritée) ne synchronise pas les paramètres d’[index secondaires globaux (GSI)](GSI.md) entre les réplicas. La version 2019.11.21 (actuelle) synchronise les paramètres GSI entre les réplicas. + La version 2017.11.29 (héritée) ne synchronise pas les paramètres de [chiffrement au repos](encryption.usagenotes.md) entre les réplicas. La version 2019.11.21 (actuelle) synchronise les paramètres de chiffrement au repos entre les réplicas. + La version 2017.11.29 (héritée) publie la métrique `PendingReplicationCount`. La version 2019.11.21 (actuelle) ne publie pas cette métrique. ## Mise à niveau vers la version actuelle ### Autorisations requises pour la mise à niveau des tables globales Pour effectuer une mise à niveau vers la version 2019.11.21 (actuelle), vous devez disposer d’autorisations `dynamodb:UpdateGlobalTableversion` dans toutes les régions avec des réplicas. Ces autorisations s’ajoutent aux autorisations nécessaires pour accéder à la console DynamoDB et afficher les tables. La politique IAM suivante accorde des autorisations pour mettre à niveau n’importe quelle table globale vers la version 2019.11.21 (actuelle). ``` { "version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "dynamodb:UpdateGlobalTableversion", "Resource": "*" } ] } ``` La politique IAM suivante accorde des autorisations pour mettre à niveau uniquement la table globale `Music`, avec des réplicas dans deux régions, vers la version 2019.11.21 (actuelle). ``` { "version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": "dynamodb:UpdateGlobalTableversion", "Resource": [ "arn:aws:dynamodb::123456789012:global-table/Music", "arn:aws:dynamodb:ap-southeast-1:123456789012:table/Music", "arn:aws:dynamodb:us-east-2:123456789012:table/Music" ] } ] } ``` ### À quoi s’attendre lors de la mise à niveau + Tous les réplicas de tables globales continueront à traiter le trafic de lecture et d’écriture pendant la mise à niveau. + Le processus de mise à niveau prend entre quelques minutes et plusieurs heures selon la taille de la table et le nombre de réplicas. + Au cours du processus de mise à niveau, la valeur de [TableStatus](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_TableDescription.html#DDB-Type-TableDescription-TableStatus)passera de `ACTIVE` à`UPDATING`. Vous pouvez consulter l'état de la table en appelant l'[DescribeTable](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/API_DescribeTable.html)API ou en utilisant la vue **Tables** de la console DynamoDB. + L’autoscaling n’ajustera pas les paramètres de capacité provisionnée pour une table globale pendant la mise à niveau de la table. Nous vous recommandons vivement de configurer la table en mode capacité [à la demande](capacity-mode.md#capacity-mode-on-demand) lors de la mise à niveau. + Si vous choisissez d’utiliser la capacité [provisionné](provisioned-capacity-mode.md) avec autoscaling pendant la mise à niveau, vous devez augmenter le débit minimum de lecture et d’écriture de vos politiques pour tenir compte des augmentations attendues du trafic et éviter toute limitation pendant la mise à niveau. + La métrique `ReplicationLatency` peut signaler temporairement les pics de latence ou arrêter de signaler les données métriques pendant le processus de mise à niveau. Pour plus d’informations, consultez [ReplicationLatency](metrics-dimensions.md#ReplicationLatency). + Lorsque le processus de mise à niveau est terminé, l’état de votre table revient à `ACTIVE`. ### Comportement de DynamoDB Streams avant, pendant et après la mise à niveau [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/fr_fr/amazondynamodb/latest/developerguide/V2globaltables_versions.html) ### Mise à jour vers la version 2019.11.21 (actuelle) Procédez comme suit pour mettre à jour la version des tables globales DynamoDB à l’aide de la AWS Management Console. **Pour mettre à niveau des tables globales vers la version 2019.11.21 (actuelle)** 1. [Ouvrez la console DynamoDB à la maison. https://console.aws.amazon.com/dynamodb/](https://console.aws.amazon.com/dynamodb/home) 1. Dans le volet de navigation situé sur le côté gauche de la console, choisissez **Tables**, puis sélectionnez la table globale à mettre à niveau vers la version 2019.11.21 (actuelle). 1. Choisissez l’onglet **Tables globales**. 1. Choisissez **Update version (Mettre à jour la version)**. ![\[Capture d’écran de la console illustrant le bouton Update version (Mettre à jour la version).\]](http://docs.aws.amazon.com/fr_fr/amazondynamodb/latest/developerguide/images/GlobalTables-upgrade.png) 1. Lisez et acceptez les nouvelles exigences, puis choisissez **Mettre à jour la version**. 1. Une fois le processus de mise à niveau terminé, la version des tables globales qui apparaît sur la console est la version **2019.11.21**.