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 : les tables globales version 2019.11.21 (actuelle) et les tables globales version 2017.11.29 (ancienne version). Nous recommandons d'utiliser la version 2019.11.21 (actuelle) de Global Tables, 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 par rapport à la version 2017.11.29 (ancienne).

Déterminer la version d'une table globale

Déterminer la version à l'aide du AWS CLI

Identification d'une réplique de table globale de la version 2019.11.21 (actuelle)

Pour déterminer si une table est une réplique de tables globales version 2019.11.21 (Current), appelez la describe-table commande correspondante. Si la sortie contient l'GlobalTableVersionattribut dont la valeur est « 2019.11.21 », la table est une réplique de table globale de la version 2019.11.21 (Current).

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'GlobalTableVersionattribut dont la valeur est « 2019.11.21 ». Cette table est donc une réplique de table globale de la version 2019.11.21 (Current).

{
    "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'une réplique de table globale de la version 2017.11.29 (Legacy)

La version 2017.11.29 (Legacy) des tables globales utilise un ensemble de commandes dédié pour la gestion globale des tables. Pour déterminer si une table est une réplique de tables globales version 2017.11.29 (Legacy), appelez la describe-global-table commande correspondante. Si vous recevez une réponse positive, la table est une réplique de table globale de la version 2017.11.29 (Legacy). Si la describe-global-table commande renvoie une GlobalTableNotFoundException erreur, la table n'est pas une réplique de la version 2017.11.29 (Legacy).

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 réussie. Cette table est donc une réplique de table globale de la version 2017.11.29 (Legacy).

{
    "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'une réplique de table globale, effectuez les opérations suivantes :

Différences de comportement entre les anciennes versions 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 passer à la version 2019.11.21 (actuelle), vous devez disposer d'dynamodb:UpdateGlobalTableversionautorisations dans toutes les régions dotées de répliques. Ces autorisations sont requises en plus des autorisations nécessaires pour accéder à la console DynamoDB et consulter les tables.

La politique IAM suivante autorise la mise à niveau de 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 l'autorisation de mettre à niveau uniquement la table Music globale contenant des répliques 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 à niveau vers la version 2019.11.21 (actuelle)

Procédez comme suit pour mettre à niveau votre version des tables globales DynamoDB à l'aide du. AWS Management Console