JSON-adattípus

A következőkre vonatkozik: SQL Server 2025 (17.x) Azure SQL DatabaseAzure SQL Managed InstanceSQL Database a Microsoft Fabricben

A json adattípus bináris formátumban tárolja a JSON dokumentumokat.

A json típus magas hűségű JSON dokumentumok tárolását biztosítja, optimalizálva lekérdezésre és manipulációra. Az alábbi előnyöket kínálja a JSON adatok varchar vagy nvarchar formájában történő tárolásához képest:

  • Hatékonyabb olvasás, mivel a dokumentum már fel van bontakozva.
  • Hatékonyabb írások, mivel a lekérdezés frissítheti az egyes értékeket anélkül, hogy hozzáférne az egész dokumentumhoz.
  • Hatékonyabb tárolás, tömörítésre optimalizálva.
  • Nem változott a meglévő kóddal való kompatibilitás.

A json típus belső tárolásával tárolja a stringeket UTF-8 kódolással (Latin1_General_100_BIN2_UTF8). Más adattípusokat natív adattípusokként tárolnak. Ez a viselkedés megfelel a JSON-specifikációnak.

További információ a JSON-adatok lekérdezéséről: JSON-adatok az SQL Server.

Mintaszintaxis

A json-típus használati szintaxisa hasonló a tábla többi SQL Server-adattípusához.

column_name JSON [ NOT NULL | NULL ] [CHECK ( constraint_expression ) ] [ DEFAULT ( default_expression ) ]

Használd a json adattípust egy oszlopdefinícióban, amely egy CREATE TABLE utasításban található. Például:

CREATE TABLE Orders
(
    order_id INT,
    order_details JSON NOT NULL
);

Határozd meg a korlátozásokat az oszlopdefiníció részeként. Például:

CREATE TABLE Orders
(
    order_id INT,
    order_details JSON NOT NULL
        CHECK (JSON_PATH_EXISTS(order_details, '$.basket') = 1)
);

Szolgáltatás rendelkezésre állása

A JSON funkciók támogatását az SQL Server 2016 (13.x) vezette be. A beépített json adattípus elérhető az Azure SQL Database-ben, Azure SQL Managed Instance-ban és SQL Server 2025-ben (17.x).

További információért az SQL Server 2025 (17.x) JSON támogatásáról lásd: Key JSON capabilities in SQL Server 2025.

A json-adattípus minden adatbáziskompatibilitási szinten elérhető.

Note

