JSON.STRAPPEND - 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.STRAPPEND

Acrescenta uma string às JSON strings no caminho.

Sintaxe

JSON.STRAPPEND <key> [path] <json_string>

  • chave (obrigatória) — Uma chave Valkey ou Redis do OSS tipo JSON documento.

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

  • json_string (obrigatório) — A JSON representação de uma string. Observe que uma JSON string deve estar entre aspas. Por exemplo: '"exemplo de string"'.

Return

Se o caminho for uma sintaxe aprimorada:

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

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

  • SYNTAXERRerro se o argumento json de entrada não for uma JSON string válida.

  • NONEXISTENT erro se o caminho não existir.

Se o caminho for uma sintaxe restrita:

  • Inteiro, o novo comprimento da string.

  • Se vários valores de string forem selecionados, o comando retornará o novo comprimento da última string atualizada.

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

  • WRONGTYPEerro se o argumento json de entrada não for uma JSON string válida.

  • NONEXISTENT erro se o caminho não existir.

Exemplos

Sintaxe do caminho aprimorada:

127.0.0.1:6379> JSON.SET k1 $ '{"a":{"a":"a"}, "b":{"a":"a", "b":1}, "c":{"a":"a", "b":"bb"}, "d":{"a":1, "b":"b", "c":3}}'
OK
127.0.0.1:6379> JSON.STRAPPEND k1 $.a.a '"a"'
1) (integer) 2
127.0.0.1:6379> JSON.STRAPPEND k1 $.a.* '"a"'
1) (integer) 3
127.0.0.1:6379> JSON.STRAPPEND k1 $.b.* '"a"'
1) (integer) 2
2) (nil)
127.0.0.1:6379> JSON.STRAPPEND k1 $.c.* '"a"'
1) (integer) 2
2) (integer) 3
127.0.0.1:6379> JSON.STRAPPEND k1 $.c.b '"a"'
1) (integer) 4
127.0.0.1:6379> JSON.STRAPPEND k1 $.d.* '"a"'
1) (nil)
2) (integer) 2
3) (nil)

Sintaxe do caminho restrita:

127.0.0.1:6379> JSON.SET k1 . '{"a":{"a":"a"}, "b":{"a":"a", "b":1}, "c":{"a":"a", "b":"bb"}, "d":{"a":1, "b":"b", "c":3}}'
OK
127.0.0.1:6379> JSON.STRAPPEND k1 .a.a '"a"'
(integer) 2
127.0.0.1:6379> JSON.STRAPPEND k1 .a.* '"a"'
(integer) 3
127.0.0.1:6379> JSON.STRAPPEND k1 .b.* '"a"'
(integer) 2
127.0.0.1:6379> JSON.STRAPPEND k1 .c.* '"a"'
(integer) 3
127.0.0.1:6379> JSON.STRAPPEND k1 .c.b '"a"'
(integer) 4
127.0.0.1:6379> JSON.STRAPPEND k1 .d.* '"a"'
(integer) 2