Introdução aos recursos JSON

Aplica-se a:Banco de dados SQL do Azure Instância Gerenciada de SQL do Azure Banco de Dados SQL no Microsoft Fabric

O Banco de Dados SQL do Azure, o Banco de Dados SQL no Microsoft Fabric e a Instância Gerenciada de SQL do Azure permitem analisar e consultar dados representados no formato JSON ( JavaScript Object Notation) e exportar seus dados relacionais como texto JSON. Os seguintes cenários JSON estão disponíveis:

Formatação de dados relacional no formato JSON usando FOR JSON cláusula.
Trabalhando com dados JSON
Consultando dados JSON usando funções escalares JSON.
Transformando JSON em formato tabular usando a função OPENJSON.

Formatar dados relacionais no formato JSON

Se você tiver um serviço Web que usa dados da camada de banco de dados e fornece uma resposta no formato JSON ou bibliotecas ou estruturas JavaScript do lado do cliente que aceitam dados formatados como JSON, você pode formatar o conteúdo do banco de dados como JSON diretamente em uma consulta SQL. Você não precisa mais escrever o código do aplicativo que formata os resultados como JSON ou incluir alguma biblioteca de serialização JSON para converter resultados de consulta tabular e serializar objetos no formato JSON. Em vez disso, você pode usar a FOR JSON cláusula para formatar os resultados da consulta SQL como JSON e usá-la diretamente em seu aplicativo.

No exemplo a seguir, as linhas da tabela Sales.Customer são formatadas como JSON usando a cláusula FOR JSON:

select CustomerName, PhoneNumber, FaxNumber
from Sales.Customers
FOR JSON PATH

A FOR JSON PATH cláusula formata os resultados da consulta como texto JSON. Nomes de coluna são usados como chaves, enquanto os valores de célula são gerados como valores JSON:

[
{"CustomerName":"Eric Torres","PhoneNumber":"(307) 555-0100","FaxNumber":"(307) 555-0101"},
{"CustomerName":"Cosmina Vlad","PhoneNumber":"(505) 555-0100","FaxNumber":"(505) 555-0101"},
{"CustomerName":"Bala Dixit","PhoneNumber":"(209) 555-0100","FaxNumber":"(209) 555-0101"}
]

O conjunto de resultados é formatado como uma matriz JSON em que cada linha é formatada como um objeto JSON separado.

PATH indica que você pode personalizar o formato de saída do seu resultado JSON usando a notação de ponto nos nomes de coluna. A consulta a seguir altera o nome da CustomerName chave no formato JSON de saída e coloca números de telefone e fax no Contact sub-objeto:

select CustomerName as Name, PhoneNumber as [Contact.Phone], FaxNumber as [Contact.Fax]
from Sales.Customers
where CustomerID = 931
FOR JSON PATH, WITHOUT_ARRAY_WRAPPER

A saída dessa consulta tem o seguinte aspecto:

{
    "Name":"Nada Jovanovic",
    "Contact":{
           "Phone":"(215) 555-0100",
           "Fax":"(215) 555-0101"
    }
}

Neste exemplo é retornado um único objeto JSON em vez de uma matriz, especificando a opção WITHOUT_ARRAY_WRAPPER. Você pode usar essa opção se souber que está retornando um único objeto como resultado da consulta.

O principal valor da FOR JSON cláusula é que ela permite que você retorne dados hierárquicos complexos do banco de dados formatados como objetos ou matrizes JSON aninhados. O exemplo a seguir mostra como incluir as linhas da tabela Orders que pertencem ao Customer como uma matriz aninhada de Orders:

select CustomerName as Name, PhoneNumber as Phone, FaxNumber as Fax,
        Orders.OrderID, Orders.OrderDate, Orders.ExpectedDeliveryDate
from Sales.Customers Customer
    join Sales.Orders Orders
        on Customer.CustomerID = Orders.CustomerID
where Customer.CustomerID = 931
FOR JSON AUTO, WITHOUT_ARRAY_WRAPPER

Em vez de enviar consultas separadas para obter os dados Customer e buscar uma lista de Orders relacionados, você pode obter todos os dados necessários com uma única consulta, como demonstrado no exemplo de saída a seguir.

{
  "Name":"Nada Jovanovic",
  "Phone":"(215) 555-0100",
  "Fax":"(215) 555-0101",
  "Orders":[
    {"OrderID":382,"OrderDate":"2013-01-07","ExpectedDeliveryDate":"2013-01-08"},
    {"OrderID":395,"OrderDate":"2013-01-07","ExpectedDeliveryDate":"2013-01-08"},
    {"OrderID":1657,"OrderDate":"2013-01-31","ExpectedDeliveryDate":"2013-02-01"}
  ]
}

Trabalhar com dados JSON

