Поделиться через


Параметр INCLUDE_NULL_VALUES для включения Null-значений в JSON

применимо к: SQL Server 2016 (13.x) и более поздним версиям Базе данных SQL AzureУправляемому экземпляру SQL AzureAzure Synapse Analytics (только бессерверный пул SQL)конечной точке аналитики SQL в хранилище microsoft Fabricв Microsoft Fabric

Чтобы включить значения NULL в выходные данные JSON предложения FOR JSON, укажите параметр INCLUDE_NULL_VALUES.

Если параметр INCLUDE_NULL_VALUES не указан, выходные данные JSON не включают свойства значений, которые имеют значение NULL в результатах запроса.

Примеры

В следующем примере показаны выходные данные предложения FOR JSON с параметром INCLUDE_NULL_VALUES и без нее.

Без параметра 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"
}] 

Дополнительные сведения о JSON в ядре СУБД SQL

Наглядные инструкции по встроенной поддержке JSON в SQL Server и базе данных SQL Azure см. в следующих видео.