JSON i SQL Server: Lagre, spørre og indeksere

JSON er overalt: i API-er, i konfigurasjon, i hendelseslogger og i data fra eksterne systemer. SQL Server har kunnet lese og lage JSON siden 2016, og med SQL Server 2025 kom endelig en egen json-datatype. Denne guiden viser hvordan du lagrer JSON, henter ut verdier, gjør JSON om til rader og tilbake, og hvordan du indekserer feltene du søker i – og når det er lurere å bruke vanlige kolonner.

Kort fortalt
  • JSON_VALUE henter en enkeltverdi, JSON_QUERY et objekt eller en liste, og OPENJSON gjør JSON om til rader.
  • FOR JSON PATH gjør resultatet av en spørring om til JSON.
  • I SQL Server 2025 og Azure SQL bør nye JSON-kolonner bruke datatypen json. I eldre versjoner brukes nvarchar(max) med en ISJSON-sjekk.
  • Søker du ofte i et felt, lag en beregnet kolonne med JSON_VALUE og indekser den. Data du alltid spør på, hører hjemme i vanlige kolonner.

Lagre JSON

SQL Server 2025 og Azure SQL: json-datatypen

Den nye json-typen lagrer dokumentet i et binært format. Det gir automatisk validering, raskere lesing fordi teksten ikke må tolkes på nytt for hver spørring, og muligheten til å endre deler av dokumentet uten å skrive alt på nytt.

CREATE TABLE dbo.Hendelse
(
    HendelseId bigint IDENTITY PRIMARY KEY,
    Tidspunkt  datetime2(3) NOT NULL DEFAULT SYSUTCDATETIME(),
    Data       json         NOT NULL
);

INSERT INTO dbo.Hendelse (Data)
VALUES (N'{"type":"ordre","kunde":{"id":42,"navn":"Nordlys AS"},"linjer":[{"vare":"A-100","antall":2},{"vare":"B-200","antall":1}]}');

Eldre versjoner: nvarchar(max) med ISJSON

CREATE TABLE dbo.Hendelse
(
    HendelseId bigint IDENTITY PRIMARY KEY,
    Data       nvarchar(max) NOT NULL
        CONSTRAINT CK_Hendelse_Data_ErJson CHECK (ISJSON(Data) = 1)
);

Uten sjekken kan hvem som helst lagre ugyldig JSON, og feilen dukker først opp når noen prøver å lese den. Bruk nvarchar, ikke varchar, så du ikke mister tegn. Se også norske tegn og sortering.

Hente ut verdier

FunksjonGirEksempel
JSON_VALUEÉn skalar verdi som tekstJSON_VALUE(Data, '$.kunde.navn')
JSON_QUERYEt objekt eller en liste som JSONJSON_QUERY(Data, '$.linjer')
JSON_PATH_EXISTS1 hvis stien finnes (2022+)JSON_PATH_EXISTS(Data, '$.rabatt')
ISJSON1 hvis teksten er gyldig JSONISJSON(Tekst)
SELECT HendelseId,
       JSON_VALUE(Data, '$.type')                     AS Type,
       CAST(JSON_VALUE(Data, '$.kunde.id') AS int)    AS KundeId,
       JSON_VALUE(Data, '$.kunde.navn')               AS Kundenavn,
       JSON_VALUE(Data, '$.linjer[0].vare')           AS FørsteVare
FROM dbo.Hendelse
WHERE JSON_VALUE(Data, '$.type') = 'ordre';

JSON_VALUE returnerer alltid tekst (nvarchar(4000)), så konverter tall og datoer eksplisitt. Finnes ikke stien, får du NULL. Vil du heller ha feil, skriv 'strict $.kunde.id'.

OPENJSON: fra JSON til rader

OPENJSON er det kraftigste verktøyet. Med en WITH-del bestemmer du kolonnene og typene:

SELECT h.HendelseId, l.Vare, l.Antall
FROM dbo.Hendelse AS h
CROSS APPLY OPENJSON(h.Data, '$.linjer')
     WITH (
         Vare   varchar(20) '$.vare',
         Antall int         '$.antall'
     ) AS l;

Det er også en effektiv måte å sende en liste med verdier fra en applikasjon til SQL Server som én parameter:

