Versiones de tablas globales de DynamoDB

Hay disponibles dos versiones de las tablas globales de DynamoDB: versión 2019.11.21 (actual) y versión 2017.11.29 (antigua). Recomendamos utilizar la versión 2019.11.21 (actual) de las tablas globales, ya que es más fácil de usar, se admite en más regiones y tiene un costo más bajo para la mayoría de las cargas de trabajo en comparación con la versión 2017.11.29 (antigua).

Determinación de la versión de una tabla global

Determinar la versión mediante la AWS CLI

Identificación de una réplica de tabla global de la versión 2019.11.21 (actual)

Para determinar si una tabla es una réplica de tabla global de la versión 2019.11.21 (actual), invoque el comando describe-table para la tabla. Si el resultado contiene el atributo de GlobalTableVersion con un valor de “2019.11.21”, la tabla es una réplica de tabla global de la versión 2019.11.21 (actual).

Un ejemplo de comando de la CLI para describe-table:

aws dynamodb describe-table \
--table-name users \
--region us-east-2

El resultado (abreviado) contiene el atributo de GlobalTableVersion con un valor de “2019.11.21”, por lo que esta tabla es una réplica de la tabla global de la versión 2019.11.21 (actual).

{
    "Table": {
        "AttributeDefinitions": [
            {
                "AttributeName": "id",
                "AttributeType": "S"
            },
            {
                "AttributeName": "name",
                "AttributeType": "S"
            }
        ],
        "TableName": "users",
        ...
        "GlobalTableVersion": "2019.11.21",
        "Replicas": [
            {
                "RegionName": "us-west-2",
                "ReplicaStatus": "ACTIVE",
            }
        ],
        ...
    }
}

Identificación de una réplica de tabla global de la versión 2017.11.29 (antigua)

La versión 2017.11.29 (antigua) de tablas globales utiliza un conjunto dedicado de comandos para la administración de tablas globales. Para determinar si una tabla es una réplica de la versión 2017.11.29 de tablas globales (antigua), invoque el comando describe-global-table para la tabla. Si recibe una respuesta exitosa, la tabla es una réplica de tabla global de la versión 2017.11.29 (antigua). Si el comando describe-global-table devuelve un error GlobalTableNotFoundException, la tabla no es una réplica de la versión 2017.11.29 (antigua).

Un comando de la CLI de ejemplo para describe-global-table:

aws dynamodb describe-global-table \
--table-name users \
--region us-east-2

El comando devuelve una respuesta exitosa, por lo que esta tabla es una réplica de tabla global de la versión 2017.11.29 (antigua).

{
    "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"
    }
}

Determinación de la versión mediante la consola de DynamoDB

Para identificar la versión de una réplica de tabla global, realice lo siguiente:

Diferencias de comportamiento entre las versiones heredada y actual

En la siguiente lista se describen las diferencias de comportamiento entre las versiones heredada y actual de las tablas globales.

Actualización a la versión actual

Permisos necesarios para actualizar las tablas globales

Para actualizar a la versión 2019.11.21 (actual), debe tener permisos dynamodb:UpdateGlobalTableversion en todas las regiones que tengan réplicas. Estos permisos se suman a los permisos necesarios para acceder a la consola de DynamoDB y ver las tablas.

La siguiente política de IAM concede permisos para actualizar cualquier tabla global a la versión 2019.11.21 (actual).

{
    "version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "dynamodb:UpdateGlobalTableversion",
            "Resource": "*"
        }
    ]
}

La siguiente política de IAM concede permisos para actualizar solo la tabla global Music, con réplicas en dos regiones, a la versión 2019.11.21 (actual).

{
    "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"
            ]
        }
    ]
}

Qué esperar durante la actualización

Comportamiento de DynamoDB Streams antes, durante y después de la actualización

Actualización a la versión 2019.11.21 (actual)

Siga estos pasos para actualizar la versión de las tablas globales de DynamoDB mediante la AWS Management Console.