Partilhar via


Incluir valores nulos na opção JSON – INCLUDE_NULL_VALUES

Aplica-se a: SQL Server 2016 (13.x) e posteriores Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure Azure Synapse Analytics (somente pool de SQL sem servidor)

Para incluir valores nulos na saída JSON da cláusula FOR JSON , 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 que são nulos nos resultados da consulta.

Exemplos

O exemplo a seguir mostra a saída da cláusula FOR JSON 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 }

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

Consulta

SELECT name, surname  
FROM emp  
FOR JSON AUTO, INCLUDE_NULL_VALUES    

Resultado

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

Saiba mais sobre JSON no SQL Server e no Banco de Dados SQL do Azure

Vídeos da Microsoft

Observação

Alguns dos links de vídeo nesta seção podem não funcionar no momento. A Microsoft está migrando conteúdo armazenado anteriormente no Canal 9 para uma nova plataforma. Atualizaremos os links à medida que os vídeos forem migrados para a nova plataforma.

Para obter uma introdução visual ao suporte interno para JSON no SQL Server e no Banco de Dados SQL do Azure, consulte os seguintes vídeos:

Confira também

Cláusula FOR (Transact-SQL)