Pular para o conteúdo principal
Página traduzida

Esta página foi traduzida do inglês com assistência de IA. Se houver diferenças entre as duas, a versão em inglês é a referência.

JSON_EXTRACT

Retorna um ou mais valores de um objeto ou array JSON bem formado.

Veja também:
[SELECT] [DESCRIBE] [JSON_ARRAY_LENGTH] [ Tipos de dados ]


dica

Use a instrução DESCRIBE para localizar os tipos de dados array ou object que podem ser usados com as funções JSON do StackQL. Use a função JSON_TYPE para resolver os tipos de dados de objetos aninhados ou de elementos de arrays.

observação

A função json_extract é implementada como a função json_extract_path_text se você usa o stackql com um backend SQL postgres

Sintaxe​

SELECT JSON_EXTRACT(json_array_or_object, json_path[, json_path1, .. json_pathN])
FROM <multipartIdentifier>;

Argumentos​

json_array_or_object
Um array ou objeto JSON.

json_path
O caminho JSON para um array ou objeto contido em um json_array_or_object. Consulte jsonpath.com.

Se um único json_path for informado, a função retorna um resultado escalar que corresponde ao tipo de dados do caminho resolvido.

Se vários argumentos json_path forem informados, o resultado será um array composto pelos objetos resolvidos pelos respectivos caminhos.

Especificar '$' no argumento json_path retorna o objeto JSON inteiro correspondente à coluna representada pelo argumento json_array_or_object.

NOTA: você pode usar ferramentas como json-viewer para desenvolver e testar expressões JSON Path

Valor(es) retornado(s)​

Uma string, um inteiro, um objeto, um array, um booleano ou null, dependendo do json_array_or_object e do json_path informados como entrada.


Exemplos​

Retornar os objetos de disco associados a cada instância do Google Compute Engine​

SELECT name, json_extract(disks, '$') as disks
FROM google.compute.instances
WHERE project = 'stackql-demo'
AND zone = 'australia-southeast1-a';

Retornar o nome do dispositivo e o tamanho do primeiro disco anexado a cada instância do Google Compute Engine​

SELECT name, json_extract(disks, '$[0].deviceName') as device_name,
json_extract(disks, '$[0].diskSizeGb') as disk_size
FROM google.compute.instances
WHERE project = 'stackql-demo'
AND zone = 'australia-southeast1-a';

Retornar o nível de rede da primeira NIC anexada a cada instância do Google Compute Engine​

SELECT name, json_extract(networkInterfaces, '$[0].accessConfigs[0].networkTier') as network_tier
FROM google.compute.instances
WHERE project = 'stackql-demo'
AND zone = 'australia-southeast1-a';

Retornar uma lista de escopos associados à primeira conta de serviço associada a cada instância do Google Compute Engine​

SELECT name, json_extract(serviceAccounts, '$[0].scopes') as scopes
FROM google.compute.instances
WHERE project = 'stackql-demo'
AND zone = 'australia-southeast1-a';
/* returns a list for each service account */

Para obter mais informações, consulte https://www.sqlite.org/json1.html#jex