A json adattípus és a JSON indexek általában elérhetők SQL Server 2025-ben (17.x), Azure SQL Database, Azure SQL Managed Instance (a 2025-ös SQL Server vagy az Always-up-to-dateupdate policy és SQL adatbázis Microsoft Fabric.

A módosítási módszer

A json-adattípus támogatja a metódust modify . Használd modify a JSON dokumentumok megváltoztatására egy oszlopban. A modify módszer olyan optimalizálásokat tartalmaz, amelyek helyben módosítják az adatokat, amikor lehetséges. Ez a legkedveltebb módja annak, hogy egy JSON dokumentumot módosítsunk egy json oszlopban.

JSON stringek esetén, ha az új érték ugyanolyan hosszú vagy rövidebb, mint a meglévő érték, a módszer képes módosítani az adatokat a helyén.

JSON számok esetén, ha az új érték azonos típusú, vagy a meglévő érték tartományába illeszkedik, a módszer módosíthatja a meglévő adatokat.

DROP TABLE IF EXISTS JsonTable;

CREATE TABLE JsonTable
(
    id INT PRIMARY KEY,
    d JSON
);

INSERT INTO JsonTable
(
    id,
    d
)
VALUES (1, '{"a":1, "b":"abc", "c":true}');

UPDATE JsonTable
SET d.modify('$.a', 14859)
WHERE id = 1;

UPDATE JsonTable
SET d.modify('$.b', 'def')
WHERE id = 1;

Érvényes adatok

A json-adattípus bemenetének JSON-objektumnak vagy JSON-tömbnek kell lennie. A skalárok, boole-értékek és NULL értékek nem támogatottak. A JSON-adattípus megfelel az IETF RFC 4627-nek, amely csak egy JSON-objektumot vagy tömböt engedélyez.

Használd az ISJSON függvényt annak tesztelésére, hogy tartalmaz-e érvényes JSON-t egy string. Típuskorlátozás nélkül ISJSON csak egy JSON objektumot vagy tömböt fogad el a felső szinten, ugyanúgy, mint a json adattípus. A VALUE típuskorlátozás bármilyen JSON értéket elfogad a felső szinten, beleértve a skalárt is, ahogy az IETF RFC 8259 lehetővé teszi. A , OBJECT, és SCALAR típuskorlátok ARRAYcsak ezt a típust fogadják el.

Például:

DECLARE @true AS JSON = 'true'; -- invalid
DECLARE @false AS JSON = 'false'; -- invalid
DECLARE @number AS JSON = '1234.56'; -- invalid
DECLARE @string AS JSON = '"contoso"'; -- invalid
DECLARE @null AS JSON = 'null'; -- invalid

DECLARE @null AS JSON = NULL; -- valid
DECLARE @object AS JSON = '{}'; -- valid
DECLARE @array AS JSON = '[]'; -- valid

Függvénytámogatás

Minden JSON funkció támogatja a json adattípust anélkül, hogy kódváltoztatásra lenne szükség.

A JSON-függvények teljes listájáért tekintse meg a JSON-függvényeket.

Indexes

A json oszlop lehet egy index definíció bevont oszlopa, vagy megjelenhet egy WHERE szűrt index záradékában. Egy json oszlopot nem lehet kulcsoszlopként használni egy szabványos indexen.

További információért lásd CREATE INDEX.

Az Azure SQL Database-ben, Azure SQL Managed Instance-ban, SQL Server 2025-ben (17.x) és SQL Database-ben Microsoft Fabric-ben létrehozhatsz egy JSON indexet, hogy optimalizáld azokat a lekérdezéseket, amelyek a JSON dokumentumokon belüli értékekhez férnek hozzá.

További információért lásd CREATE JSON INDEX.

Conversion

A json-bólchar-ra, nchar-ra, varchar-ra és nvarchar-ra történő átalakításnak egyértelműnek kell lennie. Használja a CAST vagy a CONVERT elemet.

A char, nchar, varchar, nvarchar és vektorbóljson-ra történő átalakítás implicit vagy explicit lehet. A json-bólvektorra történő átalakítás lehet implicit vagy explicit is.

A json és minden más adattípus közötti átalakítás nem engedélyezett.

Az egy json-ra konvertált értéknek JSON objektumnak vagy JSON tömbnek kell lennie. Egy JSON skalár, például 1, "abc", true, vagy null, 13609 hibát okoz. Egy üres string is 13609-es hibát okoz. Ha egy objektumnak vannak duplikált kulcsai, a json megtartja az első értéket, a többi értéket pedig eldobja. Nem történik hiba.

A json-ból string típusra történő átalakítás esetén a JSON szöveg jelentéktelen fehér hely nélkül tér visszaadja. Ha a célhossz túl rövid a JSON szöveghez, akkor 13639 hiba következik be. Az érték nem rövidítés.

A json-adattípus nem használható sql_variant típussal, és nem rendelhető hozzá sql_variant változóhoz vagy oszlophoz. Ez a korlátozás hasonló a varchar(max), varbinary(max), nvarchar(max), xml és CLR-alapú adattípusokhoz.

A meglévő oszlopokat, például a varchar(max)json értékre konvertálhatja a használatával ALTER TABLE. Az xml-adattípushoz hasonlóan a JSON-oszlopokat nem konvertálhatja a sztringek vagy bináris típusok ALTER TABLEegyikére sem.

További információ: Adattípus-átalakítás (adatbázismotor).

Numerikus pontosság

Amikor a char, nchar, varchar vagy nvarcharjson-ra konvertálsz, a JSON számot tartalmazó JSON szöveget a számformátum alapján lehet kerekíteni.

Ha pontosságot akarsz megőrizni, add meg a JSON számot tizedesként. Hasonlóképpen, ha meg kell őrizni a JSON dokumentum szöveges ábrázolását, tárold a JSON dokumentumot karakterlánc adattípusként.

Compatibility

A json adattípust használhatod paraméterként vagy visszaküldési típusként egy felhasználó által definiált függvényben, vagy egy tárolt eljárás paramétereként. A json típus kompatibilis az eseményindítókkal és a nézetekkel.

Jelenleg a bcp eszköz natív formátuma a json adatokat varchar vagy nvarchar formátumban mutatja be. Meg kell adnia egy formátumfájlt egy json-oszlop kijelöléséhez.

Nem lehet alias típust létrehozni a json adattípushoz .CREATE TYPE Ez a viselkedés megegyezik az XML-adattípussal .

A json-adattípus használatával SELECT ... INTO létrehoz egy json típusú táblát.

Limitations

CAST és CONVERT a JSON adattípust a várt módon adja vissza.

Illesztőprogramok korlátozásai

A sp_describe_first_result_set rendszer tárolt eljárása helyesen adja vissza a json adattípust, ha az illesztőprogram támogatja a JSONSUPPORT TDS funkciókiterjesztést. Azok a sofőrök, akik nem támogatják ezt a hosszabbítást, inkább a varchar vagy nvarchar felé fordulnak.

A SqlClient (>= 6.0) és a JDBC (>= 13.2.0) támogatja JSONSUPPORTa . Például az SQL Server Management Studio (SSMS) legújabb verziója a legújabb SqlClient drivert használja, és helyesen jelenti a json type eredményhalmaz-metaadatait.

  • NélkülJSONSUPPORT, TDS >= 7,4 (UTF-8-cal együtt) varchar (max) jelentést jelent .Latin1_General_100_BIN2_UTF8
  • Ilma JSONSUPPORT, TDS < 7.4 nvarchar(max) adatbázis-összeállítással jelent.

Méretkorlátozások

A tárolóban lévő JSON-adatok méretkorlátai:

szakterület Limitation
JSON-adattípus mérete (bináris) Akár 2 GB-ig
Egyedi kulcsok száma Akár 32 000
Kulcssztring-méret szerint 7 998 bájt
Sztringenkénti értékméret 536 870 911 bájt
Tulajdonságok száma egy objektumban Akár 65 535 főre
Elemek száma egy tömbben Akár 65 535 főre
Beágyazott szintek száma a JSON-dokumentumban 128