Vad är databasmigreringar, och varför ska de vara versionerade?

Olle Krantz

Databasmigreringar är små, namngivna och daterade skript som ändrar databasen i ordning, så att utvecklingen går att läsa, återskapa och granska. Sex regler gäller: en ändring per skript, kör dem i ordning och spara dem, ändra aldrig ett skript som redan körts, testa på en kopia, gör farliga ändringar i flera steg och ha en plan för att backa. Det avgör om en ny utvecklare kan ta över.

Databasen ändras under tiden

Ett system som används förändras: nya fält, nya tabeller, ändrade regler. Databasen ska ändras med, utan att data går förlorad och utan att någon behöver minnas vad som gjordes för hand i produktion. Lösningen heter migreringar: varje ändring av databasen skrivs som ett litet, namngivet och daterat skript som körs i ordning.

Varför de ska vara versionerade

Utan migreringar ändras databasen med handpåläggning. Då gäller:

  • Ingen vet exakt hur produktionsdatabasen ser ut, eller varför.
  • Test- och produktionsmiljöer glider isär.
  • En ny utvecklare kan inte återskapa databasen, och en återställning efter en olycka blir ett gissningsarbete.
  • Ändringar kan inte granskas före de görs.

Med versionerade migreringar är databasens utveckling en historia som går att läsa. Det är också skälet till att det är bra att fråga efter dem när någon ska lämna över ett system, se Kan vi äga ett eget system utan en egen utvecklare?.

Sex regler för bra migreringar

1. En ändring, ett skript

Små steg går att granska och går lättare att rätta. Ett skript som gör tio saker är svårt att förstå och svårt att backa.

2. Skripten körs i ordning och sparas

De ligger tillsammans med koden, och en uppgift om vilka som körts finns i databasen. En ny miljö byggs upp genom att köra dem från början.

3. Ändra aldrig ett skript som redan körts

Behöver något rättas, skriv ett nytt skript. Annars skiljer sig miljöerna åt utan att någon vet om det.

4. Testa på en kopia först

Kör migreringen mot en kopia av produktionsdata. Det som fungerar på tomma testdata kan gå fel mot verklig data, till exempel när en kolumn plötsligt ska vara obligatorisk men hundra rader saknar värde.

5. Gör farliga ändringar i flera steg

Att byta namn på en kolumn eller ta bort den är farligt, eftersom kod som körs just då kan förvänta sig den gamla. Lägg först till den nya, flytta datan, byt koden och ta bort den gamla i en senare migrering.

6. Ha en plan för att backa

För varje migrering: vad gör vi om det går fel? Ibland är svaret ett omvänt skript, ibland att återställa från en kopia. Se Backup och återställning.

Särskilt viktigt med regler och behörigheter

Regler i databasen, så kallad radnivåsäkerhet, ändras också genom migreringar. En ny tabell ska inte skapas utan en genomtänkt regel. Gör det till en del av granskningen.

Frågor att ställa

  • Finns alla databasändringar som skript i koden?
  • Kan en ny miljö byggas upp från noll med dem?
  • Hur testas en ändring innan den når produktion?
  • Vem godkänner en migrering?

Se även Vad är Postgres och Supabase? för bakgrunden.

Vill ni veta hur det ser ut i ett system ni har? Hör av er.