Lorixen.
DE

Datenbank umbauen, ohne dass die Web-App ausfällt

Kurz gesagt: Eine Web-App wächst, und irgendwann muss die Datenbank mit: eine neue Spalte, ein umbenanntes Feld, ein zusätzlicher Index. Wer solche Änderungen einfach während des laufenden Betriebs ausführt, riskiert gesperrte Tabellen, hängende Seiten und Fehlermeldungen bei der Kundschaft. Der bewährte Weg heißt „erweitern, umstellen, aufräumen“: Sie fügen zuerst Neues hinzu, ohne Altes zu entfernen, stellen den Code schrittweise um und löschen das Alte erst, wenn nichts mehr darauf zugreift. Dazu kommen ein paar Datenbankfunktionen, die Sperren kurz halten.

Warum Schemaänderungen den Betrieb stören

Wenn Sie eine Tabelle ändern, braucht die Datenbank eine Sperre, damit niemand gleichzeitig in eine halb umgebaute Struktur schreibt. Die PostgreSQL-Dokumentation zu ALTER TABLE hält fest, dass die meisten Varianten dieses Befehls eine ACCESS-EXCLUSIVE-Sperre anfordern, sofern nicht ausdrücklich anders angegeben. Diese Sperre blockiert auch Lesezugriffe. Bei einer kleinen Tabelle dauert das Millisekunden, bei einer Tabelle mit Millionen Bestellungen oder Protokolleinträgen kann es Minuten dauern, und in dieser Zeit wartet jede Anfrage, die diese Tabelle braucht.

Dazu kommt ein zweites Problem: Während des Deployments laufen oft kurz alte und neue Versionen Ihres Codes gleichzeitig. Wenn der neue Code eine Spalte erwartet, die es noch nicht gibt, oder der alte Code eine Spalte sucht, die gerade gelöscht wurde, gibt es Fehler.

Das Prinzip: erweitern, umstellen, aufräumen

Statt eine Änderung in einem Schritt zu erledigen, teilen Sie sie in mehrere kleine, jeweils sichere Schritte auf.

  1. Erweitern: Neue Spalten, Tabellen oder Indizes kommen dazu. Nichts Bestehendes wird verändert oder gelöscht. Alter und neuer Code funktionieren beide.
  2. Umstellen: Der Code schreibt in die neue Struktur, später liest er auch daraus. Bestehende Daten werden in Ruhe übertragen.
  3. Aufräumen: Wenn kein Code mehr die alte Struktur verwendet, wird sie entfernt.

Jeder Schritt ist ein eigenes Deployment. Das dauert länger als eine einzelne Änderung, aber jeder Schritt lässt sich einzeln prüfen und notfalls zurücknehmen.

Beispiel: Eine Spalte umbenennen

Angenommen, Ihre Tabelle mit Aufträgen hat eine Spalte „telefon“, die künftig „telefon_kunde“ heißen soll, weil eine zweite Telefonnummer dazukommt. Ein direktes Umbenennen würde jeden noch laufenden alten Code sofort brechen. Der sichere Ablauf:

  • Neue Spalte „telefon_kunde“ hinzufügen.
  • Code anpassen, sodass er bei jedem Speichern in beide Spalten schreibt.
  • Bestehende Werte in kleinen Portionen von der alten in die neue Spalte kopieren.
  • Code so ändern, dass er nur noch aus der neuen Spalte liest.
  • Schreiben in die alte Spalte beenden.
  • Nach einer Beobachtungszeit die alte Spalte löschen.

Das wirkt umständlich, verhindert aber genau den Moment, in dem Kundschaft eine Fehlerseite sieht.

Neue Spalten mit Standardwert

Früher war eine neue Spalte mit Standardwert bei großen Tabellen gefürchtet, weil jede Zeile neu geschrieben wurde. Die PostgreSQL-Dokumentation beschreibt, dass bei ADD COLUMN mit einem nicht volatilen Standardwert der Wert einmal berechnet und in den Metadaten der Tabelle abgelegt wird. Bestehende Zeilen liefern ihn beim Lesen, ohne dass die Tabelle sofort umgeschrieben wird. Ein fester Wert wie „offen“ ist damit unkritisch. Ein volatiler Wert, etwa ein Zufallswert pro Zeile, führt dagegen weiterhin zu einem Umschreiben der Tabelle.

Bei anderen Datenbanksystemen gelten eigene Regeln. Lesen Sie für MySQL, MariaDB oder einen Cloud-Dienst die jeweilige Dokumentation, bevor Sie sich auf dieses Verhalten verlassen.

