JSON.ARRLEN - Amazon ElastiCache

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

JSON.ARRLEN

Obtém o comprimento dos valores da matriz no caminho.

Sintaxe

JSON.ARRLEN <key> [path]

  • chave (obrigatório): uma chave do Valkey ou Redis OSS do tipo de documento JSON.

  • path (opcional): um caminho JSON. Assumirá o padrão da raiz se não for fornecido.

Return

Se o caminho for uma sintaxe aprimorada:

  • Matriz de inteiros que representam o comprimento da matriz em cada caminho.

  • Se um valor não for uma matriz, seu valor de retorno correspondente será nulo.

  • Nulo se a chave do documento não existir.

Se o caminho for uma sintaxe restrita:

  • Inteiro, comprimento da matriz.

  • Se vários objetos forem selecionados, o comando retornará o comprimento da primeira matriz.

  • Erro WRONGTYPE se o valor no caminho não for uma matriz.

  • NONEXISTENT JSON erro se o caminho não existir.

  • Nulo se a chave do documento não existir.

Exemplos

Sintaxe do caminho aprimorada:

127.0.0.1:6379> JSON.SET k1 . '[[], ["a"], ["a", "b"], ["a", "b", "c"]]'
OK
127.0.0.1:6379> JSON.ARRLEN k1 $[*]
1) (integer) 0
2) (integer) 1
3) (integer) 2
4) (integer) 3

127.0.0.1:6379> JSON.SET k2 . '[[], "a", ["a", "b"], ["a", "b", "c"], 4]'
OK
127.0.0.1:6379> JSON.ARRLEN k2 $[*]
1) (integer) 0
2) (nil)
3) (integer) 2
4) (integer) 3
5) (nil)

Sintaxe do caminho restrita:

127.0.0.1:6379> JSON.SET k1 . '[[], ["a"], ["a", "b"], ["a", "b", "c"]]' 
OK 
127.0.0.1:6379> JSON.ARRLEN k1 [*] 
(integer) 0 
127.0.0.1:6379> JSON.ARRLEN k1 [1] 
(integer) 1 
127.0.0.1:6379> JSON.ARRLEN k1 [2] 
(integer) 2

127.0.0.1:6379> JSON.SET k2 . '[[], "a", ["a", "b"], ["a", "b", "c"], 4]' 
OK
127.0.0.1:6379> JSON.ARRLEN k2 [1] 
(error) WRONGTYPE JSON element is not an array 
127.0.0.1:6379> JSON.ARRLEN k2 [0] 
(integer) 0
127.0.0.1:6379> JSON.ARRLEN k2 [6] 
(error) OUTOFBOUNDARIES Array index is out of bounds
127.0.0.1:6379> JSON.ARRLEN k2 a.b 
(error) NONEXISTENT JSON path does not exist