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

FOR JSON PATH で出力を制御する

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

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

FOR JSON PATH に関する詳細情報

詳細と例については、「 PATH モードを使用した入れ子になった JSON 出力の書式設定」を参照してください。

構文と使用方法については、「 SELECT - FOR 句 (Transact-SQL)」を参照してください。

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

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

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

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

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 値が存在しないことも示されています。 ただし、この既定の動作は、INCLUDE_NULL_VALUES 句で FOR キーワードを使用することでオーバーライドできます。

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 出力を自動的に書式設定する」を参照してください。

構文と使用方法については、「 SELECT - FOR 句 (Transact-SQL)」を参照してください。