Como utilizar as funções JSON do SQL Server? T-SQL

Introdução às funções de valor, consulta e modificação JSON do SQL Server.

No mundo da gestão de dados e TI, incluindo, claro, o SQL Server, o uso de JSON (JavaScript Object Notation) tornou-se cada vez mais popular devido ao seu formato leve de troca de dados. Como resultado, o SQL Server incorporou um conjunto de funções JSON do SQL Server no T-SQL para lidar com dados JSON. Este tutorial irá guiá-lo sobre como usar essas funções, começando pelos conceitos básicos e avançando gradualmente para exemplos mais complexos.

Table of Contents

1. Compreendendo o formato de dados JSON no SQL Server

Antes de mergulhar nas funções MS SQL JSON, é crucial entender o que são os dados JSON. Os dados JSON são um formato de texto que é completamente independente de linguagem, mas usa convenções familiares aos programadores da família de linguagens C. No SQL, o JSON é armazenado como tipo NVARCHAR. Veja como criar uma tabela com dados JSON:

 CREATE TABLE Employees (
     ID INT IDENTITY(1,1),
     Info NVARCHAR(4000)
 )
 INSERT INTO Employees (Info)
 VALUES ('{"Name": "John", "Age": 25, "Department": "Sales"}'),
        ('{"Name": "Jane", "Age": 30, "Department": "Marketing"}')

2. A função JSON_VALUE no SQL Server

Sobre as funções JSON Transact-SQL, uma das funções principais que se destaca é a JSON_VALUE. Projetada com um propósito simples, a função JSON_VALUE serve ao papel específico de extrair valores escalares de uma string JSON abrangente. Valores escalares, neste contexto, referem-se a pontos de dados únicos e não repetidos na estrutura JSON, como inteiros, booleanos ou strings

A primeira função a explorar nas funções JSON Transact-SQL é a JSON_VALUE. Esta função extrai um valor escalar de uma string JSON. Aqui está um exemplo simples com uma consulta que retornará apenas os nomes dos funcionários dos dados JSON.

 SELECT JSON_VALUE(Info, '$.Name') AS EmployeeName
 FROM Employees

3. Trabalhando com JSON_QUERY no MS SQL

JSON_QUERY é outra função no conjunto de funções JSON do SQL Server. Ao contrário de JSON_VALUE, JSON_QUERY extrai um objeto ou uma matriz de uma string JSON. Veja abaixo um exemplo básico de como usá-lo. Esta consulta retornará todos os dados JSON de cada funcionário.

 SELECT JSON_QUERY(Info, '$') AS EmployeeInfo
 FROM Employees

4. Explorando a função ISJSON no T-SQL

Na suíte de funções JSON do T-SQL, o ISJSON é uma ferramenta prática. Seu principal papel é verificar a validade de uma string como formato JSON adequado. Ao ser apresentado com uma string, o ISJSON retornará um valor de 1 se a string aderir ao padrão JSON e 0 se não.

Para entender melhor sua aplicação, considere o seguinte cenário: um banco de dados contém uma tabela chamada Employees e, dentro desta tabela, há uma coluna chamada Info. Cada entrada na coluna Info deve estar no formato JSON. Se houver a necessidade de validar esses dados, a função ISJSON pode ser empregada.

 SELECT ISJSON(Info) AS IsJson
 FROM Employees

Um resultado de 1 indicaria que o campo ‘Info’ correspondente contém uma string JSON válida. Se o banco de dados for bem mantido e consistente, podemos antecipar ver um 1 para cada registro, significando que todas as entradas ‘Info’ são JSON válidas.

5. Usando a função JSON_MODIFY no SQL Server

A função JSON_MODIFY no conjunto de funções JSON do SQL Server permite modificar um valor em uma string JSON. Esta consulta atualizará a idade de John para 26 nos dados JSON.

 UPDATE Employees
 SET Info = JSON_MODIFY(Info, '$.Age', 26)
 WHERE JSON_VALUE(Info, '$.Name') = 'John'

Conclusão sobre as funções JSON do SQL Server

Em conclusão, o SQL Server fornece um conjunto robusto de funções JSON para trabalhar com dados JSON. Essas funções fornecem uma maneira perfeita de integrar o tratamento de dados JSON nas suas operações SQL. Seja extraindo valores, modificando dados ou validando strings JSON, essas funções facilitam e tornam mais eficiente. Ao dominar essas funções JSON do SQL Server, você será capaz de lidar com dados JSON com facilidade e eficiência no seu banco de dados SQL Server.

Claro que o SQL Server, como o Python, também permite aos usuários inserir ou remover quebras de linha no texto do usando funções nativas T-SQL.

Como inserir ou remover quebras de linha no texto do SQL Server?

Para leituras adicionais, você pode querer verificar a documentação oficial da Microsoft sobre funções JSON. Outro ótimo recurso é este tutorial da W3Schools sobre SQL e JSON.