JSON_ARRAYAGG (Transact-SQL)

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

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

代わりに集計から JSON オブジェクトを作成するには、JSON_OBJECTAGG を使用します。

Transact-SQL 構文表記規則

構文

JSON_ARRAYAGG (value_expression [ order_by_clause ] [ json_null_clause ] )

json_null_clause ::=  NULL ON NULL | ABSENT ON NULL

order_by_clause ::= ORDER BY <column_list>

引数

value_expression

値式には、クエリまたは定数/リテラル内の列または式を指定できます。

json_null_clause

省略可能。 json_null_clause は、JSON_ARRAYAGG が の場合に、NULL 関数の動作を制御するために使用できます。 オプション NULL ON NULL を使用すると、JSON 配列内の要素の値を生成するときに、SQL NULL 値が JSON NULL 値に変換されます。 オプション ABSENT ON NULL を使用すると、値が NULL の場合、JSON 配列内の要素が省略されます。 省略すると、ABSENT ON NULL が既定値になります。

order_by_clause

省略可能。 結果の JSON 配列内の要素の順序を指定して、入力行を集計に並べ替えることができます。

例

例 1

次の例では、空の JSON 配列を返します。

SELECT JSON_ARRAYAGG(NULL);

結果

[]

例 2

次の例では、結果セットから 3 つの要素を含む JSON 配列を構築します。

SELECT JSON_ARRAYAGG(c1)
FROM (VALUES ('c'), ('b'), ('a')) AS t(c1);

結果

["c","b","a"]

例 3

次の例では、列の値で並べ替えられた 3 つの要素を含む JSON 配列を構築します。

SELECT JSON_ARRAYAGG( c1 ORDER BY c1)
FROM (
    VALUES ('c'), ('b'), ('a')
) AS t(c1);

結果

["a","b","c"]

例 4

次の列は 2 つの列を持つ結果を返します。 最初の列には object_id 値が含まれています。 2 番目の列には、列の名前を含む JSON 配列が含まれています。 JSON 配列内の列は、column_id 値に基づいて並べ替えられています。

SELECT TOP(5) c.object_id, JSON_ARRAYAGG(c.name ORDER BY c.column_id) AS column_list
FROM sys.columns AS c
GROUP BY c.object_id;

結果

例 5

次の例では、GROUP BY GROUPING SETS を使用して SUM 集計とJSON_ARRAYAGG集計を含む SELECT ステートメントから 4 つの列を含む結果を返します。 最初の 2 つの列は、 id と type 列の値を返します。 3 番目の列 total_amount は、 amount 列の SUM 集計の値を返します。 4 番目の列 json_total_amount は、 amount 列JSON_ARRAYAGG集計の値を返します。

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_ARRAYAGG(amount) AS json_total_amount
FROM T
GROUP BY GROUPING SETS((id), (type), (id, type), ());

結果

関連するコンテンツ

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