GlobalTableNotFoundException

TL;DR — DescribeGlobalTable / UpdateGlobalTable sehen ausschließlich Global Tables der Version 2017.11.29 (Legacy). Eine Global Table auf Version 2019.11.21 (Current) — die du nutzen solltest — wird als normale Tabelle mit Replikaten über DescribeTable / UpdateTable verwaltet, und die Legacy-APIs melden sie als nicht existent. Prüfe, auf welcher Version du bist, bevor du die Tabelle für verschwunden hältst.

Was es bedeutet

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 hat zwei Global-Table-Generationen mit zwei disjunkten API-Oberflächen. Die Legacy-Generation (2017.11.29) registriert ein benanntes "Global Table"-Objekt, auf dem DescribeGlobalTable, UpdateGlobalTable und UpdateGlobalTableSettings operieren. Die Current-Generation (2019.11.21) hat kein solches Objekt — Replikate leben auf der Tabelle selbst —, also antworten diese Legacy-Aufrufe mit dieser Exception, obwohl deine Tabelle einwandfrei repliziert.

Warum es passiert

Die Tabelle ist eine Current-Version-Global-Table (2019.11.21) — mit Abstand die übliche Ursache: die Legacy-API indexiert sie schlicht nicht.
Unter diesem Namen wurde nie eine Global Table erstellt — die Tabelle existiert, hat aber keine Replikate, oder das Replikations-Setup ist zuvor fehlgeschlagen.
Falsche Region oder ein Tippfehler im Namen — die Legacy-Global-Table-Registrierung wird per exaktem Namen nachgeschlagen.

So behebst du es

Determine the version:

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

Verwalte Replikate der Current-Version über UpdateTable:
```
aws dynamodb update-table --table-name orders \
  --replica-updates '[{"Create": {"RegionName": "eu-west-1"}}]'
```
und sieh sie dir mit describe-table an (dem Feld Replicas) statt mit describe-global-table.
Auf Legacy-Tooling unterwegs? Wenn du wirklich Global Tables der Version 2017.11.29 betreibst, prüf Name und Region der Registrierung — und plan den Umstieg auf 2019.11.21, den AWS wegen Flexibilität und günstigerer replizierter Writes empfiehlt.
Von Grund auf neu: Leg die Tabelle an und füg dann Replikate per UpdateTable hinzu — greif in neuem Code nicht zu CreateGlobalTable (Legacy).
Bestätige bei jedem Aufruf die Region. Legacy-Global-Table-APIs sind regionsgebunden; ein Name, der in us-east-1 existiert, löst aus eu-west-1 womöglich nicht auf.

Größe in DynoTable prüfen

DynoTable verbindet sich aus einem Fenster mit jeder Region — wechsle mit ⌘P und öffne denselben Tabellennamen in jedem Profil, um zu sehen, ob Replikate existieren und Daten liefern. Die Tabellen-Seitenleiste zeigt Replikations-Metadaten, ohne Legacy-Global-Table-APIs aufzurufen.

Before adding a replica, estimate replicated write cost with the Pricing-Rechner. Configure each Region under Einstellungen → Profile and run Verbindung testen bevor du run UpdateTable replica updates. Siehe Mit AWS verbinden und Installation. Wenn legacy tooling calls DescribeGlobalTable, check GlobalTableVersion on DescribeTable first — Current-version tables return 2019.11.21 and must be managed through UpdateTable. Legacy APIs cannot see them even when replication is healthy. Upgrade tooling to call UpdateTable with ReplicaUpdates for Current-version tables instead of CreateGlobalTable.

Quellen

DynamoDB global tables versions (verifiziert 2026-07-13)
UpdateTable — Amazon DynamoDB API Reference (verifiziert 2026-07-13)

Referenzen

Zuletzt verifiziert am 2026-07-13 gegen die offizielle, oben verlinkte AWS-Dokumentation.