...
Eroare AWS · RDS: baze de date gestionate

An error occurred (DBInstanceAlreadyExists) when calling the CreateDBInstance operation: DB instance already exists

Pe scurt

În regiune există deja o bază RDS cu acest identificator. Dacă e baza ta, folosește-o (în scripturi, creeaz-o doar dacă describe-db-instances nu o găsește); dacă vrei alta, alege alt --db-instance-identifier.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Identificatorul unei baze RDS (--db-instance-identifier) e unic în cont și regiune și face parte din endpoint (catalog.abc123.eu-central-1.rds.amazonaws.com). Când îl folosești din nou, RDS refuză crearea.

Apare de obicei:

  • la a doua rulare a unui script de creare;
  • după o ștergere: baza e încă în starea deleting câteva minute, iar numele nu e liber;
  • când restaurezi un snapshot cu același nume ca baza care încă există (restore-db-instance-from-db-snapshot); acolo alegi un nume nou, de exemplu catalog-restaurat.

Identificatorul nu ține cont de majuscule: Catalog și catalog sunt aceeași bază. Baza existentă nu a fost atinsă de cererea refuzată.

De ce apare: cauzele frecvente

1Scriptul creează baza la fiecare rulare

Greșit
BASH
set -e
aws rds create-db-instance --db-instance-identifier catalog ...
aws rds wait db-instance-available --db-instance-identifier catalog
Corect
BASH
set -e
if ! aws rds describe-db-instances --db-instance-identifier catalog > /dev/null 2>&1; then
  aws rds create-db-instance --db-instance-identifier catalog ...
fi
aws rds wait db-instance-available --db-instance-identifier catalog

Baza se creează doar dacă lipsește; altfel scriptul doar așteaptă să fie gata.

2Restaurezi peste o bază care există

Greșit
BASH
aws rds restore-db-instance-from-db-snapshot --db-instance-identifier catalog \
  --db-snapshot-identifier catalog-inainte-migrare
Corect
BASH
aws rds restore-db-instance-from-db-snapshot --db-instance-identifier catalog-restaurat \
  --db-snapshot-identifier catalog-inainte-migrare

Restaurarea creează mereu o bază nouă, cu un nume nou.

3Baza veche încă se șterge

Greșit
BASH
aws rds delete-db-instance --db-instance-identifier catalog --skip-final-snapshot
aws rds create-db-instance --db-instance-identifier catalog ...
Corect
BASH
aws rds delete-db-instance --db-instance-identifier catalog --skip-final-snapshot
aws rds wait db-instance-deleted --db-instance-identifier catalog
aws rds create-db-instance --db-instance-identifier catalog ...

Numele se eliberează abia după ștergerea completă.

Repară tu

Repară eroarea, direct în pagină

Scriptul ~/baza.sh a creat baza catalog la prima rulare, dar acum dă DBInstanceAlreadyExists și se oprește înainte să aștepte baza. Repară scriptul ca să creeze baza doar dacă nu există și apoi să aștepte să fie available. Rulează-l.

Indiciu

Pune create-db-instance într-un if ! aws rds describe-db-instances --db-instance-identifier catalog > /dev/null 2>&1; then ... fi.

Alte forme ale mesajului

  • An error occurred (DBInstanceAlreadyExists) when calling the RestoreDBInstanceFromDBSnapshot operation: DB instance already exists
  • An error occurred (DBSnapshotAlreadyExists) when calling the CreateDBSnapshot operation: Cannot create the snapshot because a snapshot with the identifier catalog-inainte-migrare already exists.

Cum o eviți pe viitor

  • Scrie scripturile de creare idempotent: verifică cu describe-db-instances înainte de create-db-instance.
  • Pune în identificator mediul (catalog-prod, catalog-test), ca să nu se ciocnească bazele din medii diferite.
  • După ștergere, folosește aws rds wait db-instance-deleted înainte să refolosești numele.
  • Nu refolosi numele unei baze șterse până nu ai terminat de verificat snapshot-ul ei final.

Întrebări frecvente

Pot redenumi o bază existentă?

Da: aws rds modify-db-instance --db-instance-identifier catalog --new-db-instance-identifier catalog-vechi --apply-immediately. Atenție: se schimbă și endpoint-ul.

S-a schimbat ceva la baza existentă?

Nu. Cererea de creare a fost refuzată, iar baza existentă a rămas neschimbată.

Erori înrudite

← Toate erorile AWS

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață AWS de la zero, cu exerciții la fiecare lecție

Curs Cloud: AWS fundamentals: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.