Partilhar via

Incluir valores nulos em JSON - opção INCLUDE_NULL_VALUES

  • Artigo

Aplica-se a: SQL Server 2016 (13.x) e posterior Banco de Dados SQL do AzureInstância Gerenciada SQL do Azure do Azure Synapse Analytics (somente pool 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 incluirá propriedades para valores que são nulos nos resultados da consulta.

Exemplos

O exemplo seguinte mostra o resultado 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 }

Aqui está 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 anteriormente no Channel 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 JSON interno no SQL Server e no Banco de Dados SQL do Azure, consulte os seguintes vídeos:

Ver também

PARA Cláusula (Transact-SQL)