Temporale tabeller: Automatisk historikk på radene

«Hva sto det i kundens adresse 1. mars?» «Hvem endret prisen, og hva var den før?» Spørsmål som dette pleide å kreve egne historikktabeller og triggere. Siden SQL Server 2016 kan databasen gjøre jobben selv: en temporal tabell (system-versioned temporal table) tar automatisk vare på alle tidligere versjoner av hver rad, og du kan spørre mot tabellen slik den så ut på et hvilket som helst tidspunkt. Denne guiden viser oppsett, spørringer, opprydding og fallgruvene – inkludert hva historikk betyr for personvern.

Kort fortalt
  • En temporal tabell har to tidskolonner og en tilhørende historikktabell. SQL Server fyller begge automatisk.
  • FOR SYSTEM_TIME AS OF '…' gir deg tabellen slik den var på et tidspunkt.
  • Tidspunktene er i UTC.
  • Sett HISTORY_RETENTION_PERIOD, ellers vokser historikken for alltid.
  • Historikk er også personopplysninger: sletting etter GDPR krever et eget opplegg.

Slik fungerer det

Tabellen får to datetime2-kolonner som angir når radversjonen var gyldig. Ved UPDATE eller DELETE flytter SQL Server den gamle versjonen til historikktabellen og setter sluttidspunktet. Den nåværende tabellen inneholder bare gjeldende rader, så vanlige spørringer påvirkes ikke.

HandlingNåværende tabellHistorikktabell
INSERTNy rad, GyldigFra = nå, GyldigTil = 9999-12-31Ingenting
UPDATERaden oppdateres, GyldigFra = nåGammel versjon, GyldigTil = nå
DELETERaden fjernesSiste versjon, GyldigTil = nå

Lag en temporal tabell

CREATE TABLE dbo.Kunde (
    KundeId   int           NOT NULL PRIMARY KEY,
    Navn      nvarchar(100) NOT NULL,
    Adresse   nvarchar(200) NULL,
    Kredittgrense decimal(12,2) NOT NULL,
    GyldigFra datetime2 GENERATED ALWAYS AS ROW START HIDDEN NOT NULL,
    GyldigTil datetime2 GENERATED ALWAYS AS ROW END   HIDDEN NOT NULL,
    PERIOD FOR SYSTEM_TIME (GyldigFra, GyldigTil)
)
WITH (SYSTEM_VERSIONING = ON (
    HISTORY_TABLE = dbo.KundeHistorikk,
    HISTORY_RETENTION_PERIOD = 2 YEARS
));

HIDDEN gjør at tidskolonnene ikke kommer med i SELECT * og ikke må oppgis i INSERT. Det gjør det enklere å innføre temporale tabeller uten å endre eksisterende applikasjonskode. Navngi alltid historikktabellen selv – ellers får den et automatisk navn som MSSQL_TemporalHistoryFor_565577053.

Gjør en eksisterende tabell temporal

ALTER TABLE dbo.Produkt ADD
    GyldigFra datetime2 GENERATED ALWAYS AS ROW START HIDDEN NOT NULL
        CONSTRAINT DF_Produkt_GyldigFra DEFAULT SYSUTCDATETIME(),
    GyldigTil datetime2 GENERATED ALWAYS AS ROW END HIDDEN NOT NULL
        CONSTRAINT DF_Produkt_GyldigTil DEFAULT CONVERT(datetime2, '9999-12-31 23:59:59.9999999'),
    PERIOD FOR SYSTEM_TIME (GyldigFra, GyldigTil);

ALTER TABLE dbo.Produkt
SET (SYSTEM_VERSIONING = ON (HISTORY_TABLE = dbo.ProduktHistorikk,
                             HISTORY_RETENTION_PERIOD = 1 YEAR));

På en stor tabell skriver dette til hver rad. Gjør det i et vedlikeholdsvindu, og følg med på transaksjonsloggen.

Spør mot historikken

-- Tabellen slik den var 1. mars kl. 12 norsk tid (tidspunktet må være UTC)
DECLARE @Tidspunkt datetime2 =
    CAST('2026-03-01 12:00' AS datetime2) AT TIME ZONE 'W. Europe Standard Time' AT TIME ZONE 'UTC';

SELECT KundeId, Navn, Adresse, Kredittgrense
FROM dbo.Kunde FOR SYSTEM_TIME AS OF @Tidspunkt;

-- Alle versjoner av én kunde, med norsk tid
SELECT Navn, Adresse, Kredittgrense,
       GyldigFra AT TIME ZONE 'UTC' AT TIME ZONE 'W. Europe Standard Time' AS Fra,
       GyldigTil AT TIME ZONE 'UTC' AT TIME ZONE 'W. Europe Standard Time' AS Til
