JSON_OBJECTAGG (Transact-SQL)
Aplica-se a: Banco de Dados SQL do Azure
Constrói um objeto JSON de uma agregação de colunas ou dados SQL.
Os pares chave/valor podem ser especificados como valores de entrada, coluna, referências de variáveis.
Para criar uma matriz JSON com base em uma agregação, use JSON_ARRAYAGG.
Observação
Atualmente, as funções de agregação json JSON_OBJECTAGG
e JSON_ARRAYAGG
estão disponíveis na preview do Banco de Dados SQL do Azure.
Convenções de sintaxe de Transact-SQL
Sintaxe
JSON_OBJECTAGG ( json_key_value [ json_null_clause ] )
json_key_value ::= <json_name> : <value_expression>
json_null_clause ::= NULL ON NULL | ABSENT ON NULL
Argumentos
json_key_value
O par chave-valor do objeto JSON.
json_null_clause
Opcional. Omite a propriedade inteira de um objeto se o valor é NULL
, ou use JSON null como valor da propriedade. Se omitido, NULL ON NULL
é o padrão.
Exemplos
Exemplo 1
O exemplo a seguir retorna um objeto JSON com uma chave e um valor nulo.
select JSON_OBJECTAGG ( 'key':null )
Resultado
{"key":null}
Exemplo 2
O exemplo a seguir constrói um objeto JSON com três propriedades de um conjunto de resultados.
SELECT JSON_OBJECTAGG( c1:c2 )
FROM (
VALUES('key1', 'c'), ('key2', 'b'), ('key3','a')
) AS t(c1, c2);
Resultado
{"key1":"c","key2":"b","key3":"a"}
Exemplo 3
O exemplo a seguir retorna um resultado com duas colunas. A primeira coluna contém o valor object_id
. A segunda coluna contém um objeto JSON em que a chave é o nome da coluna e o valor é o 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;
Resultado
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} |
Conteúdo relacionado
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários