Partilhar via


Como o FOR JSON converte tipos de dados do SQL Server em tipos de dados JSON

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

A FOR JSON cláusula usa as seguintes regras para converter tipos de dados do SQL Server em tipos JSON na saída JSON.

Category Tipo de dados do SQL Server Tipo de dados JSON
Tipos de caracteres e cadeias char, nchar, varchar, nvarchar cadeia (de caracteres)
Tipos numéricos int, bigint, float, decimal, numérico number
Tipo de bit bit Booleano (verdadeiro ou falso)
Tipos de data e hora Data, Datahora, Datahora2, Hora, DataHoraOffset cadeia (de caracteres)
Tipos binários varbinary, binário, imagem, timestamp/rowversion String codificada em BASE64
Tipos de CLR geometria, geografia, outros tipos de CLR Não suportado. Esses tipos retornam um erro.

SELECT Na instrução, use CAST ou CONVERT, ou use uma propriedade ou método CLR, para converter os dados de origem em um tipo de dados do SQL Server que pode ser convertido com êxito em um tipo JSON. Por exemplo, use STAsText() para o tipo de geometria ou use ToString() para qualquer tipo CLR. O tipo do valor de saída JSON é então derivado do tipo de retorno da conversão que você aplica na SELECT instrução.
Outros tipos identificador único, dinheiro cadeia (de caracteres)

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: