Compartilhar via


Incluir valores nulos na opção JSON – INCLUDE_NULL_VALUES

Aplica-se a: SQL Server 2016 (13.x) e versões posteriores Azure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics (somente pool de SQL sem servidor)endpoint de análise de SQL no Microsoft FabricArmazém no Microsoft FabricBanco de dados SQL no Microsoft Fabric

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

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

Examples

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

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

Aqui está outro exemplo de uma FOR JSON cláusula 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 o JSON no Mecanismo de Banco de Dados SQL

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