JSON に Null 値を含める - INCLUDE_NULL_VALUES オプション

適用対象: SQL Server 2016 (13.x) 以降 Azure SQL データベース Azure SQL Managed Instance Azure Synapse Analytics (サーバーレスの SQL プールのみ)

FOR JSON 句の JSON の出力に null 値を含めるには、 INCLUDE_NULL_VALUES オプションを指定します。

INCLUDE_NULL_VALUES オプションを指定しない場合、クエリ結果で値が null のプロパティは JSON の出力に含まれません。

例

INCLUDE_NULL_VALUES オプションを指定した場合と指定しなかった場合の FOR JSON 句の出力例を以下に示します。

INCLUDE_NULL_VALUES オプションを指定しなかった場合	INCLUDE_NULL_VALUES オプションを指定した場合
`{ "name": "John", "surname": "Doe" }`	`{ "name": "John", "surname": "Doe", "age": null, "phone": null }`

次に、 FOR JSON 句で INCLUDE_NULL_VALUES オプションを指定した別の例を示します。

クエリ

SELECT name, surname  
FROM emp  
FOR JSON AUTO, INCLUDE_NULL_VALUES

結果

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

Note

このセクションのビデオリンクの一部は、現時点では機能しない場合があります。 Microsoft では、以前 Channel 9 上にあったコンテンツの新しいプラットフォームへの移行作業を進めています。ビデオが新しいプラットフォームに移行されるに従ってリンクを更新します。

SQL Server と Azure SQL Database に組み込まれている JSON のサポートの視覚的な紹介は、次のビデオをご覧ください。