JSON_OBJECTAGG (Transact-SQL)

Gäller för: SQL Server 2025 (17.x) Förhandsversion av Azure SQL DatabaseAzure SQL Managed InstanceSQL Database i Förhandsversion av Microsoft Fabric

Syntaxen JSON_OBJECTAGG konstruerar ett JSON-objekt från en aggregering av SQL-data eller kolumner. JSON_OBJECTAGGkan också användas i en instruktion med SELECT -GROUP BY GROUPING SETSsats.

Nyckel/värde-paren kan anges som indatavärden, kolumn- och variabelreferenser.

Både json-aggregerade funktioner JSON_OBJECTAGG och JSON_ARRAYAGG är:

• allmänt tillgänglig för Azure SQL Database, Azure SQL Managed Instance (med SQL Server 2025 eller Always-up-to-dateupdate policy**), SQL-databas i Microsoft Fabric och Fabric Data Warehouse.

• förhandsversion för SQL Server 2025 (17.x).

Transact-SQL syntaxkonventioner

Syntax

JSON_OBJECTAGG ( json_key_value [ json_null_clause ] [ RETURNING json ] )

json_key_value ::= <json_name> : <value_expression>

json_null_clause ::= NULL ON NULL | ABSENT ON NULL

Arguments

json_key_value

Nyckel/värde-paret för JSON-objektet.

json_null_clause

Optional. Utelämnar hela egenskapen för ett objekt om värdet är NULLeller använder JSON null som egenskapsvärde. Om det utelämnas är NULL ON NULL standard.

Returvärde

Returnerar en giltig JSON-objektsträng av typen nvarchar(max). Om alternativet RETURNING json ingår returneras JSON-objektet som json-typ .

Examples

A. Returnera JSON-objekt med en nyckel

I följande exempel returneras ett JSON-objekt med en nyckel och ett null-värde.

SELECT JSON_OBJECTAGG('key':NULL);

Här är resultatet.

{"key":null}

B. Konstruera JSON-objekt från resultatuppsättning

I följande exempel skapas ett JSON-objekt med tre egenskaper från en resultatuppsättning.

SELECT JSON_OBJECTAGG(c1:c2)
FROM (
    VALUES('key1', 'c'), ('key2', 'b'), ('key3', 'a')
) AS t(c1, c2);

Här är resultatet.

{"key1":"c","key2":"b","key3":"a"}

C. Returnera resultat med två kolumner

I följande exempel returneras ett resultat med två kolumner. Den första kolumnen innehåller värdet object_id. Den andra kolumnen innehåller ett JSON-objekt där nyckeln är kolumnnamnet och värdet är column_id.

SELECT TOP (5) c.object_id,
               JSON_OBJECTAGG(c.name:c.column_id) AS columns
FROM sys.columns AS c
GROUP BY c.object_id;

D. Returnera ett JSON-objekt som JSON-typ

I följande exempel returneras ett JSON-objekt som json-typ .

SELECT JSON_OBJECTAGG('a':1 RETURNING JSON);

resultat

{"a":1}

Här är resultatet.

E. Returnera aggregerat resultat med fyra kolumner

I följande exempel returneras ett resultat med fyra kolumner från en SELECT -instruktion som innehåller SUM och JSON_OBJECTAGG aggregerar med GROUP BY GROUPING SETS. De två första kolumnerna id returnerar kolumnvärdet och type . Den tredje kolumnen total_amount returnerar värdet för SUM aggregering i amount kolumnen. Den fjärde kolumnen json_total_name_amount returnerar värdet för JSON_OBJECTAGG mängd på kolumnerna name och amount .

WITH T
AS (SELECT *
    FROM (
        VALUES (1, 'k1', 'a', 2), (1, 'k2', 'b', 3), (1, 'k3', 'b', 4), (2, 'j1', 'd', 7), (2, 'j2', 'd', 9)
    ) AS b(id, name, type, amount))
SELECT id,
       type,
       SUM(amount) AS total_amount,
       JSON_OBJECTAGG(name:amount) AS json_total_name_amount
FROM T
GROUP BY GROUPING SETS((id), (type), (id, type), ());

Här är resultatet.

Relaterat innehåll

• JSON-sökvägsuttryck i SQL Database Engine
• JSON-data i SQL Server
• JSON_ARRAYAGG (Transact-SQL)