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_EACH

Função com valor de tabela que retorna uma tabela com uma linha para cada elemento do array ou membro do objeto.

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


dica

Use a instrução DESCRIBE para localizar os tipos de dados array que podem ser usados com a função json_each.

observação

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

Sintaxe​

SELECT <alias>.<projectedField>, ... , json_each.value
FROM <multipartIdentifier> <alias>, JSON_EACH(json_array_or_object, json_path);

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 json_path não existir em json_array_or_object, a função não retorna nenhuma linha.

A função json_each() gera um erro se json_array_or_object não for um JSON bem formado.

Valor(es) retornado(s)​

Uma tabela com uma linha para cada elemento do array ou membro do objeto.


Exemplos​

Expandir um array de strings em uma tabela combinada com os campos associados​

para contexto:

describe google.cloudresourcemanager.projects_iam_policies;

retorna...

|-----------|--------|
| name | type |
|-----------|--------|
| condition | object |
|-----------|--------|
| members | array |
|-----------|--------|
| role | string |
|-----------|--------|

A consulta stackql a seguir usa a função json_each para expandir o array members em uma tabela combinada com os campos role e, opcionalmente, condition.

select
iam.role,
SPLIT_PART(json_each.value, ':', 2) as member
from google.cloudresourcemanager.projects_iam_policies iam, json_each(members)
where projectsId = 'stackql';

retornaria...

|--------------------------------------|-------------------------------------------------------|
| role | member |
|--------------------------------------|-------------------------------------------------------|
| roles/cloudbuild.builds.builder | 1234567890@cloudbuild.gserviceaccount.com |
|--------------------------------------|---------------------------------------------- --------|
| roles/editor | 1234567890-compute@developer.gserviceaccount.com |
|--------------------------------------|-------------------------------------------------------|
| roles/editor | 1234567890@cloudservices.gserviceaccount.com |
|--------------------------------------|-------------------------------------------------------|
| roles/editor | stackql@appspot.gserviceaccount.com |
|--------------------------------------|-------------------------------------------------------|
| ... | ... |
|--------------------------------------|-------------------------------------------------------|

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