DynamoDB: Table already exists

TL;DR — Die Operation will ihre Zieltabelle anlegen, und der Name ist in diesem Konto + dieser Region schon vergeben. Restores (RestoreTableFromBackup / RestoreTableToPointInTime) werfen TableAlreadyExistsException; CreateTable und ImportTable melden dieselbe Situation als ResourceInUseException. Wähl einen neuen Zielnamen — Restores und Importe können nie in eine bestehende Tabelle schreiben.

Was es bedeutet

TableAlreadyExistsException: A target table with the specified name already exists
ResourceInUseException: Table already exists: my-table

# what the engine actually returns, reproduced against DynamoDB Local:
ResourceInUseException: Cannot create preexisting table

Restore- und Import-Operationen erstellen immer eine brandneue Tabelle — sie können nicht in eine aktive Tabelle mergen oder sie überschreiben. Wenn sich der Zielname auf irgendeine existierende Tabelle (in welchem Zustand auch immer) im selben Konto und derselben Region auflöst, scheitert der Request von vornherein. Welche Exception du siehst, hängt von der API ab: Die Restore-Familie hat ihre eigene TableAlreadyExistsException, während CreateTable und ImportTable die generische ResourceInUseException zutage fördern.

Warum es passiert

Ein Backup über den Originalnamen wiederherstellen — der natürliche Instinkt („meine Tabelle zurücklegen") kollidiert mit der noch existierenden Tabelle.
Einen Import oder ein IaC-Deployment erneut ausführen — ein wiederholtes ImportTable oder ein CloudFormation-/Terraform-/CDK-Stack, der versucht, eine Tabelle zu erstellen, die außerhalb des Stack-States bereits existiert.
Ein Create-dann-Retry-Wettlauf — das erste CreateTable war erfolgreich (oder ist noch CREATING), und der Retry findet den Namen vergeben.
Umgebungskollision — zwei Stages/Umgebungen teilen sich ein Konto und beide wollen den nicht präfixierten Namen.

So behebst du es

Stelle unter einem neuen Namen wieder her, dann schalte um — stelle als my-table-restored wieder her, verifiziere die Daten, richte die Anwendung neu aus (oder lösche die alte Tabelle und stelle erneut unter dem Originalnamen wieder her, sobald sie weg ist):
```
aws dynamodb restore-table-from-backup \
  --target-table-name my-table-restored \
  --backup-arn arn:aws:dynamodb:...:table/my-table/backup/...
```
Wenn du die Tabelle ersetzen willst, lösche zuerst die existierende und warte, bis die Löschung abgeschlossen ist — der Name bleibt vergeben, solange die Tabelle im Zustand DELETING ist (ein dann versuchter Restore scheitert mit TableInUseException; siehe ResourceInUseException für die CreateTable-Seite).
Für Imports wähle einen unbenutzten Zielnamen — ImportTable erstellt nur neue Tabellen. Um Daten in eine existierende Tabelle zu laden, schreibe sie stattdessen mit BatchWriteItem/PutItem.
Für IaC-Retries importiere die existierende Tabelle in den State des Stacks (oder benenne um), statt gegen das Erstellen zu kämpfen.
Prüfe, was tatsächlich existiert — aws dynamodb list-tables in derselben Region/im selben Konto klärt, ob der Name wirklich frei ist.

Eine wiederhergestellte Tabelle vor dem Umschalten zu verifizieren, ist der sichere Schritt, den Leute überspringen — die DynoTable-Desktop-App stellt die wiederhergestellte und die Original-Tabelle nebeneinander, sodass du das Schema diffen und Items stichprobenartig prüfen kannst. Und wenn du schätzt, was die wiederhergestellte Tabelle im Betrieb kosten wird, deckt der DynamoDB-Preisrechner beide Kapazitätsmodi ab.

In DynoTable messen

Öffne vor dem Umschalten sowohl die Original- als auch die wiederhergestellte Tabelle in DynoTable — wechsle mit ⌘K und prüf Items stichprobenartig nebeneinander. Mit Staging (⌘S) testest du Writes gegen die wiederhergestellte Kopie, ohne den Produktions-Traffic anzufassen.

Size the restored table with the Pricing-Rechner. Switch accounts/Regions with ⌘P; Verbindung testen on Einstellungen → Profile. Siehe Mit AWS verbinden und Installation.

Quellen

RestoreTableFromBackup — Amazon DynamoDB API Reference (verifiziert 2026-07-13)
CreateTable — Amazon DynamoDB API Reference (verifiziert 2026-07-13)

Referenzen

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