Este tutorial MySQL JSON ajuda você a obter uma compreensão profunda do tipo de dados JSON e suas funções associadas.
Ao final deste tutorial, você será proficiente no trabalho com dados JSON no MySQL, desde o armazenamento e recuperação de documentos JSON até a execução de tarefas avançadas de consulta e manipulação.
Seção 1: Introdução ao JSON no MySQL
Esta seção apresenta o tipo de dados JSON no MySQL e uma breve visão geral de algumas funções JSON úteis.
- Tipo de dados JSON – Introdução ao tipo de dados JSON no MySQL.
- JSON_ARRAY() – Crie arrays JSON a partir de uma lista de valores.
- JSON_OBJECT() – Crie objetos JSON a partir de valores de pares de chaves.
Seção 2: Pesquisando em documentos JSON
Nesta seção, você aprenderá como construir expressões de caminho JSON e usá-las para pesquisar dados em documentos JSON.
- Caminho JSON – mostra como construir expressões de caminho JSON para navegar pelos elementos ou especificar um dado em um documento JSON.
- JSON_CONTAINS_PATH() – Verifique se um documento JSON contém caminhos especificados.
- JSON_CONTAINS() – mostra como verificar se um documento JSON contém outro documento JSON em um caminho especificado.
- JSON_OVERLAPS() – Compare dois documentos JSON e retorne verdadeiro se os dois documentos tiverem pares de valores-chave ou elementos de array em comum.
- JSON_SEARCH() – Retorna um caminho que corresponde a uma determinada string em um documento JSON.
- JSON_KEYS() – Aprenda como obter as chaves especificadas por um caminho em um documento JSON.
Seção 3: Modificando Documentos JSON
Esta seção mostra como modificar um documento JSON inserindo valores, substituindo valores existentes por novos ou adicionando valores não existentes a um documento JSON.
- JSON_INSERT() – Insira um ou mais valores em um documento JSON sem substituir os valores existentes.
- JSON_REPLACE() – Substitua apenas os valores existentes em um documento JSON por novos valores.
- JSON_SET() – Substitua valores existentes e adicione valores não existentes a um documento JSON.
- JSON_REMOVE() – Remove elementos de um documento JSON.
- JSON_MERGE_PATCH() – Mescla dois ou mais documentos JSON em um único documento JSON enquanto descarta chaves duplicadas.
- JSON_MERGE_PRESERVE() – Mescla dois ou mais documentos JSON em um único documento JSON, preservando a estrutura do documento JSON original.
Seção 4: Consultando documentos JSON
- JSON_EXTRACT() – Recupera dados JSON usando as funções JSON_EXTRACT e JSON_UNQUOTE, bem como os operadores -> e ->>.
- JSON_VALUE() – Extraia um valor em um caminho específico de um documento JSON e, opcionalmente, converta-o em um valor do tipo desejado.
Seção 5. Trabalhando com matrizes JSON
Nesta seção, você aprenderá sobre funções que lidam com matrizes JSON, incluindo a criação de matrizes JSON, o acréscimo de um elemento a uma matriz e a inserção de elementos em uma matriz.
- JSON_ARRAY_APPEND() – Anexa um ou mais elementos no final de uma matriz JSON em um documento JSON.
- JSON_ARRAY_INSERT() – Insira um ou mais elementos em uma posição especificada em uma matriz JSON dentro de um documento JSON.
- MEMBER OF – Determine se um valor é membro de uma matriz JSON.
Seção 6: Agregando dados JSON
Esta seção apresenta duas funções agregadas que agregam dados em matrizes JSON e objetos JSON.
- JSON_ARRAYAGG() – agrega valores em um array JSON.
- JSON_OBJECTAGG() – agrega pares de valores-chave de colunas em um objeto JSON.
Seção 7: Indexação de dados JSON
- Indexação JSON – mostra como usar índices funcionais para indexar dados JSON para recuperação JSON mais rápida.
Seção 8: Obtendo atributos de valores JSON
Esta seção apresenta funções que obtêm os atributos dos valores JSON.
- JSON_TYPE() – Obtenha o tipo de um valor JSON.
- JSON_LENGTH() – Obtenha o comprimento de um documento JSON ou um valor identificado por um caminho dentro de um documento JSON.
- JSON_DEPTH() – Obtenha a profundidade de um documento JSON.
Seção 9: Funções da tabela JSON
Esta seção apresenta funções que convertem dados JSON em dados tabulares.
- JSON_TABLE() – Converte documentos JSON em dados tabulares.
Seção 10: Funções de validação JSON
Esta seção apresenta algumas das funções do utilitário JSON.
- JSON_VALID() – Verifique se um valor é um documento JSON válido.
- JSON_SCHEMA_VALID() – Valide um documento JSON com base em um esquema JSON.
- JSON_SCHEMA_VALIDATION_REPORT – Valide um documento JSON com base em um esquema JSON e relate o motivo das violações de validação.
Seção 11: Funções do utilitário JSON
Esta seção apresenta algumas das funções do utilitário JSON.
- JSON_PRETTY() – Dados JSON de impressão bonita para melhor legibilidade.
- JSON_STORAGE_SIZE() – Obtenha o tamanho de armazenamento em bytes de dados JSON.
- JSON_STORAGE_FREE() – Obtenha quanto espaço foi liberado após a atualização para um valor de coluna JSON.
- JSON_QUOTE() – cite uma string como um valor JSON envolvendo-a entre aspas duplas e escapando de aspas internas e outros caracteres.
- JSON_UNQUOTE() – Remova aspas duplas de um valor JSON.