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.
JSON_VALUEhenter en enkeltverdi,JSON_QUERYet objekt eller en liste, ogOPENJSONgjør JSON om til rader.FOR JSON PATHgjø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 brukesnvarchar(max)med enISJSON-sjekk. - Søker du ofte i et felt, lag en beregnet kolonne med
JSON_VALUEog 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
| Funksjon | Gir | Eksempel |
|---|---|---|
JSON_VALUE | Én skalar verdi som tekst | JSON_VALUE(Data, '$.kunde.navn') |
JSON_QUERY | Et objekt eller en liste som JSON | JSON_QUERY(Data, '$.linjer') |
JSON_PATH_EXISTS | 1 hvis stien finnes (2022+) | JSON_PATH_EXISTS(Data, '$.rabatt') |
ISJSON | 1 hvis teksten er gyldig JSON | ISJSON(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 rad | alle rader har de samme feltene |
| du lagrer data fra et eksternt system som de er | du filtrerer, sorterer og joiner på feltene |
| dataene leses og skrives som en helhet | du trenger fremmednøkler og andre regler |
| feltene sjelden brukes i spørringer | feltene 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.