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

  • [アーティクル]

適用対象: SQL Server 2016 (13.x) Azure SQL DatabaseAzure SQL Managed InstanceAzure 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"
}]

SQL Server と Azure SQL Database の JSON の詳細情報

Microsoft ビデオ

Note

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

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

参照

FOR 句 (Transact-SQL)