DECLARE @Ider nvarchar(max) = N'[3, 17, 42]';

SELECT p.ProduktId, p.Navn
FROM dbo.Produkt AS p
WHERE p.ProduktId IN (SELECT CAST(value AS int) FROM OPENJSON(@Ider));

OPENJSON krever kompatibilitetsnivå 130 eller høyere.

FOR JSON: fra rader til JSON

SELECT o.OrdreId          AS [id],
       o.Dato             AS [dato],
       k.Navn             AS [kunde.navn],
       (SELECT l.Vare AS [vare], l.Antall AS [antall]
        FROM dbo.Ordrelinje AS l
        WHERE l.OrdreId = o.OrdreId
        FOR JSON PATH)    AS [linjer]
FROM dbo.Ordre AS o
JOIN dbo.Kunde AS k ON k.KundeId = o.KundeId
WHERE o.OrdreId = 1001
FOR JSON PATH, WITHOUT_ARRAY_WRAPPER;

Punktum i kolonnealiaset lager nøstede objekter, og en underspørring med FOR JSON blir en liste. INCLUDE_NULL_VALUES tar med felter som er NULL. Fra SQL Server 2022 kan du også bygge JSON med JSON_OBJECT og JSON_ARRAY, og SQL Server 2025 har aggregatene JSON_OBJECTAGG og JSON_ARRAYAGG.

Endre JSON

-- Fungerer på både nvarchar og json
UPDATE dbo.Hendelse
SET Data = JSON_MODIFY(Data, '$.status', 'behandlet')
WHERE HendelseId = 1;

-- Kun json-typen (SQL Server 2025): endrer dokumentet på stedet
UPDATE dbo.Hendelse
SET Data.modify('$.status', 'behandlet')
WHERE HendelseId = 1;

Indeksering av JSON

En WHERE JSON_VALUE(...) = ... må lese og tolke hvert eneste dokument. Den klassiske løsningen, som virker i alle versjoner, er en beregnet kolonne med en vanlig indeks:

ALTER TABLE dbo.Hendelse
ADD KundeId AS CAST(JSON_VALUE(Data, '$.kunde.id') AS int);

CREATE INDEX IX_Hendelse_KundeId ON dbo.Hendelse (KundeId);

-- Optimereren bruker indeksen også når spørringen skriver uttrykket direkte
SELECT HendelseId
FROM dbo.Hendelse
WHERE CAST(JSON_VALUE(Data, '$.kunde.id') AS int) = 42;

SQL Server 2025 introduserer også en egen JSON-indeks (CREATE JSON INDEX) på kolonner av typen json, som kan dekke flere stier på én gang og brukes av blant annet JSON_VALUE, JSON_PATH_EXISTS og JSON_CONTAINS. Funksjonen kom som forhåndsversjon; sjekk dokumentasjonen for gjeldende status før du bygger produksjon på den.

JSON eller vanlige kolonner?

Bruk JSON når …Bruk vanlige kolonner når …
strukturen varierer fra rad til radalle rader har de samme feltene
du lagrer data fra et eksternt system som de erdu filtrerer, sorterer og joiner på feltene
dataene leses og skrives som en helhetdu trenger fremmednøkler og andre regler
feltene sjelden brukes i spørringerfeltene inngår i rapporter og aggregering

Et vanlig og godt kompromiss er å trekke ut de få feltene du søker i som egne kolonner, og beholde resten som JSON.

Vanlige spørsmål

Bør jeg konvertere eksisterende nvarchar-kolonner til json?

Når du er på SQL Server 2025 eller Azure SQL, er det som regel en fordel: mindre lagring, raskere lesing og garantert gyldig innhold. Test først, særlig hvis applikasjonen sammenligner JSON som tekst – den binære typen bevarer ikke nødvendigvis mellomrom og formatering.

Er SQL Server en dokumentdatabase nå?

Nei, men den dekker mange av de samme behovene. Les om forskjellene i oversikten over NoSQL-databaser.

Hvordan bruker jeg JSON-kolonner fra Entity Framework Core?

EF Core kan mappe eide typer og samlinger til en JSON-kolonne med ToJson() og oversette LINQ-spørringer til JSON_VALUE og OPENJSON. Se Entity Framework Core og SQL Server.

Les også