Freigeben über

JSON_OBJECTAGG (Transact-SQL)

  • Artikel

Gilt für:Azure SQL-Datenbankazure SQL Managed InstanceSQL Analytics-Endpunkt und Warehouse in Microsoft Fabric

Erstellt ein JSON-Objekt aus einer Aggregation von SQL-Daten oder -Spalten.

Die Schlüssel-Wert-Paare können als Eingabewerte, Spalten- und Variablenverweise angegeben werden.

Verwenden Sie JSON_ARRAYAGG, um stattdessen ein JSON-Array aus einem Aggregat zu erstellen.

Hinweis

Sowohl JSON- Aggregatfunktionen JSON_OBJECTAGG als auch JSON_ARRAYAGG befinden sich derzeit in der Vorschau für Azure SQL-Datenbank, azure SQL Managed Instance (konfiguriert mit dem Always-up-to-date Update policy) und Fabric Data Warehouse.

Transact-SQL-Syntaxkonventionen

Syntax

JSON_OBJECTAGG ( json_key_value [ json_null_clause ] )
 
json_key_value ::= <json_name> : <value_expression> 

json_null_clause ::= NULL ON NULL | ABSENT ON NULL

Argumente

json_key_value

Das Schlüssel-Wert-Paar des JSON-Objekts.

json_null_clause

Optional. Lässt die gesamte Eigenschaft eines Objekts aus, wenn der Wert NULL lautet, oder verwenden Sie JSON-Null als Eigenschaftswert. Wenn nicht angegeben, ist NULL ON NULL der Standardwert.

Beispiele

Beispiel 1

Im folgenden Beispiel wird ein JSON-Objekt mit einem Schlüssel und einem Null-Wert zurückgegeben.

select JSON_OBJECTAGG ( 'key':null )

Ergebnis

{"key":null}

Beispiel 2

Im folgenden Beispiel wird ein JSON-Objekt mit drei Eigenschaften aus einem Resultset erstellt.

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

Ergebnis

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

Beispiel 3

Im folgenden Beispiel wird ein Ergebnis mit zwei Spalten zurückgegeben. Die erste Spalte enthält den Wert object_id. Die zweite Spalte enthält ein JSON-Objekt, bei dem der Schlüssel der Spaltenname und der Wert column_id ist.

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;

Ergebnis

object_id column_list
3 {"bitpos":12,"cid":6,"colguid":13,"hbcolid":3,"maxinrowlen":8,"nullbit":11,"offset":10,"ordkey":7,"ordlock":14,"rcmodified":4,"rscolid":2,"rsid":1,"status":9,"ti":5}
5 {"cmprlevel":9,"fgidfs":7,"fillfact":10,"idmajor":3,"idminor":4,"lockres":17,"maxint":13,"maxleaf":12,"maxnullbit":11,"minint":15,"minleaf":14,"numpart":5,"ownertype":2,"rcrows":8,"rowsetid":1,"rsguid":16,"scope_id":18,"status":6}
6 {"cloneid":6,"dbfragid":8,"id":1,"partid":3,"rowsetid":7,"segid":5,"status":9,"subid":2,"version":4}
7 {"auid":1,"fgid":5,"ownerid":3,"pcdata":10,"pcreserved":11,"pcused":9,"pgfirst":6,"pgfirstiam":8,"pgroot":7,"status":4,"type":2}
8 {"fileid":2,"filename":4,"name":3,"status":1}

Zugehöriger Inhalt