共用方式為

JSON_OBJECTAGG (Transact-SQL)

  • 發行項

適用於： Azure SQL 資料庫 Azure SQL 受控執行個體

從 SQL 資料或資料行的彙總建構 JSON 物件。

索引鍵/值組可以指定為輸入值、資料行、變數參考。

若要改為從彙總建立 JSON 陣列，請使用 JSON_ARRAYAGG。

注意

json 聚合函數JSON_OBJECTAGG和JSON_ARRAYAGG目前都處於 Azure SQL 資料庫 和 Azure SQL 受控執行個體 預覽狀態（使用 Always-up-to-date 更新原則設定）。

Transact-SQL 語法慣例

語法

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

json_null_clause ::= NULL ON NULL | ABSENT ON NULL

引數

json_key_value

JSON 物件的索引鍵/值組。

json_null_clause

選擇性。 如果值為 NULL，或者使用 JSON null 作為屬性值，則會省略物件的整個屬性。 如果省略，則 NULL ON NULL 為預設值。

範例

範例 1

下列範例會傳回具有一個索引鍵和 null 值的 JSON 物件。

select JSON_OBJECTAGG ( 'key':null )

結果

{"key":null}

範例 2

下列範例會建構 JSON 物件，其中包含三個來自結果集的屬性。

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

結果

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

範例 3

下列範例會傳回包含兩個資料行的結果。 第一個資料行包含 object_id 值。 第二個資料行包含 JSON 物件，其中索引鍵是資料行名稱，而值為 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;

結果

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}

相關內容