JSON_OBJECTAGG (Transact-SQL)

適用対象:SQL Server 2025 (17.x) プレビュー Azure SQL DatabaseAzure SQL Managed InstanceMicrosoft Fabric Preview の SQL データベース

JSON_OBJECTAGG構文は、SQL データまたは列の集計から JSON オブジェクトを構築します。 JSON_OBJECTAGGは、SELECT句を含むGROUP BY GROUPING SETSステートメントでも使用できます。

キーと値のペアは、入力値、列、変数参照として指定できます。

代わりに集計から JSON 配列を作成するには、 JSON_ARRAYAGG (Transact-SQL) を使用します。

Transact-SQL 構文表記規則

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

Arguments

json_key_value

JSON オブジェクトのキーと値のペア。

json_null_clause

Optional. 値が NULL、またはプロパティ値として JSON null を使用する場合は、オブジェクトのプロパティ全体を省略します。 省略すると、NULL ON NULL が既定値になります。

Examples

A. 1 つのキーで JSON オブジェクトを返す

次の例では、1 つのキーと null 値を持つ JSON オブジェクトを返します。

select JSON_OBJECTAGG ( 'key':null )

結果セットは次のとおりです。

{"key":null}

B. 結果セットから JSON オブジェクトを構築する

次の例では、結果セットから 3 つのプロパティを含む JSON オブジェクトを構築します。

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

結果セットは次のとおりです。

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

C. 2 つの列を含む結果を返す

次の列は 2 つの列を持つ結果を返します。 最初の列には object_id 値が含まれています。 2 番目の列には 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;

結果セットは次のとおりです。

D. 4 つの列を含む集計結果を返す

次の例では、SELECTを含むSUM ステートメントから 4 つの列を含む結果を返し、JSON_OBJECTAGGを含む集計をGROUP BY GROUPING SETSします。 最初の 2 つの列は、 id と type 列の値を返します。 3 番目の列total_amountは、SUM列amount集計の値を返します。 4 番目の列json_total_name_amountは、JSON_OBJECTAGG列とname列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), ());

結果セットは次のとおりです。

Related content

• JSON パス式
• SQL Server の JSON データ
• JSON_ARRAYAGG (Transact-SQL)