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á.
# Comandos compatíveis
Os seguintes comandos JSON são compatíveis:
**Topics**
+ [JSON.ARRAPPEND](json-arrappend.md)
+ [JSON.ARRINDEX](json-arrindex.md)
+ [JSON.ARRINSERT](json-arrinsert.md)
+ [JSON.ARRLEN](json-arrlen.md)
+ [JSON.ARRPOP](json-arrpop.md)
+ [JSON.ARRTRIM](json-arrtrim.md)
+ [JSON.CLEAR](json-clear.md)
+ [JSON.DEBUG](json-debug.md)
+ [JSON.DEL](json-del.md)
+ [JSON.FORGET](json-forget.md)
+ [JSON.GET](json-get.md)
+ [JSON.MGET](json-mget.md)
+ [JSON.NUMINCRBY](json-numincrby.md)
+ [JSON.NUMMULTBY](json-nummultby.md)
+ [JSON.OBJLEN](json-objlen.md)
+ [JSON.OBJKEYS](json-objkeys.md)
+ [JSON.RESP](json-resp.md)
+ [JSON.SET](json-set.md)
+ [JSON.STRAPPEND](json-strappend.md)
+ [JSON.STRLEN](json-strlen.md)
+ [JSON.TOGGLE](json-toggle.md)
+ [JSON.TYPE](json-type.md)
# JSON.ARRAPPEND
Anexa um ou mais valores aos valores da matriz no caminho.
Sintaxe
```
JSON.ARRAPPEND [json ...]
```
+ key (obrigatório): chave do tipo de documento JSON
+ path (obrigatório): um caminho JSON
+ json (obrigatório): o valor JSON a ser anexado à matriz
**Return**
Se o caminho for uma sintaxe aprimorada:
+ Matriz de números inteiros, representando o novo comprimento da matriz em cada caminho.
+ Se um valor não for uma matriz, seu valor de retorno correspondente será nulo.
+ Erro `SYNTAXERR` se um dos argumentos de entradas json não for uma string JSON válida.
+ `NONEXISTENT` erro se o caminho não existir.
Se o caminho for uma sintaxe restrita:
+ Inteiro, o novo comprimento da matriz.
+ Se vários valores de matriz forem selecionados, o comando retornará o novo comprimento da última matriz atualizada.
+ Erro `WRONGTYPE` se o valor no caminho não for uma matriz.
+ Erro `SYNTAXERR` se um dos argumentos de entradas json não for uma string JSON 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", "b"]]'
OK
127.0.0.1:6379> JSON.ARRAPPEND k1 $[*] '"c"'
1) (integer) 1
2) (integer) 2
3) (integer) 3
127.0.0.1:6379> JSON.GET k1
"[[\"c\"],[\"a\",\"c\"],[\"a\",\"b\",\"c\"]]"
```
Sintaxe do caminho restrita:
```
127.0.0.1:6379> JSON.SET k1 . '[[], ["a"], ["a", "b"]]'
OK
127.0.0.1:6379> JSON.ARRAPPEND k1 [-1] '"c"'
(integer) 3
127.0.0.1:6379> JSON.GET k1
"[[],[\"a\"],[\"a\",\"b\",\"c\"]]"
```
# JSON.ARRINDEX
Procura a primeira ocorrência de um valor escalar JSON nas matrizes no caminho.
+ Erros fora do intervalo são tratados arredondando o índice para o início e o fim da matriz.
+ Se início > fim, retorna -1 (não encontrado).
Sintaxe
```
JSON.ARRINDEX [start [end]]
```
+ key (obrigatório): chave do tipo de documento JSON
+ path (obrigatório): um caminho JSON
+ json-scalar (obrigatório): valor escalar a ser pesquisado; escalar JSON se refere a valores que não são objetos ou matrizes. Ou seja, String, number, boolean e null são valores escalares.
+ início (opcional): o índice inicial, inclusive. Assumirá o padrão de 0 se não for fornecido.
+ fim (opcional): o índice final, exclusivo. Assumirá o padrão de 0 se não for fornecido, significa que o último elemento está incluído. 0 ou -1 significa que o último elemento está incluído.
**Return**
Se o caminho for uma sintaxe aprimorada:
+ Matriz de números inteiros. Cada valor é o índice do elemento correspondente na matriz no caminho. O valor é -1, se não encontrado.
+ Se um valor não for uma matriz, seu valor de retorno correspondente será nulo.
Se o caminho for uma sintaxe restrita:
+ Inteiro, o índice do elemento correspondente ou -1 se não for encontrado.
+ Erro `WRONGTYPE` se o valor no caminho não for uma matriz.
**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.ARRINDEX k1 $[*] '"b"'
1) (integer) -1
2) (integer) -1
3) (integer) 1
4) (integer) 1
```
Sintaxe do caminho restrita:
```
127.0.0.1:6379> JSON.SET k1 . '{"children": ["John", "Jack", "Tom", "Bob", "Mike"]}'
OK
127.0.0.1:6379> JSON.ARRINDEX k1 .children '"Tom"'
(integer) 2
```
# JSON.ARRINSERT
Insere um ou mais valores nos valores da matriz no caminho antes do índice.
Sintaxe
```
JSON.ARRINSERT [json ...]
```
+ key (obrigatório): chave do tipo de documento JSON
+ path (obrigatório): um caminho JSON
+ índice (obrigatório): um índice de matriz antes do qual os valores são inseridos.
+ json (obrigatório): o valor JSON a ser anexado à matriz
**Return**
Se o caminho for uma sintaxe aprimorada:
+ Matriz de números inteiros, representando o novo comprimento da matriz em cada caminho.
+ Se um valor for uma matriz vazia, seu valor de retorno correspondente será nulo.
+ Se um valor não for uma matriz, seu valor de retorno correspondente será nulo.
+ Erro `OUTOFBOUNDARIES` se o argumento índice estiver fora dos limites.
Se o caminho for uma sintaxe restrita:
+ Inteiro, o novo comprimento da matriz.
+ Erro `WRONGTYPE` se o valor no caminho não for uma matriz.
+ Erro `OUTOFBOUNDARIES` se o argumento índice estiver fora dos limites.
**Exemplos**
Sintaxe do caminho aprimorada:
```
127.0.0.1:6379> JSON.SET k1 . '[[], ["a"], ["a", "b"]]'
OK
127.0.0.1:6379> JSON.ARRINSERT k1 $[*] 0 '"c"'
1) (integer) 1
2) (integer) 2
3) (integer) 3
127.0.0.1:6379> JSON.GET k1
"[[\"c\"],[\"c\",\"a\"],[\"c\",\"a\",\"b\"]]"
```
Sintaxe do caminho restrita:
```
127.0.0.1:6379> JSON.SET k1 . '[[], ["a"], ["a", "b"]]'
OK
127.0.0.1:6379> JSON.ARRINSERT k1 . 0 '"c"'
(integer) 4
127.0.0.1:6379> JSON.GET k1
"[\"c\",[],[\"a\"],[\"a\",\"b\"]]"
```
# JSON.ARRLEN
Obtém o comprimento dos valores da matriz no caminho.
Sintaxe
```
JSON.ARRLEN [path]
```
+ key (obrigatório): chave 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 representa 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:
+ Matriz de strings em massa. Cada elemento é um nome de chave no objeto.
+ 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.
+ `WRONGTYPE` 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\"]]'
(error) SYNTAXERR Failed to parse JSON string due to syntax error
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 $[3]
1) (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 [*]
(integer) 0
127.0.0.1:6379> JSON.ARRLEN k2 $[1]
1) (nil)
127.0.0.1:6379> JSON.ARRLEN k2 $[2]
1) (integer) 2
```
# JSON.ARRPOP
Remove e retorna elemento no índice da matriz. Exibir uma matriz vazia retorna nulo.
Sintaxe
```
JSON.ARRPOP [path [index]]
```
+ key (obrigatório): chave do tipo de documento JSON
+ path (opcional): um caminho JSON. Assumirá o padrão da raiz se não for fornecido
+ índice (opcional): posição na matriz a partir da qual começar a exibir.
+ O padrão é -1 se não é fornecido, o que significa o último elemento.
+ O valor negativo significa posição do último elemento.
+ Os índices fora do limite são arredondados para seus respectivos limites de matriz.
**Return**
Se o caminho for uma sintaxe aprimorada:
+ Matriz de strings em massa que representam os valores exibidos em cada caminho.
+ Se um valor for uma matriz vazia, seu valor de retorno correspondente será nulo.
+ Se um valor não for uma matriz, seu valor de retorno correspondente será nulo.
Se o caminho for uma sintaxe restrita:
+ String em massa, representando o valor JSON exibido
+ Nulo se a matriz estiver vazia.
+ Erro `WRONGTYPE` se o valor no caminho não for uma matriz.
**Exemplos**
Sintaxe do caminho aprimorada:
```
127.0.0.1:6379> JSON.SET k1 . '[[], ["a"], ["a", "b"]]'
OK
127.0.0.1:6379> JSON.ARRPOP k1 $[*]
1) (nil)
2) "\"a\""
3) "\"b\""
127.0.0.1:6379> JSON.GET k1
"[[],[],[\"a\"]]"
```
Sintaxe do caminho restrita:
```
127.0.0.1:6379> JSON.SET k1 . '[[], ["a"], ["a", "b"]]'
OK
127.0.0.1:6379> JSON.ARRPOP k1
"[\"a\",\"b\"]"
127.0.0.1:6379> JSON.GET k1
"[[],[\"a\"]]"
127.0.0.1:6379> JSON.SET k2 . '[[], ["a"], ["a", "b"]]'
OK
127.0.0.1:6379> JSON.ARRPOP k2 . 0
"[]"
127.0.0.1:6379> JSON.GET k2
"[[\"a\"],[\"a\",\"b\"]]"
```
# JSON.ARRTRIM
Reduz as matrizes no caminho para que se tornem sub matrizes [start, end], ambas inclusive.
+ Se a matriz estiver vazia, não faça nada, retorne 0.
+ Se início for < 0, trate-a como 0.
+ Se fim for >= tamanho (tamanho da matriz), trate-a como tamanho-1.
+ Se início for >= tamanho ou início for > fim, esvazie a matriz e retorne 0.
Sintaxe
```
JSON.ARRINSERT
```
+ key (obrigatório): chave do tipo de documento JSON
+ path (obrigatório): um caminho JSON
+ início (obrigatório): índice inicial, inclusive.
+ fim (obrigatório): índice final, inclusive.
**Return**
Se o caminho for uma sintaxe aprimorada:
+ Matriz de números inteiros, representando o novo comprimento da matriz em cada caminho.
+ Se um valor for uma matriz vazia, seu valor de retorno correspondente será nulo.
+ Se um valor não for uma matriz, seu valor de retorno correspondente será nulo.
+ Erro `OUTOFBOUNDARIES` se um argumento índice estiver fora dos limites.
Se o caminho for uma sintaxe restrita:
+ Inteiro, o novo comprimento da matriz.
+ Nulo se a matriz estiver vazia.
+ Erro `WRONGTYPE` se o valor no caminho não for uma matriz.
+ Erro `OUTOFBOUNDARIES` se um argumento índice estiver fora dos limites.
**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.ARRTRIM k1 $[*] 0 1
1) (integer) 0
2) (integer) 1
3) (integer) 2
4) (integer) 2
127.0.0.1:6379> JSON.GET k1
"[[],[\"a\"],[\"a\",\"b\"],[\"a\",\"b\"]]"
```
Sintaxe do caminho restrita:
```
127.0.0.1:6379> JSON.SET k1 . '{"children": ["John", "Jack", "Tom", "Bob", "Mike"]}'
OK
127.0.0.1:6379> JSON.ARRTRIM k1 .children 0 1
(integer) 2
127.0.0.1:6379> JSON.GET k1 .children
"[\"John\",\"Jack\"]"
```
# JSON.CLEAR
Limpa as matrizes ou um objeto no caminho.
Sintaxe
```
JSON.CLEAR [path]
```
+ key (obrigatório): chave do tipo de documento JSON
+ path (opcional): um caminho JSON. Assumirá o padrão da raiz se não for fornecido
**Return**
+ Inteiro, o número de contêineres limpos.
+ Limpar uma matriz ou objeto vazio conta como 0 contêiner limpo.
**nota**
Antes da versão 6.2.6.R2 do Redis OSS, a limpeza de uma matriz ou objeto vazio conta como 1 contêiner limpo.
+ Limpar um valor que não seja do contêiner retorna 0.
+ Se nenhum valor de matriz ou objeto estiver localizado no caminho, o comando retorna 0.
**Exemplos**
```
127.0.0.1:6379> JSON.SET k1 . '[[], [0], [0,1], [0,1,2], 1, true, null, "d"]'
OK
127.0.0.1:6379> JSON.CLEAR k1 $[*]
(integer) 6
127.0.0.1:6379> JSON.CLEAR k1 $[*]
(integer) 0
127.0.0.1:6379> JSON.SET k2 . '{"children": ["John", "Jack", "Tom", "Bob", "Mike"]}'
OK
127.0.0.1:6379> JSON.CLEAR k2 .children
(integer) 1
127.0.0.1:6379> JSON.GET k2 .children
"[]"
```
# JSON.DEBUG
Informações do relatório. Os subcomandos compatíveis são:
+ MEMORY [path]: informa o uso de memória em bytes de um valor JSON. O caminho assumirá o padrão da raiz se não for fornecido.
+ DEPTH [caminho]: informa a profundidade máxima do caminho do documento JSON.
**nota**
Esse subcomando está disponível somente usando o mecanismo do Valkey 7.2 ou posterior ou Redis OSS versão 6.2.6.R2 ou posterior.
+ FIELDS [path]: informa o número de campos no caminho do documento especificado. O caminho assumirá o padrão da raiz se não for fornecido. Cada valor JSON não contêiner conta como um campo. Objetos e matrizes contam recursivamente como um campo para cada um dos valores JSON que contêm. Cada valor de contêiner, exceto o contêiner raiz, conta como um campo adicional.
+ HELP: imprime mensagens de ajuda referentes ao comando.
Sintaxe
```
JSON.DEBUG
```
Depende do subcomando:
MEMORY
+ Se o caminho for uma sintaxe aprimorada:
+ Retorna uma matriz de inteiros, que representa o tamanho da memória (em bytes) do valor JSON em cada caminho.
+ Retorna uma matriz vazia quando a chave não existe.
+ Se o caminho for uma sintaxe restrita:
+ retorna um número inteiro, o tamanho da memória do valor JSON em bytes.
+ Retorna nulo quando a chave não existe.
DEPTH
+ Retorna um número inteiro que representa a profundidade máxima do caminho do documento JSON.
+ Retorna nulo quando a chave não existe.
FIELDS
+ Se o caminho for uma sintaxe aprimorada:
+ Retorna uma matriz de inteiros, que representa o número de campos do valor JSON em cada caminho.
+ Retorna uma matriz vazia quando a chave não existe.
+ Se o caminho for uma sintaxe restrita:
+ retorna um número inteiro, número de campos do valor JSON.
+ Retorna nulo quando a chave não existe.
HELP: retorna uma série de mensagens de ajuda.
**Exemplos**
Sintaxe do caminho aprimorada:
```
127.0.0.1:6379> JSON.SET k1 . '[1, 2.3, "foo", true, null, {}, [], {"a":1, "b":2}, [1,2,3]]'
OK
127.0.0.1:6379> JSON.DEBUG MEMORY k1 $[*]
1) (integer) 16
2) (integer) 16
3) (integer) 19
4) (integer) 16
5) (integer) 16
6) (integer) 16
7) (integer) 16
8) (integer) 50
9) (integer) 64
127.0.0.1:6379> JSON.DEBUG FIELDS k1 $[*]
1) (integer) 1
2) (integer) 1
3) (integer) 1
4) (integer) 1
5) (integer) 1
6) (integer) 0
7) (integer) 0
8) (integer) 2
9) (integer) 3
```
Sintaxe do caminho restrita:
```
127.0.0.1:6379> JSON.SET k1 . '{"firstName":"John","lastName":"Smith","age":27,"weight":135.25,"isAlive":true,"address":{"street":"21 2nd Street","city":"New York","state":"NY","zipcode":"10021-3100"},"phoneNumbers":[{"type":"home","number":"212 555-1234"},{"type":"office","number":"646 555-4567"}],"children":[],"spouse":null}'
OK
127.0.0.1:6379> JSON.DEBUG MEMORY k1
(integer) 632
127.0.0.1:6379> JSON.DEBUG MEMORY k1 .phoneNumbers
(integer) 166
127.0.0.1:6379> JSON.DEBUG FIELDS k1
(integer) 19
127.0.0.1:6379> JSON.DEBUG FIELDS k1 .address
(integer) 4
127.0.0.1:6379> JSON.DEBUG HELP
1) JSON.DEBUG MEMORY [path] - report memory size (bytes) of the JSON element. Path defaults to root if not provided.
2) JSON.DEBUG FIELDS [path] - report number of fields in the JSON element. Path defaults to root if not provided.
3) JSON.DEBUG HELP - print help message.
```
# JSON.DEL
Exclui os valores JSON no caminho em uma chave de documento. Se o caminho é a raiz, é equivalente a excluir a chave do Valkey ou Redis OSS.
Sintaxe
```
JSON.DEL [path]
```
+ key (obrigatório): chave do tipo de documento JSON
+ path (opcional): um caminho JSON. Assumirá o padrão da raiz se não for fornecido
**Return**
+ Número de elementos excluídos.
+ 0 quando a chave não existe.
+ 0 se o caminho JSON for inválido ou não existir.
**Exemplos**
Sintaxe do caminho aprimorada:
```
127.0.0.1:6379> JSON.SET k1 . '{"a":{}, "b":{"a":1}, "c":{"a":1, "b":2}, "d":{"a":1, "b":2, "c":3}, "e": [1,2,3,4,5]}'
OK
127.0.0.1:6379> JSON.DEL k1 $.d.*
(integer) 3
127.0.0.1:6379> JSOn.GET k1
"{\"a\":{},\"b\":{\"a\":1},\"c\":{\"a\":1,\"b\":2},\"d\":{},\"e\":[1,2,3,4,5]}"
127.0.0.1:6379> JSON.DEL k1 $.e[*]
(integer) 5
127.0.0.1:6379> JSOn.GET k1
"{\"a\":{},\"b\":{\"a\":1},\"c\":{\"a\":1,\"b\":2},\"d\":{},\"e\":[]}"
```
Sintaxe do caminho restrita:
```
127.0.0.1:6379> JSON.SET k1 . '{"a":{}, "b":{"a":1}, "c":{"a":1, "b":2}, "d":{"a":1, "b":2, "c":3}, "e": [1,2,3,4,5]}'
OK
127.0.0.1:6379> JSON.DEL k1 .d.*
(integer) 3
127.0.0.1:6379> JSON.GET k1
"{\"a\":{},\"b\":{\"a\":1},\"c\":{\"a\":1,\"b\":2},\"d\":{},\"e\":[1,2,3,4,5]}"
127.0.0.1:6379> JSON.DEL k1 .e[*]
(integer) 5
127.0.0.1:6379> JSON.GET k1
"{\"a\":{},\"b\":{\"a\":1},\"c\":{\"a\":1,\"b\":2},\"d\":{},\"e\":[]}"
```
# JSON.FORGET
Um alias de [JSON.DEL](json-del.md)
# JSON.GET
Retorna o JSON serializado em um ou vários caminhos.
Sintaxe
```
JSON.GET
[INDENT indentation-string]
[NEWLINE newline-string]
[SPACE space-string]
[NOESCAPE]
[path ...]
```
+ key (obrigatório): chave do tipo de documento JSON
+ INDENT/NEWLINE/SPACE(opcional) — controla o formato da string JSON retornada, ou seja, “impressão bonita”. O valor padrão de cada um é string vazia. Podem ser anulados em qualquer combinação. Eles podem ser especificados em qualquer ordem.
+ NOESCAPE: opcional, presença permitida para compatibilidade com legado e não tem outro efeito.
+ path (opcional): zero ou mais caminhos JSON, assumirá o padrão de raiz se nenhum for fornecido. Os argumentos do caminho devem ser colocados no final.
**Return**
Sintaxe do caminho aprimorada:
Se um caminho for fornecido:
+ Retornará a string serializada de uma matriz de valores.
+ Se nenhum valor for selecionado, o comando retornará uma matriz vazia.
Se vários caminhos forem fornecidos:
+ Retornará um objeto JSON em formato de string, no qual cada caminho é uma chave.
+ Se houver sintaxe mista de caminho aprimorado e restrito, o resultado estará de acordo com a sintaxe aprimorada.
+ Se um caminho não existir, seu valor correspondente será uma matriz vazia.
**Exemplos**
Sintaxe do caminho aprimorada:
```
127.0.0.1:6379> JSON.SET k1 . '{"firstName":"John","lastName":"Smith","age":27,"weight":135.25,"isAlive":true,"address":{"street":"21 2nd Street","city":"New York","state":"NY","zipcode":"10021-3100"},"phoneNumbers":[{"type":"home","number":"212 555-1234"},{"type":"office","number":"646 555-4567"}],"children":[],"spouse":null}'
OK
127.0.0.1:6379> JSON.GET k1 $.address.*
"[\"21 2nd Street\",\"New York\",\"NY\",\"10021-3100\"]"
127.0.0.1:6379> JSON.GET k1 indent "\t" space " " NEWLINE "\n" $.address.*
"[\n\t\"21 2nd Street\",\n\t\"New York\",\n\t\"NY\",\n\t\"10021-3100\"\n]"
127.0.0.1:6379> JSON.GET k1 $.firstName $.lastName $.age
"{\"$.firstName\":[\"John\"],\"$.lastName\":[\"Smith\"],\"$.age\":[27]}"
127.0.0.1:6379> JSON.SET k2 . '{"a":{}, "b":{"a":1}, "c":{"a":1, "b":2}}'
OK
127.0.0.1:6379> json.get k2 $..*
"[{},{\"a\":1},{\"a\":1,\"b\":2},1,1,2]"
```
Sintaxe do caminho restrita:
```
127.0.0.1:6379> JSON.SET k1 . '{"firstName":"John","lastName":"Smith","age":27,"weight":135.25,"isAlive":true,"address":{"street":"21 2nd Street","city":"New York","state":"NY","zipcode":"10021-3100"},"phoneNumbers":[{"type":"home","number":"212 555-1234"},{"type":"office","number":"646 555-4567"}],"children":[],"spouse":null}'
OK
127.0.0.1:6379> JSON.GET k1 .address
"{\"street\":\"21 2nd Street\",\"city\":\"New York\",\"state\":\"NY\",\"zipcode\":\"10021-3100\"}"
127.0.0.1:6379> JSON.GET k1 indent "\t" space " " NEWLINE "\n" .address
"{\n\t\"street\": \"21 2nd Street\",\n\t\"city\": \"New York\",\n\t\"state\": \"NY\",\n\t\"zipcode\": \"10021-3100\"\n}"
127.0.0.1:6379> JSON.GET k1 .firstName .lastName .age
"{\".firstName\":\"John\",\".lastName\":\"Smith\",\".age\":27}"
```
# JSON.MGET
Seja serializado JSONs no caminho a partir de várias chaves do documento. Retorna nulo para uma chave ou caminho JSON não existente.
Sintaxe
```
JSON.MGET [key ...]
```
+ key (obrigatório): uma ou mais chaves do tipo de documento.
+ path (obrigatório): um caminho JSON
**Return**
+ Matriz de Strings em Massa. O tamanho da matriz é igual ao número de chaves no comando. Cada elemento da matriz será preenchido com (a) o JSON serializado conforme localizado pelo caminho ou (b) Null se a chave não existir, o caminho não existir no documento ou o caminho for inválido (erro de sintaxe).
+ Se alguma das chaves especificadas existir e não for uma chave JSON, o comando retornará o erro `WRONGTYPE`.
**Exemplos**
Sintaxe do caminho aprimorada:
```
127.0.0.1:6379> JSON.SET k1 . '{"address":{"street":"21 2nd Street","city":"New York","state":"NY","zipcode":"10021"}}'
OK
127.0.0.1:6379> JSON.SET k2 . '{"address":{"street":"5 main Street","city":"Boston","state":"MA","zipcode":"02101"}}'
OK
127.0.0.1:6379> JSON.SET k3 . '{"address":{"street":"100 Park Ave","city":"Seattle","state":"WA","zipcode":"98102"}}'
OK
127.0.0.1:6379> JSON.MGET k1 k2 k3 $.address.city
1) "[\"New York\"]"
2) "[\"Boston\"]"
3) "[\"Seattle\"]"
```
Sintaxe do caminho restrita:
```
127.0.0.1:6379> JSON.SET k1 . '{"address":{"street":"21 2nd Street","city":"New York","state":"NY","zipcode":"10021"}}'
OK
127.0.0.1:6379> JSON.SET k2 . '{"address":{"street":"5 main Street","city":"Boston","state":"MA","zipcode":"02101"}}'
OK
127.0.0.1:6379> JSON.SET k3 . '{"address":{"street":"100 Park Ave","city":"Seattle","state":"WA","zipcode":"98102"}}'
OK
127.0.0.1:6379> JSON.MGET k1 k2 k3 .address.city
1) "\"New York\""
2) "\"Seattle\""
3) "\"Seattle\""
```
# JSON.NUMINCRBY
Incrementa os valores numéricos no caminho por um determinado número.
Sintaxe
```
JSON.NUMINCRBY
```
+ key (obrigatório): chave do tipo de documento JSON
+ path (obrigatório): um caminho JSON
+ número (obrigatório): um número
**Return**
Se o caminho for uma sintaxe aprimorada:
+ Matriz de strings em massa que representa o valor resultante em cada caminho.
+ Se um valor não for um número, seu valor de retorno correspondente será nulo.
+ Erro `WRONGTYPE` se o número não puder ser analisado.
+ Erro `OVERFLOW` se o resultado estiver fora do intervalo de duplo IEEE de 64 bits.
+ `NONEXISTENT` se a chave do documento não existir.
Se o caminho for uma sintaxe restrita:
+ Matriz de strings em massa que representa os valores resultantes.
+ Se vários valores forem selecionados, o comando retornará o resultado do último valor atualizado.
+ Erro `WRONGTYPE` se o valor no caminho não for um número.
+ Erro `WRONGTYPE` se o número não puder ser analisado.
+ Erro `OVERFLOW` se o resultado estiver fora do intervalo de duplo IEEE de 64 bits.
+ `NONEXISTENT` se a chave do documento não existir.
**Exemplos**
Sintaxe do caminho aprimorada:
```
127.0.0.1:6379> JSON.SET k1 . '{"a":[], "b":[1], "c":[1,2], "d":[1,2,3]}'
OK
127.0.0.1:6379> JSON.NUMINCRBY k1 $.d[*] 10
"[11,12,13]"
127.0.0.1:6379> JSON.GET k1
"{\"a\":[],\"b\":[1],\"c\":[1,2],\"d\":[11,12,13]}"
127.0.0.1:6379> JSON.SET k1 $ '{"a":[], "b":[1], "c":[1,2], "d":[1,2,3]}'
OK
127.0.0.1:6379> JSON.NUMINCRBY k1 $.a[*] 1
"[]"
127.0.0.1:6379> JSON.NUMINCRBY k1 $.b[*] 1
"[2]"
127.0.0.1:6379> JSON.NUMINCRBY k1 $.c[*] 1
"[2,3]"
127.0.0.1:6379> JSON.NUMINCRBY k1 $.d[*] 1
"[2,3,4]"
127.0.0.1:6379> JSON.GET k1
"{\"a\":[],\"b\":[2],\"c\":[2,3],\"d\":[2,3,4]}"
127.0.0.1:6379> JSON.SET k2 $ '{"a":{}, "b":{"a":1}, "c":{"a":1, "b":2}, "d":{"a":1, "b":2, "c":3}}'
OK
127.0.0.1:6379> JSON.NUMINCRBY k2 $.a.* 1
"[]"
127.0.0.1:6379> JSON.NUMINCRBY k2 $.b.* 1
"[2]"
127.0.0.1:6379> JSON.NUMINCRBY k2 $.c.* 1
"[2,3]"
127.0.0.1:6379> JSON.NUMINCRBY k2 $.d.* 1
"[2,3,4]"
127.0.0.1:6379> JSON.GET k2
"{\"a\":{},\"b\":{\"a\":2},\"c\":{\"a\":2,\"b\":3},\"d\":{\"a\":2,\"b\":3,\"c\":4}}"
127.0.0.1:6379> JSON.SET k3 $ '{"a":{"a":"a"}, "b":{"a":"a", "b":1}, "c":{"a":"a", "b":"b"}, "d":{"a":1, "b":"b", "c":3}}'
OK
127.0.0.1:6379> JSON.NUMINCRBY k3 $.a.* 1
"[null]"
127.0.0.1:6379> JSON.NUMINCRBY k3 $.b.* 1
"[null,2]"
127.0.0.1:6379> JSON.NUMINCRBY k3 $.c.* 1
"[null,null]"
127.0.0.1:6379> JSON.NUMINCRBY k3 $.d.* 1
"[2,null,4]"
127.0.0.1:6379> JSON.GET k3
"{\"a\":{\"a\":\"a\"},\"b\":{\"a\":\"a\",\"b\":2},\"c\":{\"a\":\"a\",\"b\":\"b\"},\"d\":{\"a\":2,\"b\":\"b\",\"c\":4}}"
```
Sintaxe do caminho restrita:
```
127.0.0.1:6379> JSON.SET k1 . '{"a":[], "b":[1], "c":[1,2], "d":[1,2,3]}'
OK
127.0.0.1:6379> JSON.NUMINCRBY k1 .d[1] 10
"12"
127.0.0.1:6379> JSON.GET k1
"{\"a\":[],\"b\":[1],\"c\":[1,2],\"d\":[1,12,3]}"
127.0.0.1:6379> JSON.SET k1 . '{"a":[], "b":[1], "c":[1,2], "d":[1,2,3]}'
OK
127.0.0.1:6379> JSON.NUMINCRBY k1 .a[*] 1
(error) NONEXISTENT JSON path does not exist
127.0.0.1:6379> JSON.NUMINCRBY k1 .b[*] 1
"2"
127.0.0.1:6379> JSON.GET k1
"{\"a\":[],\"b\":[2],\"c\":[1,2],\"d\":[1,2,3]}"
127.0.0.1:6379> JSON.NUMINCRBY k1 .c[*] 1
"3"
127.0.0.1:6379> JSON.GET k1
"{\"a\":[],\"b\":[2],\"c\":[2,3],\"d\":[1,2,3]}"
127.0.0.1:6379> JSON.NUMINCRBY k1 .d[*] 1
"4"
127.0.0.1:6379> JSON.GET k1
"{\"a\":[],\"b\":[2],\"c\":[2,3],\"d\":[2,3,4]}"
127.0.0.1:6379> JSON.SET k2 . '{"a":{}, "b":{"a":1}, "c":{"a":1, "b":2}, "d":{"a":1, "b":2, "c":3}}'
OK
127.0.0.1:6379> JSON.NUMINCRBY k2 .a.* 1
(error) NONEXISTENT JSON path does not exist
127.0.0.1:6379> JSON.NUMINCRBY k2 .b.* 1
"2"
127.0.0.1:6379> JSON.GET k2
"{\"a\":{},\"b\":{\"a\":2},\"c\":{\"a\":1,\"b\":2},\"d\":{\"a\":1,\"b\":2,\"c\":3}}"
127.0.0.1:6379> JSON.NUMINCRBY k2 .c.* 1
"3"
127.0.0.1:6379> JSON.GET k2
"{\"a\":{},\"b\":{\"a\":2},\"c\":{\"a\":2,\"b\":3},\"d\":{\"a\":1,\"b\":2,\"c\":3}}"
127.0.0.1:6379> JSON.NUMINCRBY k2 .d.* 1
"4"
127.0.0.1:6379> JSON.GET k2
"{\"a\":{},\"b\":{\"a\":2},\"c\":{\"a\":2,\"b\":3},\"d\":{\"a\":2,\"b\":3,\"c\":4}}"
127.0.0.1:6379> JSON.SET k3 . '{"a":{"a":"a"}, "b":{"a":"a", "b":1}, "c":{"a":"a", "b":"b"}, "d":{"a":1, "b":"b", "c":3}}'
OK
127.0.0.1:6379> JSON.NUMINCRBY k3 .a.* 1
(error) WRONGTYPE JSON element is not a number
127.0.0.1:6379> JSON.NUMINCRBY k3 .b.* 1
"2"
127.0.0.1:6379> JSON.NUMINCRBY k3 .c.* 1
(error) WRONGTYPE JSON element is not a number
127.0.0.1:6379> JSON.NUMINCRBY k3 .d.* 1
"4"
```
# JSON.NUMMULTBY
Multiplica os valores numéricos no caminho por um determinado número.
Sintaxe
```
JSON.NUMMULTBY
```
+ key (obrigatório): chave do tipo de documento JSON
+ path (obrigatório): um caminho JSON
+ número (obrigatório): um número
**Return**
Se o caminho for uma sintaxe aprimorada:
+ Matriz de strings em massa que representa o valor resultante em cada caminho.
+ Se um valor não for um número, seu valor de retorno correspondente será nulo.
+ Erro `WRONGTYPE` se o número não puder ser analisado.
+ Erro `OVERFLOW` se o resultado estiver fora do intervalo de duplo IEEE de 64 bits.
+ `NONEXISTENT` se a chave do documento não existir.
Se o caminho for uma sintaxe restrita:
+ Matriz de strings em massa que representa os valores resultantes.
+ Se vários valores forem selecionados, o comando retornará o resultado do último valor atualizado.
+ Erro `WRONGTYPE` se o valor no caminho não for um número.
+ Erro `WRONGTYPE` se o número não puder ser analisado.
+ Erro `OVERFLOW` se o resultado estiver fora do intervalo de duplo IEEE de 64 bits.
+ `NONEXISTENT` se a chave do documento não existir.
**Exemplos**
Sintaxe do caminho aprimorada:
```
127.0.0.1:6379> JSON.SET k1 . '{"a":[], "b":[1], "c":[1,2], "d":[1,2,3]}'
OK
127.0.0.1:6379> JSON.NUMMULTBY k1 $.d[*] 2
"[2,4,6]"
127.0.0.1:6379> JSON.GET k1
"{\"a\":[],\"b\":[1],\"c\":[1,2],\"d\":[2,4,6]}"
127.0.0.1:6379> JSON.SET k1 $ '{"a":[], "b":[1], "c":[1,2], "d":[1,2,3]}'
OK
127.0.0.1:6379> JSON.NUMMULTBY k1 $.a[*] 2
"[]"
127.0.0.1:6379> JSON.NUMMULTBY k1 $.b[*] 2
"[2]"
127.0.0.1:6379> JSON.NUMMULTBY k1 $.c[*] 2
"[2,4]"
127.0.0.1:6379> JSON.NUMMULTBY k1 $.d[*] 2
"[2,4,6]"
127.0.0.1:6379> JSON.SET k2 $ '{"a":{}, "b":{"a":1}, "c":{"a":1, "b":2}, "d":{"a":1, "b":2, "c":3}}'
OK
127.0.0.1:6379> JSON.NUMMULTBY k2 $.a.* 2
"[]"
127.0.0.1:6379> JSON.NUMMULTBY k2 $.b.* 2
"[2]"
127.0.0.1:6379> JSON.NUMMULTBY k2 $.c.* 2
"[2,4]"
127.0.0.1:6379> JSON.NUMMULTBY k2 $.d.* 2
"[2,4,6]"
127.0.0.1:6379> JSON.SET k3 $ '{"a":{"a":"a"}, "b":{"a":"a", "b":1}, "c":{"a":"a", "b":"b"}, "d":{"a":1, "b":"b", "c":3}}'
OK
127.0.0.1:6379> JSON.NUMMULTBY k3 $.a.* 2
"[null]"
127.0.0.1:6379> JSON.NUMMULTBY k3 $.b.* 2
"[null,2]"
127.0.0.1:6379> JSON.NUMMULTBY k3 $.c.* 2
"[null,null]"
127.0.0.1:6379> JSON.NUMMULTBY k3 $.d.* 2
"[2,null,6]"
```
Sintaxe do caminho restrita:
```
127.0.0.1:6379> JSON.SET k1 . '{"a":[], "b":[1], "c":[1,2], "d":[1,2,3]}'
OK
127.0.0.1:6379> JSON.NUMMULTBY k1 .d[1] 2
"4"
127.0.0.1:6379> JSON.GET k1
"{\"a\":[],\"b\":[1],\"c\":[1,2],\"d\":[1,4,3]}"
127.0.0.1:6379> JSON.SET k1 . '{"a":[], "b":[1], "c":[1,2], "d":[1,2,3]}'
OK
127.0.0.1:6379> JSON.NUMMULTBY k1 .a[*] 2
(error) NONEXISTENT JSON path does not exist
127.0.0.1:6379> JSON.NUMMULTBY k1 .b[*] 2
"2"
127.0.0.1:6379> JSON.GET k1
"{\"a\":[],\"b\":[2],\"c\":[1,2],\"d\":[1,2,3]}"
127.0.0.1:6379> JSON.NUMMULTBY k1 .c[*] 2
"4"
127.0.0.1:6379> JSON.GET k1
"{\"a\":[],\"b\":[2],\"c\":[2,4],\"d\":[1,2,3]}"
127.0.0.1:6379> JSON.NUMMULTBY k1 .d[*] 2
"6"
127.0.0.1:6379> JSON.GET k1
"{\"a\":[],\"b\":[2],\"c\":[2,4],\"d\":[2,4,6]}"
127.0.0.1:6379> JSON.SET k2 . '{"a":{}, "b":{"a":1}, "c":{"a":1, "b":2}, "d":{"a":1, "b":2, "c":3}}'
OK
127.0.0.1:6379> JSON.NUMMULTBY k2 .a.* 2
(error) NONEXISTENT JSON path does not exist
127.0.0.1:6379> JSON.NUMMULTBY k2 .b.* 2
"2"
127.0.0.1:6379> JSON.GET k2
"{\"a\":{},\"b\":{\"a\":2},\"c\":{\"a\":1,\"b\":2},\"d\":{\"a\":1,\"b\":2,\"c\":3}}"
127.0.0.1:6379> JSON.NUMMULTBY k2 .c.* 2
"4"
127.0.0.1:6379> JSON.GET k2
"{\"a\":{},\"b\":{\"a\":2},\"c\":{\"a\":2,\"b\":4},\"d\":{\"a\":1,\"b\":2,\"c\":3}}"
127.0.0.1:6379> JSON.NUMMULTBY k2 .d.* 2
"6"
127.0.0.1:6379> JSON.GET k2
"{\"a\":{},\"b\":{\"a\":2},\"c\":{\"a\":2,\"b\":4},\"d\":{\"a\":2,\"b\":4,\"c\":6}}"
127.0.0.1:6379> JSON.SET k3 . '{"a":{"a":"a"}, "b":{"a":"a", "b":1}, "c":{"a":"a", "b":"b"}, "d":{"a":1, "b":"b", "c":3}}'
OK
127.0.0.1:6379> JSON.NUMMULTBY k3 .a.* 2
(error) WRONGTYPE JSON element is not a number
127.0.0.1:6379> JSON.NUMMULTBY k3 .b.* 2
"2"
127.0.0.1:6379> JSON.GET k3
"{\"a\":{\"a\":\"a\"},\"b\":{\"a\":\"a\",\"b\":2},\"c\":{\"a\":\"a\",\"b\":\"b\"},\"d\":{\"a\":1,\"b\":\"b\",\"c\":3}}"
127.0.0.1:6379> JSON.NUMMULTBY k3 .c.* 2
(error) WRONGTYPE JSON element is not a number
127.0.0.1:6379> JSON.NUMMULTBY k3 .d.* 2
"6"
127.0.0.1:6379> JSON.GET k3
"{\"a\":{\"a\":\"a\"},\"b\":{\"a\":\"a\",\"b\":2},\"c\":{\"a\":\"a\",\"b\":\"b\"},\"d\":{\"a\":2,\"b\":\"b\",\"c\":6}}"
```
# JSON.OBJLEN
Obtém o número de chaves nos valores do objeto no caminho.
Sintaxe
```
JSON.OBJLEN [path]
```
+ key (obrigatório): chave 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 representa o comprimento do objeto em cada caminho.
+ Se um valor não for um objeto, seu valor de retorno correspondente será nulo.
+ Nulo se a chave do documento não existir.
Se o caminho for uma sintaxe restrita:
+ Inteiro, número de chaves no objeto.
+ Se vários objetos forem selecionados, o comando retornará o comprimento do primeiro objeto.
+ Erro `WRONGTYPE` se o valor no caminho não for um objeto.
+ `WRONGTYPE` 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":{}, "b":{"a":"a"}, "c":{"a":"a", "b":"bb"}, "d":{"a":1, "b":"b", "c":{"a":3,"b":4}}, "e":1}'
OK
127.0.0.1:6379> JSON.OBJLEN k1 $.a
1) (integer) 0
127.0.0.1:6379> JSON.OBJLEN k1 $.a.*
(empty array)
127.0.0.1:6379> JSON.OBJLEN k1 $.b
1) (integer) 1
127.0.0.1:6379> JSON.OBJLEN k1 $.b.*
1) (nil)
127.0.0.1:6379> JSON.OBJLEN k1 $.c
1) (integer) 2
127.0.0.1:6379> JSON.OBJLEN k1 $.c.*
1) (nil)
2) (nil)
127.0.0.1:6379> JSON.OBJLEN k1 $.d
1) (integer) 3
127.0.0.1:6379> JSON.OBJLEN k1 $.d.*
1) (nil)
2) (nil)
3) (integer) 2
127.0.0.1:6379> JSON.OBJLEN k1 $.*
1) (integer) 0
2) (integer) 1
3) (integer) 2
4) (integer) 3
5) (nil)
```
Sintaxe do caminho restrita:
```
127.0.0.1:6379> JSON.SET k1 . '{"a":{}, "b":{"a":"a"}, "c":{"a":"a", "b":"bb"}, "d":{"a":1, "b":"b", "c":{"a":3,"b":4}}, "e":1}'
OK
127.0.0.1:6379> JSON.OBJLEN k1 .a
(integer) 0
127.0.0.1:6379> JSON.OBJLEN k1 .a.*
(error) NONEXISTENT JSON path does not exist
127.0.0.1:6379> JSON.OBJLEN k1 .b
(integer) 1
127.0.0.1:6379> JSON.OBJLEN k1 .b.*
(error) WRONGTYPE JSON element is not an object
127.0.0.1:6379> JSON.OBJLEN k1 .c
(integer) 2
127.0.0.1:6379> JSON.OBJLEN k1 .c.*
(error) WRONGTYPE JSON element is not an object
127.0.0.1:6379> JSON.OBJLEN k1 .d
(integer) 3
127.0.0.1:6379> JSON.OBJLEN k1 .d.*
(integer) 2
127.0.0.1:6379> JSON.OBJLEN k1 .*
(integer) 0
```
# JSON.OBJKEYS
Obtém nomes de chave nos valores de objeto no caminho.
Sintaxe
```
JSON.OBJKEYS [path]
```
+ key (obrigatório): chave 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 matriz de strings em massa. Cada elemento é uma matriz de chaves em um objeto correspondente.
+ Se um valor não for um objeto, seu valor de retorno correspondente será vazio.
+ Nulo se a chave do documento não existir.
Se o caminho for uma sintaxe restrita:
+ Matriz de strings em massa. Cada elemento é um nome de chave no objeto.
+ Se vários objetos forem selecionados, o comando retornará as chaves do primeiro objeto.
+ Erro `WRONGTYPE` se o valor no caminho não for um objeto.
+ `WRONGTYPE` 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":{}, "b":{"a":"a"}, "c":{"a":"a", "b":"bb"}, "d":{"a":1, "b":"b", "c":{"a":3,"b":4}}, "e":1}'
OK
127.0.0.1:6379> JSON.OBJKEYS k1 $.*
1) (empty array)
2) 1) "a"
3) 1) "a"
2) "b"
4) 1) "a"
2) "b"
3) "c"
5) (empty array)
127.0.0.1:6379> JSON.OBJKEYS k1 $.d
1) 1) "a"
2) "b"
3) "c"
```
Sintaxe do caminho restrita:
```
127.0.0.1:6379> JSON.SET k1 $ '{"a":{}, "b":{"a":"a"}, "c":{"a":"a", "b":"bb"}, "d":{"a":1, "b":"b", "c":{"a":3,"b":4}}, "e":1}'
OK
127.0.0.1:6379> JSON.OBJKEYS k1 .*
1) "a"
127.0.0.1:6379> JSON.OBJKEYS k1 .d
1) "a"
2) "b"
3) "c"
```
# JSON.RESP
Retorna o valor JSON em determinado caminho fornecido no Valkey ou Redis OSS Serialization Protocol (RESP). Se o valor for contêiner, a resposta será uma matriz RESP ou matriz aninhada.
+ JSON nulo é mapeado para o RESP Null Bulk String.
+ Valores booleanos JSON são associados às respectivas RESP Simple Strings.
+ Os números inteiros são mapeados para números inteiros RESP.
+ Os números de ponto flutuante duplo IEEE de 64 bits são mapeados para RESP Bulk Strings.
+ As strings JSON são mapeadas para RESP Bulk Strings.
+ As matrizes JSON são representados como matrizes RESP, onde o primeiro elemento é a string simples [, seguida pelos elementos da matriz.
+ Os objetos JSON são representados como matrizes RESP, onde o primeiro elemento é a string simples \$1, seguida por pares de valores-chave, cada um dos quais é uma string RESP em massa.
Sintaxe
```
JSON.RESP [path]
```
+ key (obrigatório): chave 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 matrizes. Cada elemento da matriz representa a forma RESP do valor em um caminho.
+ Matriz vazia se a chave do documento não existir.
Se o caminho for uma sintaxe restrita:
+ Matriz que representa a forma RESP do valor em um caminho.
+ Nulo se a chave do documento não existir.
**Exemplos**
Sintaxe do caminho aprimorada:
```
127.0.0.1:6379> JSON.SET k1 . '{"firstName":"John","lastName":"Smith","age":27,"weight":135.25,"isAlive":true,"address":{"street":"21 2nd Street","city":"New York","state":"NY","zipcode":"10021-3100"},"phoneNumbers":[{"type":"home","number":"212 555-1234"},{"type":"office","number":"646 555-4567"}],"children":[],"spouse":null}'
OK
127.0.0.1:6379> JSON.RESP k1 $.address
1) 1) {
2) 1) "street"
2) "21 2nd Street"
3) 1) "city"
2) "New York"
4) 1) "state"
2) "NY"
5) 1) "zipcode"
2) "10021-3100"
127.0.0.1:6379> JSON.RESP k1 $.address.*
1) "21 2nd Street"
2) "New York"
3) "NY"
4) "10021-3100"
127.0.0.1:6379> JSON.RESP k1 $.phoneNumbers
1) 1) [
2) 1) {
2) 1) "type"
2) "home"
3) 1) "number"
2) "555 555-1234"
3) 1) {
2) 1) "type"
2) "office"
3) 1) "number"
2) "555 555-4567"
127.0.0.1:6379> JSON.RESP k1 $.phoneNumbers[*]
1) 1) {
2) 1) "type"
2) "home"
3) 1) "number"
2) "212 555-1234"
2) 1) {
2) 1) "type"
2) "office"
3) 1) "number"
2) "555 555-4567"
```
Sintaxe do caminho restrita:
```
127.0.0.1:6379> JSON.SET k1 . '{"firstName":"John","lastName":"Smith","age":27,"weight":135.25,"isAlive":true,"address":{"street":"21 2nd Street","city":"New York","state":"NY","zipcode":"10021-3100"},"phoneNumbers":[{"type":"home","number":"212 555-1234"},{"type":"office","number":"646 555-4567"}],"children":[],"spouse":null}'
OK
127.0.0.1:6379> JSON.RESP k1 .address
1) {
2) 1) "street"
2) "21 2nd Street"
3) 1) "city"
2) "New York"
4) 1) "state"
2) "NY"
5) 1) "zipcode"
2) "10021-3100"
127.0.0.1:6379> JSON.RESP k1
1) {
2) 1) "firstName"
2) "John"
3) 1) "lastName"
2) "Smith"
4) 1) "age"
2) (integer) 27
5) 1) "weight"
2) "135.25"
6) 1) "isAlive"
2) true
7) 1) "address"
2) 1) {
2) 1) "street"
2) "21 2nd Street"
3) 1) "city"
2) "New York"
4) 1) "state"
2) "NY"
5) 1) "zipcode"
2) "10021-3100"
8) 1) "phoneNumbers"
2) 1) [
2) 1) {
2) 1) "type"
2) "home"
3) 1) "number"
2) "212 555-1234"
3) 1) {
2) 1) "type"
2) "office"
3) 1) "number"
2) "555 555-4567"
9) 1) "children"
2) 1) [
10) 1) "spouse"
2) (nil)
```
# JSON.SET
Define os valores JSON no caminho.
Se o caminho exigir um membro do objeto:
+ Se o elemento pai não existir, o comando retornará o erro NONEXISTENT.
+ Se o elemento pai existir, mas não for um objeto, o comando retornará ERROR.
+ Se o elemento pai existir e for um objeto:
+ Se o membro não existir, um novo membro será anexado ao objeto pai se e somente se o objeto pai for o último filho no caminho. Caso contrário, o comando retornará o erro NONEXISTENT.
+ Se o membro existir, seu valor será substituído pelo valor JSON.
Se o caminho exigir um índice de matriz:
+ Se o elemento pai não existir, o comando retornará o erro NONEXISTENT.
+ Se o elemento pai existir, mas não for uma matriz o comando retornará ERROR.
+ Se o elemento pai existir, mas o índice estiver fora dos limites, o comando retornará o erro OUTOFBOUNDARIES.
+ Se o elemento pai existir e o índice for válido, o elemento será substituído pelo novo valor JSON.
Se o caminho solicitar um objeto ou matriz, o valor (objeto ou matriz) será substituído pelo novo valor JSON.
Sintaxe
```
JSON.SET [NX | XX]
```
[NX \$1 XX] Onde é possível ter 0 ou 1 de identificadores [NX \$1 XX]
+ key (obrigatório): chave do tipo de documento JSON
+ path (obrigatório): um caminho JSON. Para uma nova chave, o caminho JSON deve ser a raiz “.”.
+ NX (opcional): se o caminho for a raiz, defina o valor somente se a chave não existir, ou seja, insira um novo documento. Se o caminho não for a raiz, defina o valor somente se o caminho não existir, ou seja, insira um valor no documento.
+ XX (opcional): se o caminho for a raiz, defina o valor somente se a chave existir, ou seja, substitua o documento existente. Se o caminho não for a raiz, defina o valor somente se o caminho existir, ou seja, atualize o valor existente.
**Return**
+ String simples 'OK' em caso de sucesso.
+ Nulo se a condição NX ou XX não for atendida.
**Exemplos**
Sintaxe do caminho aprimorada:
```
127.0.0.1:6379> JSON.SET k1 . '{"a":{"a":1, "b":2, "c":3}}'
OK
127.0.0.1:6379> JSON.SET k1 $.a.* '0'
OK
127.0.0.1:6379> JSON.GET k1
"{\"a\":{\"a\":0,\"b\":0,\"c\":0}}"
127.0.0.1:6379> JSON.SET k2 . '{"a": [1,2,3,4,5]}'
OK
127.0.0.1:6379> JSON.SET k2 $.a[*] '0'
OK
127.0.0.1:6379> JSON.GET k2
"{\"a\":[0,0,0,0,0]}"
```
Sintaxe do caminho restrita:
```
127.0.0.1:6379> JSON.SET k1 . '{"c":{"a":1, "b":2}, "e": [1,2,3,4,5]}'
OK
127.0.0.1:6379> JSON.SET k1 .c.a '0'
OK
127.0.0.1:6379> JSON.GET k1
"{\"c\":{\"a\":0,\"b\":2},\"e\":[1,2,3,4,5]}"
127.0.0.1:6379> JSON.SET k1 .e[-1] '0'
OK
127.0.0.1:6379> JSON.GET k1
"{\"c\":{\"a\":0,\"b\":2},\"e\":[1,2,3,4,0]}"
127.0.0.1:6379> JSON.SET k1 .e[5] '0'
(error) OUTOFBOUNDARIES Array index is out of bounds
```
# JSON.STRAPPEND
Anexa uma string às strings JSON no caminho.
Sintaxe
```
JSON.STRAPPEND [path]
```
+ key (obrigatório): chave do tipo de documento JSON
+ path (opcional): um caminho JSON. Assumirá o padrão da raiz se não for fornecido
+ json\$1string (obrigatório): a representação JSON de uma string. Observe que uma string JSON deve estar entre aspas, ou seja, “foo”.
**Return**
Se o caminho for uma sintaxe aprimorada:
+ Matriz de inteiros, representando o novo comprimento da matriz em cada caminho.
+ Se um valor não for uma string, seu valor de retorno correspondente será nulo.
+ Erro `SYNTAXERR ` se o argumento de entrada json não for uma string JSON válida.
+ Erro `NONEXISTENT ` 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.
+ Erro `WRONGTYPE` se o argumento da entrada json não for uma string JSON 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
```
# JSON.STRLEN
Obtém o comprimento dos valores da string JSON no caminho.
Sintaxe
```
JSON.STRLEN [path]
```
+ key (obrigatório): chave 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 representa o comprimento do valor da string em cada caminho.
+ Se um valor não for uma string, seu valor correspondente será nulo.
+ Nulo se a chave do documento não existir.
Se o caminho for uma sintaxe restrita:
+ Inteiro, o comprimento da string.
+ Se vários valores de string forem selecionados, o comando retornará o comprimento da primeira string.
+ Erro `WRONGTYPE` se o valor no caminho não for uma string.
+ `NONEXISTENT` 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":"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.STRLEN k1 $.a.a
1) (integer) 1
127.0.0.1:6379> JSON.STRLEN k1 $.a.*
1) (integer) 1
127.0.0.1:6379> JSON.STRLEN k1 $.c.*
1) (integer) 1
2) (integer) 2
127.0.0.1:6379> JSON.STRLEN k1 $.c.b
1) (integer) 2
127.0.0.1:6379> JSON.STRLEN k1 $.d.*
1) (nil)
2) (integer) 1
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.STRLEN k1 .a.a
(integer) 1
127.0.0.1:6379> JSON.STRLEN k1 .a.*
(integer) 1
127.0.0.1:6379> JSON.STRLEN k1 .c.*
(integer) 1
127.0.0.1:6379> JSON.STRLEN k1 .c.b
(integer) 2
127.0.0.1:6379> JSON.STRLEN k1 .d.*
(integer) 1
```
# JSON.TOGGLE
Alterna valores booleanos entre verdadeiro e falso no caminho.
Sintaxe
```
JSON.TOGGLE [path]
```
+ key (obrigatório): chave 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 (0 - falso, 1 - verdadeiro) que representam o valor booleano resultante em cada caminho.
+ Se um valor for um não booleano, seu valor de retorno correspondente será null.
+ `NONEXISTENT` se a chave do documento não existir.
Se o caminho for uma sintaxe restrita:
+ String (“verdadeiro”/“falso”) que representa o valor booleano resultante.
+ `NONEXISTENT` se a chave do documento não existir.
+ Erro `WRONGTYPE` se o valor no caminho não for um valor booleano.
**Exemplos**
Sintaxe do caminho aprimorada:
```
127.0.0.1:6379> JSON.SET k1 . '{"a":true, "b":false, "c":1, "d":null, "e":"foo", "f":[], "g":{}}'
OK
127.0.0.1:6379> JSON.TOGGLE k1 $.*
1) (integer) 0
2) (integer) 1
3) (nil)
4) (nil)
5) (nil)
6) (nil)
7) (nil)
127.0.0.1:6379> JSON.TOGGLE k1 $.*
1) (integer) 1
2) (integer) 0
3) (nil)
4) (nil)
5) (nil)
6) (nil)
7) (nil)
```
Sintaxe do caminho restrita:
```
127.0.0.1:6379> JSON.SET k1 . true
OK
127.0.0.1:6379> JSON.TOGGLE k1
"false"
127.0.0.1:6379> JSON.TOGGLE k1
"true"
127.0.0.1:6379> JSON.SET k2 . '{"isAvailable": false}'
OK
127.0.0.1:6379> JSON.TOGGLE k2 .isAvailable
"true"
127.0.0.1:6379> JSON.TOGGLE k2 .isAvailable
"false"
```
# JSON.TYPE
Informa tipo de valores em um determinado caminho.
Sintaxe
```
JSON.TYPE [path]
```
+ key (obrigatório): chave 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 strings, que representa o tipo de valor em cada caminho. O tipo é um destes \$1"null”, “boolean”, “string”, “number”, “integer”, “object” e “array"\$1.
+ Se um caminho não existir, seu valor de retorno correspondente será nulo.
+ Matriz vazia se a chave do documento não existir.
Se o caminho for uma sintaxe restrita:
+ String, tipo do valor
+ Nulo se a chave do documento não existir.
+ Nulo se o caminho JSON for inválido ou não existir.
**Exemplos**
Sintaxe do caminho aprimorada:
```
127.0.0.1:6379> JSON.SET k1 . '[1, 2.3, "foo", true, null, {}, []]'
OK
127.0.0.1:6379> JSON.TYPE k1 $[*]
1) integer
2) number
3) string
4) boolean
5) null
6) object
7) array
```
Sintaxe do caminho restrita:
```
127.0.0.1:6379> JSON.SET k1 . '{"firstName":"John","lastName":"Smith","age":27,"weight":135.25,"isAlive":true,"address":{"street":"21 2nd Street","city":"New York","state":"NY","zipcode":"10021-3100"},"phoneNumbers":[{"type":"home","number":"212 555-1234"},{"type":"office","number":"646 555-4567"}],"children":[],"spouse":null}'
OK
127.0.0.1:6379> JSON.TYPE k1
object
127.0.0.1:6379> JSON.TYPE k1 .children
array
127.0.0.1:6379> JSON.TYPE k1 .firstName
string
127.0.0.1:6379> JSON.TYPE k1 .age
integer
127.0.0.1:6379> JSON.TYPE k1 .weight
number
127.0.0.1:6379> JSON.TYPE k1 .isAlive
boolean
127.0.0.1:6379> JSON.TYPE k1 .spouse
null
```