FROM dbo.Kunde FOR SYSTEM_TIME ALL
WHERE KundeId = 42
ORDER BY GyldigFra;
UttrykkGir deg
AS OF tRadene som var gyldige akkurat på tidspunktet t.
FROM a TO bVersjoner som var gyldige en gang i intervallet (b ikke inkludert).
BETWEEN a AND bSom FROM … TO, men tar med versjoner som startet nøyaktig på b.
CONTAINED IN (a, b)Versjoner som både startet og sluttet innenfor intervallet.
ALLAlt: gjeldende rader og hele historikken.

Hvem som gjorde endringen, lagres ikke automatisk. Trenger du det, legg til en kolonne som EndretAv nvarchar(128) NOT NULL DEFAULT SUSER_SNAME() og sørg for at applikasjonen oppdaterer den ved hver endring – eller bruk SQL Server Audit for revisjon (se sikkerhetsguiden).

Opprydding og lagring

Med HISTORY_RETENTION_PERIOD sletter en bakgrunnsjobb gamle rader fra historikktabellen automatisk. Det krever at databasen har innstillingen TEMPORAL_HISTORY_RETENTION på, som er standard:

SELECT name, is_temporal_history_retention_enabled FROM sys.databases;

SELECT t.name AS Tabell, t.history_retention_period, t.history_retention_period_unit_desc
FROM sys.tables AS t
WHERE t.temporal_type = 2;  -- system-versioned

Historikktabeller vokser jevnt og leses sjelden. En klynget columnstore-indeks på historikktabellen komprimerer godt og gjør oppryddingen effektiv. Husk også at historikken er med i alle backuper.

Skjemaendringer

De fleste vanlige endringer, som å legge til en kolonne eller gjøre en kolonne lengre, gjøres direkte på hovedtabellen og speiles automatisk til historikktabellen. Enkelte endringer krever at du slår av versjoneringen midlertidig:

BEGIN TRANSACTION;
ALTER TABLE dbo.Kunde SET (SYSTEM_VERSIONING = OFF);

-- Gjør endringen på begge tabellene
ALTER TABLE dbo.Kunde         DROP COLUMN GammelKolonne;
ALTER TABLE dbo.KundeHistorikk DROP COLUMN GammelKolonne;

ALTER TABLE dbo.Kunde SET (SYSTEM_VERSIONING = ON (
    HISTORY_TABLE = dbo.KundeHistorikk, DATA_CONSISTENCY_CHECK = ON));
COMMIT;

Kjør det i én transaksjon, slik at ingen endringer i mellomtiden går tapt fra historikken.

Temporale tabeller og GDPR

Historikk er nyttig for revisjon, men det betyr også at personopplysninger du har «slettet» eller rettet, fortsatt ligger i historikktabellen. Ved en henvendelse om sletting må du derfor også rydde der. Historikktabellen kan ikke endres direkte mens versjoneringen er på:

BEGIN TRANSACTION;
ALTER TABLE dbo.Kunde SET (SYSTEM_VERSIONING = OFF);

DELETE FROM dbo.KundeHistorikk WHERE KundeId = 42;

ALTER TABLE dbo.Kunde SET (SYSTEM_VERSIONING = ON (HISTORY_TABLE = dbo.KundeHistorikk));
COMMIT;

Legg inn en slik prosedyre før du trenger den, og sett en oppbevaringstid som matcher behandlingsgrunnlaget. Mer om dette i guiden om GDPR og personvern.

Temporale tabeller er ikke manipulasjonssikre: en bruker med nok rettigheter kan slå av versjoneringen og endre historikken. Trenger du bevis på at data ikke er endret, se på ledger-tabeller (SQL Server 2022+), som kryptografisk sikrer historikken.

Vanlige spørsmål

Hvorfor ser tidspunktene feil ut?

Fordi de er i UTC. Norsk tid er én time foran om vinteren og to om sommeren. Bruk AT TIME ZONE som i eksemplene over, både når du viser og når du spør.

Kan jeg bruke TRUNCATE TABLE?

Ikke på en tabell med versjonering på. Slå den av først, eller bruk DELETE – som da havner i historikken.

Hva skjer med ytelsen?

Innsetting er uendret. Oppdateringer og slettinger skriver én ekstra rad til historikktabellen, omtrent som en trigger, men mer effektivt. Spørringer mot den nåværende tabellen påvirkes ikke.

Fungerer det med Entity Framework Core?

Ja. EF Core støtter temporale tabeller med IsTemporal() i modellen og spørringer med TemporalAsOf(), TemporalAll() og lignende. Se også guiden om EF Core og SQL Server.

Er dette det samme som Change Data Capture?

Nei. CDC leser transaksjonsloggen og er laget for å sende endringer videre til andre systemer, for eksempel et datavarehus. Temporale tabeller er laget for å spørre mot historikk i selve databasen.

Les også