Hoje vamos falar um pouco sobre um assunto muito desejado e esperado, tanto por desenvolvedores quanto por DBAs.
O MySQL suporta armazenar documentos JSON????
A resposta é um grande e sonoro SIM!!!
Na versão 5.7.8 foi adicionado o data type JSON e com ele você pode armazenar e manipular documentos JSON.

Isso significa que posso fazer no MySQL tudo que faço no MongoDB?

Não, pelo menos por enquanto não. Eu ainda não vejo dessa forma, na maturidade atual do recurso ele já pode ajudar muito a suprir algumas necessidades em armazenar e manipular documentos JSON, mas não temos(ainda!?) uma engine completa e altamente robusta para isso!

Vamos ver alguns exemplos de como armazenar, buscar e manipular documentos JSON. Em um próximo POST vou falar sobre performance e melhores práticas.

Para esse exemplo estou utilizando o MySQL 5.7.11 que foi instalado no Ubuntu 15.10.
Veja como fazer instalação do MySQL 5.7 em alguns ambientes que não sejam derivados do RedHat e do Debian.
FreeBSD
SlackWare
Ubuntu 15.10

Criando uma tabela e uma coluna com o data type JSON

Copy to Clipboard

Mas Diego, por que utilizar o data type JSON se podemos utilizar o TEXT ou o BLOB?
A resposta é simples, utilizando o data type JSON você ganha algumas ferramentas valiosas, como uma validação dos documentos, ou seja, nada de gravar documentos incompletos ou com erro de sintaxe, ganha opção de realizar busca e manipulação dos documentos sem o uso de REGEXP, o que vai facilitar muito a sua vida, sem contar com os recursos de performance(que vou falar em outro post).

Inserindo os dados

Copy to Clipboard

 

Mas também podemos inserir um array de objetos.

Copy to Clipboard

 

O MySQL vai tratar como types diferentes.

 

Para os próximo exemplos vou alterar os dados da tabela pessoas.

Copy to Clipboard

Selecionando e filtrando dados dos documentos JSON

Assim como já acontece em outras linguagens de programação e outros bancos de dados que manipulam documentos JSON, o caracter sifrão($) é utilizado para representar o documento, e após podem ser utilizados seletores.

JSON_EXTRACT

Retorna o valor de uma chave do documento.

Copy to Clipboard

 

Copy to Clipboard

 

Mais alguns exemplos

Copy to Clipboard
JSON_UNQUOTE

Remove as aspas quando o valor de uma chave for string.

Copy to Clipboard
 JSON_KEYS

Retornas as chaves de um documento.

Copy to Clipboard
JSON_LENGTH

Retorna a quantidade de chaves que existem no documento, ou a partir de uma profundidade específica.

Copy to Clipboard

 

Da para utilizar essa função para saber se uma chave existe, isso pode ser bem útil, já que o que eu mais escuto é que o “bom” de armazenar documentos, cada um pode ter uma estrutura diferente.

Copy to Clipboard
JSON_SEARCH

Retorna o path de um valor que será buscado no documento. Caso o valor não seja localizado, o valor NULL será retornado. o primeiro parâmetro é o documento JSON, o segundo deve ser o valor “one” ou o valor “all”, caso o valor do segundo parâmetro seja “one”, a função irá retornar a primeira chave(elemento) que possui esse valor, e caso o valor do parâmetro seja “all”, será retornada todas as chaves(elementos) que possuem o valor, o terceiro parâmetro é a string que será buscada e aqui é necessário uma atenção especial, pois o valor que será buscado é case sensitive., o quarto valor é o caracter de escape que deve ser utilizado para realizar a busca, caso não tenho o valor NULL deve ser informado, esse parâmetro é opcional, o quinto parâmetro é o path que a busca deve ser realizada, esse parâmetro também não é obrigatório.

Para entender melhor o diferença dos valores “one”e “all”no segundo parâmetro faça esse teste.

Copy to Clipboard

 

Veja como fazer para selecionar quem tem o valor “D” informado no elemento areas_interesse.

Copy to Clipboard

 

Ou quem é da cidade de Curitiba.

Copy to Clipboard

Adicionando Elementos em um documento JSON

JSON_SET

Insere ou altera um elemento no documento. Sua utilização é bem simples, e ela recebe 3 elementos. O primeiro é o documento, o segundo é o path e nome do novo elemento, e o terceiro é o valor.

Copy to Clipboard

 

Agora que temos um data em nosso documento, também podemos realizar pesquisas por datas, pois o MySQL indexa as datas nos formatos DATE, DATETIME ou TIMESTAMP.

JSON_ARRAY_APPEND

Adiciona um novo elemento em um array.

 

Copy to Clipboard

 

JSON_REMOVE

Remove uma chave ou um elemento de um array.

Removendo uma chave

 

Copy to Clipboard
Removendo um elemento de um array

Para remover um elemento de um array é necessário informar a posição do elemento, essa posição é o índice interno do array. O primeiro elemento sempre é o índice 0(zero) e assim por diante, sempre incrementando 1.
Para facilitar essa remoção eu utilizei outra função que já falei nesse artigo, que é a função JSON_SEARCH.

 

Vamos remover o elemento “E”.

Copy to Clipboard

 

Veja que também foi necessário utilizar a função JSON_UNQUOTE para remover as aspas, assim fazendo a função JSON_REMOVE remover o elemento corretamente.

 

Eu busquei fazer os exemplos para atender a uma necessidade, mas além das funções que mostrei aqui existe outras, veja mais em https://dev.mysql.com/doc/refman/5.7/en/json-modification-functions.htmlhttps://dev.mysql.com/doc/refman/5.7/en/json.html

Espero que esse artigo ajude vocês, e em breve irei fazer outro falando da performance e dicas para melhores práticas.

Gostou? compartilha esse artigo ai :)
Curta a página da PerformanceDB no Facebook e receba sempre em primeira mão os novos artigos.