Função JSON_PRETTY() do MySQL

Resumo : neste tutorial, você aprenderá como usar a JSON_PRETTY()função MySQL para formatar dados JSON para melhor legibilidade.

Introdução à função JSON_PRETTY() do MySQL

A JSON_PRETTY()função é usada para formatar dados JSON para melhor legibilidade. Torna a saída de dados JSON mais amigável, adicionando recuo, novas linhas e formatação adequada.

Aqui está a sintaxe da JSON_PRETTY()função:

JSON_PRETTY(json_val)Linguagem de código:  SQL (linguagem de consulta estruturada)  ( sql )

Nesta sintaxe:

• json_val: este é o valor JSON que você deseja imprimir. Pode ser um valor JSON válido ou uma representação de string de um valor JSON.

A função retorna NULL se json_val for NULL. Se json_value não for um documento JSON válido, a função falhará com um erro.

A JSON_PRETTY()função formata dados JSON de acordo com as seguintes regras:

• Cada elemento da matriz ou membro do objeto é exibido em uma nova linha, recuado um nível mais profundo que seu pai.
• Para cada nível de recuo, dois espaços iniciais são adicionados.
• Uma vírgula, que separa elementos individuais da matriz ou membros do objeto, precede a nova linha que os separa.
• As chaves e os valores dos membros do objeto são separados por dois pontos seguidos de um espaço ( ': ').
• Um objeto ou array vazio é representado em uma única linha sem espaços entre as chaves de abertura e fechamento.
• Caracteres especiais em escalares de string e nomes de chaves são escapados pelas regras usadas pela JSON_QUOTE()função.

Exemplos de funções JSON_PRETTY() do MySQL

Vejamos alguns exemplos de uso da JSON_PRETTY()função.

1) Formatando um valor escalar

O exemplo a seguir usa a JSON_PRETTY()função para formatar um valor escalar 1:

SELECT JSON_PRETTY('1');Linguagem de código:  SQL (linguagem de consulta estruturada)  ( sql )

Saída:

+------------------+
| JSON_PRETTY('1') |
+------------------+
| 1                |
+------------------+
1 row in set (0.00 sec)Linguagem de código:  SQL (linguagem de consulta estruturada)  ( sql )

2) Usando a função MySQL JSON_PRETTY() para imprimir um array

O exemplo a seguir usa a JSON_PRETTY()função para formatar uma matriz JSON de strings:

SELECT 
  JSON_PRETTY('["apple","orange","banana"]') result;Linguagem de código:  SQL (linguagem de consulta estruturada)  ( sql )

Saída:

+---------------------------------------+
| result                                |
+---------------------------------------+
| [
  "apple",
  "orange",
  "banana"
] |
+---------------------------------------+
1 row in set (0.00 sec)Linguagem de código:  SQL (linguagem de consulta estruturada)  ( sql )

3) Usando a função MySQL JSON_PRETTY() para imprimir um objeto

O exemplo a seguir usa a JSON_PRETTY()função para formatar um objeto:

SELECT 
  JSON_PRETTY('{"name": "John", "age": 22, "job": "MySQL DBA"}') resultLinguagem de código:  SQL (linguagem de consulta estruturada)  ( sql )

Saída:

+---------------------------------------------------------+
| result                                                  |
+---------------------------------------------------------+
| {
  "age": 22,
  "job": "MySQL DBA",
  "name": "John"
} |
+---------------------------------------------------------+
1 row in set (0.00 sec)Linguagem de código:  SQL (linguagem de consulta estruturada)  ( sql )

4) Impressão bonita de um documento JSON complexo

O exemplo a seguir usa a JSON_PRETTY()função para formatar um objeto que inclui um membro que é uma matriz:

SELECT 
  JSON_PRETTY(
    '{"name": "John", "age": 22, "job": "MySQL DBA", "skills": ["Linux","SQL"]}'
  ) result;Linguagem de código:  SQL (linguagem de consulta estruturada)  ( sql )

Saída:

+---------------------------------------------------------------------------------------------------+
| result                                                                                            |
+---------------------------------------------------------------------------------------------------+
| {
  "age": 22,
  "job": "MySQL DBA",
  "name": "John",
  "skills": [
    "Linux",
    "SQL"
  ]
} |
+---------------------------------------------------------------------------------------------------+
1 row in set (0.00 sec)Linguagem de código:  SQL (linguagem de consulta estruturada)  ( sql )

Resumo

• Use a JSON_PRETTY()função para formatar dados JSON para melhor legibilidade.