GlobalTableNotFoundException

TL;DR — DescribeGlobalTable/UpdateGlobalTable vê apenas tabelas globais da versão 2017.11.29 (Legacy). Uma tabela global construída na versão 2019.11.21 (atual) — que é o que você deveria usar — é gerenciada como uma tabela regular com réplicas por meio de DescribeTable/UpdateTable, e os APIs legados a relatam como não existente. Verifique em qual versão você está antes de presumir que a tabela desapareceu.

O que significa

GlobalTableNotFoundException: The specified global table does not exist.

# what the engine actually returns, reproduced against the live DynamoDB service:
GlobalTableNotFoundException: Global table not found: Global table with name: 'no-such-global-table' does not exist.

O DynamoDB possui duas gerações de tabelas globais com duas superfícies API disjuntas. A geração herdada (2017.11.29) registra um objeto nomeado de "tabela global" no qual DescribeGlobalTable, UpdateGlobalTable e UpdateGlobalTableSettings operam. A geração atual (21/11/2019) não possui tal objeto - as réplicas residem na própria tabela - portanto, essas chamadas legadas respondem com esta exceção, mesmo que sua tabela seja replicada perfeitamente bem.

Por que isso acontece

A tabela é uma tabela global da versão atual (2019.11.21) — de longe a causa usual: o legado API simplesmente não a indexa.
Nenhuma tabela global foi criada com esse nome — a tabela existe, mas não tem réplicas ou a configuração da replicação falhou anteriormente.
Região errada ou erro de digitação no nome — o registro legado da tabela global é pesquisado pelo nome exato.

Como corrigir

Determine a versão:

aws dynamodb describe-table --table-name orders \
  --query 'Table.GlobalTableVersion'
# "2019.11.21" → use DescribeTable/UpdateTable, not the legacy APIs

Gerencie as réplicas da versão atual pelo UpdateTable:
```
aws dynamodb update-table --table-name orders \
  --replica-updates '[{"Create": {"RegionName": "eu-west-1"}}]'
```
e inspecione-os com describe-table (o campo Replicas) em vez de describe-global-table.
Em ferramentas legadas? Se você realmente opera tabelas globais 2017.11.29, verifique o nome e a região do registro — e planeje a atualização para 2019.11.21, que AWS recomenda para flexibilidade e menor custo de gravação replicada.
Criando do zero: crie a tabela e, em seguida, adicione réplicas via UpdateTable — não procure CreateGlobalTable (legado) no novo código.
Confirme a região em cada chamada. Os APIs de tabela global herdados têm escopo regional; um nome que existe em us-east-1 pode não ser resolvido em eu-west-1.

Confira o tamanho no DynoTable

DynoTable se conecta a todas as regiões a partir de uma janela - alterne com ⌘P e abra o mesmo nome de tabela em cada perfil para ver se existem réplicas e servem dados. A barra lateral da tabela mostra metadados de replicação sem chamar APIs de tabela global herdada.

Antes de adicionar uma réplica, estime o custo de gravação replicada com a calculadora de preços. Configure cada região em Configurações → Perfis e execute Testar conexão antes de executar atualizações de réplica UpdateTable. Consulte Conectar ao AWS e Instalar. Se as ferramentas legadas chamarem DescribeGlobalTable, verifique primeiro GlobalTableVersion em DescribeTable — As tabelas da versão atual retornam 2019.11.21 e devem ser gerenciadas por meio de UpdateTable. Os APIs legados não podem vê-los mesmo quando a replicação está íntegra. Atualize as ferramentas para chamar UpdateTable com ReplicaUpdates para tabelas de versão atual em vez de CreateGlobalTable.

Fontes

Versões de tabelas globais DynamoDB (verificado em 13/07/2026)
UpdateTable – Referência Amazon DynamoDB API (verificado em 13/07/2026)

Erros relacionados

Incompatibilidade de versão da tabela global — a mesma divisão de duas gerações, atingida no caminho de atualização.
ReplicaNotFoundException — a região não faz parte do grupo de replicação.
ReplicaAlreadyExistsException — a região já existe.
Aprenda: tabelas globais DynamoDB

Referências

Última verificação em 13/07/2026 em relação à documentação oficial do AWS vinculada acima.