FOR JSON を使用してクエリ結果を JSON として書式設定する

FOR JSON PATH で出力を制御する

PATH モードではドット構文を使用できます。たとえば、ネストした出力を書式設定するには、Item.Price と指定します。

FOR JSON 句で PATH モードを使用するサンプル クエリを以下に示します。 次の例では、ROOT オプションを使用して名前付きのルート要素を指定しています。

FOR JSON PATH に関する詳細情報

詳細と例については、「PATH モードで入れ子になった JSON 出力を書式設定する (SQL Server)」を参照してください。

構文と使用法については、「FOR 句 (Transact-SQL)をご覧ください。

SELECT ステートメントで FOR JSON AUTO を使用して出力を制御する

AUTO モードでは、SELECT ステートメントの構造によって JSON 出力の形式が決まります。

既定では、NULL 値は出力に含まれません。 INCLUDE_NULL_VALUES を使用して、この動作を変更できます。

FOR JSON 句で AUTO モードを使用するサンプル クエリを以下に示します。

SELECT name, surname
FROM emp
FOR JSON AUTO;

また、返された JSON を以下に示します。

[{
    "name": "John"
}, {
    "name": "Jane",
    "surname": "Doe"
}]

JOIN と NULL を使用した例

以下の SELECT...FOR JSON AUTO の例には、結合されたテーブルのデータ間に 1 対多の関係がある場合に JSON の結果がどのように表示されるかが含まれています。

返された JSON に null 値が存在しないことも示されています。 ただし、この既定の動作は、FOR 句で INCLUDE_NULL_VALUES キーワードを使用することでオーバーライドできます。

DROP TABLE IF EXISTS #tabStudent;
DROP TABLE IF EXISTS #tabClass;
GO

CREATE TABLE #tabClass (
    ClassGuid UNIQUEIDENTIFIER NOT NULL DEFAULT newid(),
    ClassName NVARCHAR(32) NOT NULL
);

CREATE TABLE #tabStudent (
    StudentGuid UNIQUEIDENTIFIER NOT NULL DEFAULT newid(),
    StudentName NVARCHAR(32) NOT NULL,
    ClassGuid UNIQUEIDENTIFIER NULL -- Foreign key.
);
GO

INSERT INTO #tabClass (ClassGuid, ClassName)
VALUES
    ('DE807673-ECFC-4850-930D-A86F921DE438', 'Algebra Math'),
    ('C55C6819-E744-4797-AC56-FF8A729A7F5C', 'Calculus Math'),
    ('98509D36-A2C8-4A65-A310-E744F5621C83', 'Art Painting');

INSERT INTO #tabStudent (StudentName, ClassGuid)
VALUES
    ('Alice Apple', 'DE807673-ECFC-4850-930D-A86F921DE438'),
    ('Alice Apple', 'C55C6819-E744-4797-AC56-FF8A729A7F5C'),
    ('Betty Boot', 'C55C6819-E744-4797-AC56-FF8A729A7F5C'),
    ('Betty Boot', '98509D36-A2C8-4A65-A310-E744F5621C83'),
    ('Carla Cap', null);
GO

SELECT c.ClassName,
    s.StudentName
FROM #tabClass AS c
RIGHT JOIN #tabStudent AS s ON s.ClassGuid = c.ClassGuid
ORDER BY c.ClassName,
    s.StudentName
FOR JSON AUTO
    -- To include NULL values in the output, uncomment the following line:
    --, INCLUDE_NULL_VALUES
    ;
GO

DROP TABLE IF EXISTS #tabStudent;
DROP TABLE IF EXISTS #tabClass;
GO

次に示すのは、上記の SELECT により出力される JSON です。

JSON_F52E2B61-18A1-11d1-B105-00805F49916B

[
   {"s":[{"StudentName":"Carla Cap"}]},
   {"ClassName":"Algebra Math","s":[{"StudentName":"Alice Apple"}]},
   {"ClassName":"Art Painting","s":[{"StudentName":"Betty Boot"}]},
   {"ClassName":"Calculus Math","s":[{"StudentName":"Alice Apple"},{"StudentName":"Betty Boot"}]}
]

FOR JSON AUTO に関する詳細情報

詳細と例については、「AUTO モードで自動的に JSON 出力を書式設定する (SQL Server)」を参照してください。

構文と使用法については、「FOR 句 (Transact-SQL)をご覧ください。