GlobalTableNotFoundException

TL;DR — DescribeGlobalTable / UpdateGlobalTable visualizza solo le tabelle globali della versione 2017.11.29 (Legacy). Una tabella globale creata sulla versione 2019.11.21 (Current), che è quella che dovresti utilizzare, viene gestita come una tabella regolare con repliche tramite "DescribeTable" / "UpdateTable" e le API legacy la segnalano come non esistente. Controlla quale versione stai utilizzando prima di dare per scontato che la tabella sia sparito.

Cosa 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.

DynamoDB ha due generazioni di tabelle globali con due superfici API disgiunte. La generazione legacy (29.11.2017) registra un oggetto "tabella globale" denominato su cui operano DescribeGlobalTable, UpdateGlobalTable e UpdateGlobalTableSettings. L'attuale generazione (21.11.2019) non ha un oggetto di questo tipo: le repliche risiedono sulla tabella stesso, quindi quelle chiamate legacy rispondono con questa eccezione anche se la tua tabella si replica perfettamente.

Perché succede

La tabella è una tabella globale della versione corrente (21.11.2019) — di gran lunga la solita causa: l'eredità API semplicemente non la indicizza.
Nessuna tabella globale è mai stata creata con quel nome: la tabella esiste ma non ha repliche oppure la configurazione della replica non è riuscita in precedenza.
Regione errata o errore di battitura del nome: la registrazione della tabella globale legacy viene ricercata in base al nome esatto.

Come risolverlo

Determina la versione:

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

Gestisci le repliche della versione corrente tramite "UpdateTable":

aws dynamodb update-table --table-name orders \
  --replica-updates '[{"Create": {"RegionName": "eu-west-1"}}]'

Su strumenti legacy? Se gestisci effettivamente tabelle globali del 29.11.2017, verifica il nome e la regione della registrazione e pianifica l'aggiornamento al 21.11.2019, che AWS consiglia per flessibilità e minori costi di scrittura replicata.
Creazione da zero: crea la tabella, quindi aggiungi le repliche tramite "UpdateTable" — non utilizzare "CreateGlobalTable" (legacy) nel nuovo codice.
Conferma la regione a ogni chiamata. Le API legacy della tabella globale hanno un ambito regionale; un nome che esiste in "us-east-1" potrebbe non risolversi da "eu-west-1".

Controlla la dimensione in DynoTable

DynoTable si connette a ogni regione da una finestra: cambia con ⌘P e apri lo stesso nome di tabella in ciascun profilo per vedere se esistono repliche e forniscono dati. La barra laterale della tabella mostra i metadati di replica senza chiamare le API di tabella globale legacy.

Prima di aggiungere una replica, stima il costo di scrittura replicato con il calcolatore dei prezzi. Configura ciascuna regione in Impostazioni → Profili ed esegui Test connessione prima di eseguire gli aggiornamenti della replica UpdateTable. Consulta Connetti a AWS e Installa. Se gli strumenti legacy chiamano "DescribeGlobalTable", controlla prima "GlobalTableVersion" su "DescribeTable": le tabelle della versione corrente restituiscono "2019.11.21" e devono essere gestite tramite "UpdateTable". Le API legacy non possono vederli anche quando la replica è integra. Aggiorna gli strumenti per chiamare "UpdateTable" con "ReplicaUpdates" per le tabelle della versione corrente invece di "CreateGlobalTable".

Fonti

DynamoDB versioni delle tabelle globali (verificato il 13-07-2026)
UpdateTable - Riferimento Amazon DynamoDB API (verificato il 13-07-2026)

Errori correlati

Mancata corrispondenza della versione globale della tabella: la stessa divisione di due generazioni, colpita dal percorso di aggiornamento.
ReplicaNotFoundException: la regione non fa parte del gruppo di replica.
ReplicaAlreadyExistsException: la regione lo è già.
Impara: DynamoDB tabelle globali

Riferimenti

Ultima verifica il 13-07-2026 rispetto alla documentazione ufficiale del AWS collegata sopra.