使用 FOR JSON 將查詢結果格式化為 JSON

使用 FOR JSON PATH 控制輸出

在 PATH 模式中，使用點語法（例如 Item.Price）來格式化巢狀輸出。

以下是使用 PATH 模式搭配 FOR JSON 子句的範例查詢。 下列範例也會使用 ROOT 選項來指定具名根項目。

FOR JSON PATH 的詳細資訊

欲了解更多詳細資訊與範例，請參閱 「以 PATH 模式格式化巢狀 JSON 輸出」。

關於語法與用法，請參見 SELECT - FOR 子句。

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：many 關係時，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 子句。