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_ARRAY_LENGTH

Retorna o número de elementos de um array JSON.

Veja também:
[SELECT] [DESCRIBE] [JSON_EXTRACT] [ 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.

Sintaxe​

SELECT JSON_ARRAY_LENGTH(json_array_or_object [, json_path]) FROM <multipartIdentifier>;

Argumentos​

json_array_or_object
Um array ou objeto JSON.

Se json_array_or_object for um objeto JSON (e não um array) e json_path não for especificado, a função retorna 0.

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

Se json_path for informado, a função json_array_length localiza o caminho dentro de json_array_or_object e retorna o comprimento do array, ou 0 se json_path for um objeto (e não um array). Se json_path não puder ser localizado dentro de json_array_or_object, a função retorna NULL.

Se json_array_or_object ou json_path não forem objetos JSON ou não forem bem formados, a função gera um erro.

Valor(es) retornado(s)​

Retorna um inteiro.


Exemplos​

Retornar o número de discos anexados a instâncias do Google Compute Engine​

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

Retornar o número de interfaces de rede anexadas a instâncias do Google Compute Engine​

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

Retornar o número de ACLs associadas a buckets do Google Storage​

SELECT name, json_array_length(acl) as num_acls
FROM google.storage.buckets
WHERE project = 'stackql';

Retornar o número de escopos associados a uma conta de serviço​

SELECT name, json_array_length(serviceAccounts, '$[0].scopes') as num_scopes
FROM google.compute.instances
WHERE project = 'stackql-demo'
AND zone = 'australia-southeast1-a';

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