Se você não tiver dados estritamente estruturados, se tiver subobjetos, matrizes ou dados hierárquicos complexos ou se suas estruturas de dados evoluem ao longo do tempo, o formato JSON pode ajudá-lo a representar qualquer estrutura de dados complexos.

JSON é um formato textual que pode ser usado como qualquer outro tipo de cadeia de caracteres. Você pode enviar ou armazenar dados JSON como um nvarchar padrão:

CREATE TABLE Products (
  Id int identity primary key,
  Title nvarchar(200),
  Data nvarchar(max)
)
go
CREATE PROCEDURE InsertProduct(@title nvarchar(200), @json nvarchar(max))
AS BEGIN
    insert into Products(Title, Data)
    values(@title, @json)
END

Os dados JSON usados neste exemplo são representados usando o tipo nvarchar(MAX ). JSON pode ser inserido nessa tabela ou fornecido como um argumento de procedimento armazenado usando sintaxe Transact-SQL padrão, conforme mostrado no exemplo a seguir:

EXEC InsertProduct 'Toy car', '{"Price":50,"Color":"White","tags":["toy","children","games"]}'

Qualquer linguagem ou biblioteca do lado do cliente que trabalhe com dados de cadeia de caracteres também funciona com dados JSON. JSON pode ser armazenado em qualquer tabela que suporta o tipo nvarchar, como uma tabela com otimização de memória ou uma tabela com versão do sistema. JSON não apresenta qualquer restrição no código do lado do cliente ou na camada de banco de dados.

Consultar dados JSON

Se você tiver dados formatados como JSON armazenados em tabelas, as funções JSON permitirão que você use esses dados em qualquer consulta SQL.

As funções do JSON permitem tratar os dados formatados como JSON como qualquer outro tipo de dados SQL. Você pode facilmente extrair valores de texto JSON e usar dados JSON em qualquer consulta:

select Id, Title, JSON_VALUE(Data, '$.Color'), JSON_QUERY(Data, '$.tags')
from Products
where JSON_VALUE(Data, '$.Color') = 'White'

update Products
set Data = JSON_MODIFY(Data, '$.Price', 60)
where Id = 1

A JSON_VALUE função extrai um valor do texto JSON armazenado na coluna Dados. Essa função usa um caminho de JavaScript para fazer referência a um valor em texto JSON para extração. O valor extraído pode ser usado em qualquer parte da consulta SQL.

A JSON_QUERY função é semelhante a JSON_VALUE. Diferentemente de JSON_VALUE, essa função extrai sub-objetos complexos, como matrizes ou objetos, que são colocados em texto JSON.

A JSON_MODIFY função permite especificar o caminho do valor no texto JSON que deve ser atualizado, bem como um novo valor que substituirá o antigo. Dessa forma você pode atualizar facilmente o texto JSON sem ter que reanalisar toda a estrutura.

Como JSON é armazenado em um texto padrão, não há nenhuma garantia de que os valores armazenados em colunas de texto estão formatados corretamente. Verifique se o texto armazenado na coluna do JSON está formatado corretamente usando restrições de verificação padrão e a função ISJSON:

ALTER TABLE Products
    ADD CONSTRAINT [Data should be formatted as JSON]
        CHECK (ISJSON(Data) > 0)

Se o texto de entrada estiver formatado corretamente JSON, a ISJSON função retornará o valor 1. Em cada inserção ou atualização de coluna JSON, essa restrição irá verificar se o novo valor de texto não é um JSON malformado.

Transformar JSON em formato tabular

É possível transformar coleções do JSON em formato tabular e carregar ou consultar dados JSON.

OPENJSON é uma função T-SQL de valor de tabela que analisa o texto JSON, localiza uma matriz de objetos JSON, itera pelos elementos da matriz e retorna uma linha no resultado de saída para cada elemento da matriz.

No exemplo, podemos especificar onde localizar a matriz JSON que deve ser aberta (no $.Orders caminho), quais colunas devem ser retornadas como resultado e onde localizar os valores JSON que serão retornados como células.

Podemos transformar uma matriz JSON na variável @orders em um conjunto de linhas, analisar o conjunto de resultados ou inserir linhas em uma tabela padrão:

CREATE PROCEDURE InsertOrders(@orders nvarchar(max))
AS BEGIN

    insert into Orders(Number, Date, Customer, Quantity)
    select Number, Date, Customer, Quantity
    FROM OPENJSON (@orders)
     WITH (
            Number varchar(200),
            Date datetime,
            Customer varchar(200),
            Quantity int
     )
END

A coleção de pedidos formatada como uma matriz JSON e fornecida como um parâmetro para o procedimento armazenado pode ser analisada e inserida na tabela Pedidos.

Dados JSON no SQL Server

Comentários

Esta página foi útil?

Last updated on 2025-11-20