Partilhar via


Incluir valores nulos em JSON - opção INCLUDE_NULL_VALUES

Aplica-se a: SQL Server 2016 (13.x) e versões posterioresAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics (apenas serverless SQL pool)endpoint de análise SQL no Microsoft FabricArmazém de Dados no Microsoft FabricBase de dados SQL no Microsoft Fabric

Para incluir valores nulos na saída JSON da FOR JSON cláusula, especifique a INCLUDE_NULL_VALUES opção.

Se você não especificar a INCLUDE_NULL_VALUES opção, a saída JSON não incluirá propriedades para valores que são nulos nos resultados da consulta.

Examples

O exemplo a seguir mostra a saída da cláusula FOR JSON com e sem a opção INCLUDE_NULL_VALUES.

Sem a INCLUDE_NULL_VALUES opção Com a opção
{ "name": "John", "surname": "Doe" } { "name": "John", "surname": "Doe", "age": null, "phone": null }

Aqui está outro exemplo de uma cláusula FOR JSON com a opção INCLUDE_NULL_VALUES.

Query

SELECT name, surname  
FROM emp  
FOR JSON AUTO, INCLUDE_NULL_VALUES    

Result

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

Saiba mais sobre JSON no Mecanismo de Banco de Dados SQL

Para obter uma introdução visual ao suporte JSON integrado, consulte os seguintes vídeos: