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étermination de la version à l’aide de l’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 :

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.

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

Comportement de DynamoDB Streams avant, pendant et après la mise à niveau

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.