SQLite
 sql >> Base de Dados >  >> RDS >> SQLite

Funções e operadores JSON no SQLite (lista completa)


Abaixo está uma lista completa de funções JSON e operadores JSON disponíveis no SQLite.

Funções escalares

Função Descrição
json() Retorna uma versão reduzida de seu argumento (string JSON) como JSON real. Basicamente, ele converte texto bruto que se parece com JSON em JSON real.
json_array() Retorna uma matriz JSON bem formada com base em seus argumentos.
json_array_length() Retorna o número de elementos em uma determinada matriz JSON.
json_extract() Extrai e retorna um ou mais valores de JSON bem formado.
json_insert() Insere um novo valor em um documento JSON.
json_object() Retorna um objeto JSON bem formado com base em seus argumentos.
json_patch() Adiciona, modifica e/ou exclui elementos de um objeto JSON (ele executa o algoritmo MergePatch RFC-7396 para aplicar um determinado patch em uma determinada entrada JSON).
json_remove() Remove um ou mais elementos de um objeto ou matriz JSON.
json_replace() Substitui um valor existente em um documento JSON por outro valor.
json_set() Insere ou substitui um valor em um documento JSON.
json_type() Retorna o tipo do elemento mais externo do JSON fornecido.
json_valid() Verifica se o argumento é JSON bem formado.
json_quote() Converte um número ou string em sua representação JSON correspondente.

Funções agregadas

Função Descrição
json_group_array() Retorna uma matriz JSON composta por todos os valores na agregação.
json_group_object() Retorna um objeto JSON composto por todos os pares de nome/valor na agregação.

Funções com valor de tabela

Função Descrição
json_each() Percorre o valor JSON fornecido como seu primeiro argumento e retorna uma tabela que consiste em uma linha para cada elemento da matriz ou membro do objeto. Ele apenas percorre os filhos imediatos do array ou objeto de nível superior, ou apenas o próprio elemento de nível superior se o elemento de nível superior for um valor primitivo.
json_tree() Percorre o valor JSON fornecido como seu primeiro argumento e retorna uma tabela que consiste em uma linha para cada elemento da matriz ou membro do objeto. Ele percorre recursivamente a subestrutura JSON começando com o elemento de nível superior.

Operadores JSON


SQLite também inclui os seguintes operadores para trabalhar com JSON:
Operador Descrição
-> Extrai um subcomponente de um documento JSON e retorna uma representação JSON desse subcomponente.
->> Extrai um subcomponente de um documento JSON e retorna uma representação SQL desse subcomponente.

Suporte a JSON no SQLite


A partir do SQLite 3.38.0 (lançado em 22 de fevereiro de 2022), as funções e operadores JSON são integrados ao SQLite. Antes do SQLite 3.38.0, você precisaria usar o -DSQLITE_ENABLE_JSON1 opção de tempo de compilação para habilitar o suporte a JSON.