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á.
Define os valores JSON no caminho.
Se o caminho exigir um membro do objeto:
Se o elemento pai não existir, o comando retornará um erro INEXISTENT.
Se o elemento pai não existir, 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 comandoretornará um erro INEXISTENT.
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á um erro INEXISTENT.
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 comandoretornará um 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 <key> <path> <json> [NX | XX]
[NX | XX] Onde é possível ter 0 ou 1 de identificadores [NX | XX].
chave (obrigatório): uma chave do Valkey ou Redis OSS 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. Isto é, insira um novo documento. Se o caminho não for a raiz, defina o valor somente se a chave Redis não existir. Isto é, insira um valor no documento.
XX (opcional): se o caminho for a raiz, defina o valor somente se a chave existir. Isto é, substitua o documento existente. Se o caminho não for a raiz, defina o valor somente se a chave Redis existir. Isto é, 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