Indizes ohne Schreibsperre anlegen

Ein neuer Index beschleunigt Abfragen, aber sein Aufbau kann den Betrieb blockieren. Laut PostgreSQL-Dokumentation sperrt ein normaler Indexaufbau Schreibzugriffe auf die Tabelle, bis er fertig ist, Lesezugriffe bleiben möglich. Mit der Option CONCURRENTLY baut PostgreSQL den Index, ohne Einfügen, Ändern oder Löschen zu blockieren. Die Dokumentation weist auf mehrere Einschränkungen hin: Der Aufbau dauert länger, und wenn er abbricht, bleibt ein ungültiger Index zurück, den Sie entfernen und neu anlegen müssen. Planen Sie solche Indizes daher außerhalb der Spitzenzeiten und prüfen Sie danach, ob der Index gültig ist.

Einschränkungen nachträglich prüfen

Wollen Sie etwa erzwingen, dass jeder Auftrag einer gültigen Kundin oder einem gültigen Kunden zugeordnet ist, muss die Datenbank alle bestehenden Zeilen prüfen. ALTER TABLE erlaubt in PostgreSQL, eine Einschränkung mit dem Zusatz NOT VALID hinzuzufügen. Sie gilt dann sofort für neue Zeilen, die Prüfung der alten erfolgt später separat mit VALIDATE CONSTRAINT. So verteilen Sie die Last und halten die Sperre bei der eigentlichen Änderung kurz.

Daten in Portionen übertragen

Wenn Sie viele Zeilen ändern müssen, etwa beim Befüllen einer neuen Spalte, tun Sie das nicht in einer einzigen großen Abfrage. Eine riesige Änderung hält Sperren lange, erzeugt viel Last und lässt sich schwer abbrechen. Besser ist ein kleines Skript, das jeweils einige tausend Zeilen bearbeitet, kurz pausiert und protokolliert, wie weit es gekommen ist. Bricht es ab, setzen Sie an der letzten Stelle fort.

Sperren begrenzen

Selbst eine eigentlich schnelle Änderung kann hängen, wenn eine lange laufende Abfrage die Tabelle gerade benutzt. Die Änderung wartet dann auf die Sperre, und alle nachfolgenden Anfragen warten hinter ihr. Setzen Sie deshalb für Migrationen eine kurze Wartezeit auf Sperren. Bekommt die Änderung die Sperre nicht schnell genug, bricht sie ab, und Sie versuchen es später erneut, statt den gesamten Betrieb anzuhalten.

Beispiel aus der Praxis

Ein Wiener Ersatzteilhändler betreibt ein Bestellportal für Werkstätten und möchte Lieferadressen von der Kundentabelle in eine eigene Tabelle auslagern, weil viele Werkstätten mehrere Standorte haben (Beispiel zur Veranschaulichung). Das Team legt zuerst die neue Tabelle an, lässt den Code neue Adressen in beide Strukturen schreiben, überträgt Altdaten nachts in Portionen und stellt danach das Lesen um. Die alte Spalte bleibt zwei Wochen bestehen und wird erst gelöscht, als die Protokolle zeigen, dass niemand mehr darauf zugreift.

Typische Fehler

  • Umbenennen oder Löschen im selben Deployment wie die Codeänderung.
  • Große Tabellen in einer einzigen Abfrage umbauen.
  • Indizes zur Hauptgeschäftszeit ohne CONCURRENTLY anlegen.
  • Keine Wartezeit auf Sperren, sodass eine Migration den Betrieb blockiert.
  • Die Aufräumphase vergessen, sodass doppelte Spalten jahrelang bleiben.

Häufige Fragen

Brauche ich das auch für eine kleine App?

Bei wenigen tausend Zeilen sind die meisten Änderungen schnell. Das Prinzip „erst hinzufügen, später löschen“ lohnt sich trotzdem, weil es Fehler beim Deployment verhindert.

Kann ich nicht einfach ein Wartungsfenster ansetzen?

Das ist eine Alternative, wenn Ihre Kundschaft nachts nicht arbeitet. Bei Portalen, die rund um die Uhr genutzt werden, ist der schrittweise Weg kundenfreundlicher.

Wer sollte die Migrationen prüfen?

Am besten jemand, der die Datenbank kennt, vor jedem Deployment, mit einem Test auf einer Kopie, die ähnlich groß ist wie die Live-Datenbank.

Wenn in Ihrer Web-App eine größere Datenbankänderung ansteht und kein Kunde etwas davon merken soll, planen wir die Schritte gern gemeinsam: Datenbankumbau besprechen.

Quellen

WhatsAppTermin buchen