Versões de tabelas globais do DynamoDB

Há duas versões disponíveis das tabelas globais do DynamoDB: tabelas globais versão 2019.11.21 (atual) e tabelas globais versão 2017.11.29 (legada). Recomendamos usar a versão 2019.11.21 (atual) das tabelas globais, pois ela é mais fácil de usar, com suporte em mais regiões e oferece menor custo para a maioria das workloads em comparação com a versão 2017.11.29 (legada).

Determinar a versão de uma tabela global

Determinar a versão usando a AWS CLI

Identificar uma réplica de tabela global da versão 2019.11.21 (atual)

Para determinar se uma tabela é uma réplica da versão 2019.11.21 (atual) das tabelas globais, invoque o comando describe-table para a tabela. Se a saída contiver o atributo GlobalTableVersion com o valor "2019.11.21", a tabela é uma réplica da tabela global da versão 2019.11.21 (atual).

Um exemplo de comando CLI para describe-table:

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

A saída (abreviada) contém o atributo GlobalTableVersion com o valor "2019.11.21", então essa tabela é uma réplica da tabela global da versão 2019.11.21 (atual).

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

Identificar uma réplica de tabela global da versão 2017.11.29 (legada)

As tabelas globais versão 2017.11.29 (legada) usam um conjunto dedicado de comandos para gerenciamento global de tabelas. Para determinar se uma tabela é uma réplica da versão 2017.11.21 (legada) das tabelas globais, invoque o comando describe-global-table para a tabela. Se você receber uma resposta bem-sucedida, a tabela será uma réplica de tabela global da versão 2017.11.29 (legada). Se o comando describe-global-table retornar um erro GlobalTableNotFoundException, a tabela não será uma réplica da versão 2017.11.29 (legada).

Um exemplo de comando CLI para describe-global-table:

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

O comando retorna uma resposta bem-sucedida, então essa tabela será uma réplica de tabela global da versão 2017.11.29 (legada).

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

Determinar a versão usando o DynamoDB Console

Para identificar a versão de uma réplica de tabela global, faça o seguinte:

Diferenças de comportamento entre as versões herdada e atual

A lista a seguir descreve as diferenças de comportamento entre as versões herdada e atual das tabelas globais.

Atualizar para a versão atual

Permissões obrigatórias para a atualização de tabelas globais

Para realizar a atualização para a versão 2019.11.21 (atual), é necessário ter permissões dynamodb:UpdateGlobalTableversion em todas as regiões com réplicas. Essas permissões se somam às permissões necessárias para acessar o console do DynamoDB e visualizar tabelas.

A política do IAM a seguir concede permissões para atualizar qualquer tabela global para a versão 2019.11.21 (atual).

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

A política do IAM a seguir concede permissões para atualizar apenas a tabela global Music, com réplicas em duas regiões, para a versão 2019.11.21 (atual).

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

O que esperar durante a atualização

Comportamento do DynamoDB Streams antes, durante e depois da atualização

Atualizar para a versão 2019.11.21 (atual)

Siga estas etapas para atualizar a versão das tabelas globais do DynamoDB usando o AWS Management Console.