Condividi tramite

JSON_OBJECTAGG (Transact-SQL)

  • Articolo

Si applica a: Database SQL di Azure Istanza gestita di SQL di Azure

Costruisce un oggetto JSON da un'aggregazione di dati o colonne SQL.

Le coppie chiave/valore possono essere specificate come valori di input, colonna, riferimenti a variabili.

Invece, per creare invece una matrice JSON da un'aggregazione, usare JSON_ARRAYAGG.

Nota

Entrambe le funzioni JSON_OBJECTAGG di aggregazione JSON e JSON_ARRAYAGG sono attualmente in anteprima per database SQL di Azure e Istanza gestita di SQL di Azure (configurate con i criteri di aggiornamento sempre aggiornati).

Convenzioni relative alla sintassi Transact-SQL

Sintassi

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

json_null_clause ::= NULL ON NULL | ABSENT ON NULL

Argomenti

json_key_value

Coppia chiave/valore dell'oggetto JSON.

json_null_clause

Facoltativo. Omette l'intera proprietà di un oggetto se il valore è NULL o usa JSON Null come valore della proprietà. Se omesso, NULL ON NULL è predefinito.

Esempi

Esempio 1

L'esempio seguente restituisce un oggetto JSON con una chiave e un valore null.

select JSON_OBJECTAGG ( 'key':null )

Risultato

{"key":null}

Esempio 2

L'esempio seguente costruisce un oggetto JSON con tre proprietà di un set di risultati.

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

Risultato

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

Esempio 3

L'esempio seguente restituisce un set di risultati con due colonne. La prima colonna contiene il valore object_id. La seconda colonna contiene un oggetto JSON in cui la chiave è il nome della colonna e il valore è 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;

Risultato

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}

Contenuto correlato