Tair (Redis® OSS-Compatible):Documento

Pré-requisitos

Antes de começar, certifique-se de ter:

• Uma DRAM-based instance do Tair

• Versão secundária da instância 1.8.4 ou posterior (necessária para suporte total a JSONPath por meio de JSON.GET)

Para atualizar sua instância para a versão secundária mais recente, consulte Update the minor version of an instance.

Para instâncias em cluster ou com divisão de leitura e escrita, atualize os nós de proxy para a versão secundária mais recente para garantir que todos os comandos funcionem conforme o esperado.

Lista de comandos

Convenções de sintaxe usadas nesta referência:

• UPPERCASE: palavra-chave do comando

• _italic_: variável

• [option]: parâmetro opcional

• A | B: opções mutuamente exclusivas

• ...: parâmetro repetível

JSON.SET

Sintaxe: JSON.SET key path json [NX | XX]

Cria uma chave TairDoc e armazena um elemento JSON no caminho especificado. Se a chave e o caminho já existirem, atualiza o elemento.

Parâmetros:

Valores de retorno:

Exemplo — criar um documento JSON:

O comando a seguir cria uma chave doc no caminho raiz ($) e armazena um documento de uma livraria com quatro livros e uma bicicleta:

JSON.SET doc $ '{ "store": { "book": [ { "category": "reference", "author": "Nigel Rees", "title": "Sayings of the Century", "price": 8.95 }, { "category": "fiction", "author": "Evelyn Waugh", "title": "Sword of Honour", "price": 12.99 }, { "category": "fiction", "author": "Herman Melville", "title": "Moby Dick", "isbn": "0-553-21311-3", "price": 8.99 }, { "category": "fiction", "author": "J. R. R. Tolkien", "title": "The Lord of the Rings", "isbn": "0-395-19395-8", "price": 22.99 } ], "bicycle": { "color": "red", "price": 19.95 } } }'

Saída esperada:

OK

JSON.GET

Sintaxe: JSON.GET key path [FORMAT XML | YAML] [ROOTNAME root] [ARRNAME arr]

Recupera o elemento JSON no caminho especificado. Suporta as sintaxes JSONPath e JSON Pointer.

Parâmetros:

Valores de retorno:

Exemplo — recuperar um documento como XML:

Primeiro, crie o documento:

JSON.SET doc . '{"foo": "bar", "baz" : 42}'

Em seguida, recupere-o como XML, especificando ROOT como o nome da tag raiz e ARR como o nome da tag do array:

JSON.GET doc . FORMAT XML ROOTNAME ROOT ARRNAME ARR

Saída esperada:

"<?xml version=\"1.0\" encoding=\"UTF-8\"?><ROOT><foo>bar</foo><baz>42</baz></ROOT>"

JSON.DEL

Sintaxe: JSON.DEL key path

Exclui o elemento JSON no caminho especificado. Se nenhum caminho for fornecido, exclui a chave inteira. Não executa nenhuma ação e não retorna erro se a chave ou o caminho não existir.

Parâmetros:

Valores de retorno:

Exemplo — excluir um campo:

Primeiro, crie o documento:

JSON.SET doc . '{"foo": "bar", "baz" : 42}'

Exclua o campo foo:

JSON.DEL doc .foo

Saída esperada — 1 indica que o elemento foi excluído:

(integer) 1

JSON.TYPE

Sintaxe: JSON.TYPE key path

Retorna o tipo do elemento JSON no caminho especificado.

Parâmetros:

Valores de retorno:

Exemplo — obter o tipo de um campo:

Primeiro, crie o documento:

JSON.SET doc . '{"foo": "bar", "baz" : 42}'

Obtenha o tipo do campo foo ("bar" é uma string):

JSON.TYPE doc .foo

Saída esperada:

string

JSON.MERGE

Sintaxe: JSON.MERGE key path value

Mescla um valor JSON no caminho especificado. Suporta a adição de novos valores, a atualização de valores existentes e a exclusão de valores no caminho especificado.

Parâmetros:

Valores de retorno:

Exemplo — adicionar, atualizar e excluir valores em uma única operação:

Primeiro, crie o documento:

JSON.SET doc $ '{"f1": {"a":1}, "f2":{"a":2}}'

Mescle as alterações: defina f1 como null (isso o exclui), atualize f2.a, adicione f2.b e adicione um novo array f3:

JSON.MERGE doc $ '{"f1": null, "f2":{"a":3, "b":4}, "f3":[2,4,6]}'

Saída esperada:

OK

Verifique o resultado com JSON.GET doc .. O patch de mesclagem remove a chave f1 porque definir um campo como null o exclui:

"{\"f2\":{\"a\":3,\"b\":4},\"f3\":[2,4,6]}"

JSON.NUMINCRBY

Sintaxe: JSON.NUMINCRBY key path value

Incrementa o elemento JSON numérico no caminho especificado. Tanto o elemento existente quanto o valor de incremento devem ser do mesmo tipo: inteiro ou double.

Parâmetros:

Valores de retorno:

Exemplo — incrementar um campo numérico:

Primeiro, crie o documento:

JSON.SET doc . '{"foo": "bar", "baz" : 42}'

Incremente baz em 10 (42 + 10 = 52):

JSON.NUMINCRBY doc .baz 10

Saída esperada:

"52"

JSON.STRAPPEND

Sintaxe: JSON.STRAPPEND key path json-string

Anexa uma string ao elemento de string JSON no caminho especificado. Tanto o elemento existente quanto o valor anexado devem ser do tipo string.

Parâmetros:

Valores de retorno:

Exemplo — anexar a um campo de string:

Primeiro, crie o documento:

JSON.SET doc . '{"foo": "bar", "baz" : 42}'

Anexe rrrrr a foo — "bar" se torna "barrrrrr", que possui 8 caracteres:

JSON.STRAPPEND doc .foo rrrrr

Saída esperada:

(integer) 8

JSON.STRLEN

Sintaxe: JSON.STRLEN key path

Retorna o comprimento em caracteres do elemento de string JSON no caminho especificado. O elemento deve ser do tipo string.

Parâmetros:

Valores de retorno:

Exemplo — obter o comprimento de um campo de string:

Primeiro, crie o documento:

JSON.SET doc . '{"foo": "bar", "baz" : 42}'

Obtenha o comprimento de foo — "bar" possui 3 caracteres:

JSON.STRLEN doc .foo

Saída esperada:

(integer) 3

JSON.ARRAPPEND

Sintaxe: JSON.ARRAPPEND key path json [json ...]

Anexa um ou mais elementos JSON ao final de um array. A complexidade de tempo é O(M×N), onde M é o número de elementos a serem anexados e N é o comprimento atual do array.

Parâmetros:

Valores de retorno:

Exemplo — anexar vários elementos a um array:

Primeiro, crie o documento:

JSON.SET doc . '{"id": [1,2,3]}'

Anexe null, false e true ao array id. O array passa de 3 para 6 elementos:

JSON.ARRAPPEND doc .id null false true

Saída esperada:

(integer) 6

JSON.ARRPOP

Sintaxe: JSON.ARRPOP key path [index]

Remove e retorna o elemento no índice especificado em um array. A complexidade de tempo é O(M×N), onde M é o número de elementos filhos na chave e N é o comprimento do array.

Parâmetros:

Valores de retorno:

Exemplo — remover o primeiro elemento de um array:

Primeiro, crie o documento:

JSON.SET doc . '{"id": [1,2,3]}'

Remova e retorne o elemento no índice 0 (o primeiro elemento, 1):

JSON.ARRPOP doc .id 0

Saída esperada:

"1"

JSON.ARRINSERT

Sintaxe: JSON.ARRINSERT key path [index] json [json ...]

Insere um ou mais elementos JSON em um array antes do índice especificado. A complexidade de tempo é O(M×N), onde M é o número de elementos a serem inseridos e N é o comprimento atual do array.

Parâmetros:

Valores de retorno:

Exemplo — inserir elementos no início de um array:

Primeiro, crie o documento:

JSON.SET doc . '{"id": [1,2,3]}'

Insira 10 e 15 antes do índice 0. O array resultante é [10, 15, 1, 2, 3]:

JSON.ARRINSERT doc .id 0 10 15

Saída esperada:

(integer) 5

JSON.ARRLEN

Sintaxe: JSON.ARRLEN key path

Retorna o número de elementos em um array.

Parâmetros:

Valores de retorno:

Exemplo — obter o comprimento de um array:

Primeiro, crie o documento:

JSON.SET doc . '{"id": [1,2,3]}'

Obtenha o número de elementos no array id:

JSON.ARRLEN doc .id

Saída esperada:

(integer) 3

JSON.ARRTRIM

Sintaxe: JSON.ARRTRIM key path start stop

Recorta um array para manter apenas os elementos dentro do intervalo [start, stop] (inclusivo) e remove todos os elementos fora desse intervalo.

Parâmetros:

Valores de retorno:

Exemplo — recortar um array para um subintervalo:

Primeiro, crie o documento:

JSON.SET doc . '{"id": [1,2,3,4,5,6]}'

Recorte o array para manter apenas os elementos nos índices 3 e 4 (valores 4 e 5). Os elementos fora desse intervalo são descartados:

JSON.ARRTRIM doc .id 3 4

Saída esperada — 2 elementos permanecem:

(integer) 2

JSONPath

O JSON.GET aceita a sintaxe JSONPath RFC draft-4 para consultas flexíveis. O suporte total a JSONPath requer a versão 1.8.4 ou posterior.

Seletores aceitos:

Exemplos de consulta:

Os exemplos a seguir usam este documento de uma livraria. Crie-o primeiro:

JSON.SET dockey $
'{
    "store": {
        "book": [{
                "category": "reference",
                "author": "Nigel Rees",
                "title": "Sayings of the Century",
                "price": 8.95
            },
            {
                "category": "fiction",
                "author": "Evelyn Waugh",
                "title": "Sword of Honour",
                "price": 12.99
            },
            {
                "category": "fiction",
                "author": "Herman Melville",
                "title": "Moby Dick",
                "isbn": "0-553-21311-3",
                "price": 8.99
            },
            {
                "category": "fiction",
                "author": "J. R. R. Tolkien",
                "title": "The Lord of the Rings",
                "isbn": "0-395-19395-8",
                "price": 22.99
            }
        ],
        "bicycle": {
            "color": "red",
            "price": 19.95
        }
    },
    "expensive": 10
}'

Saída esperada:

OK

JSON.GET dockey $

"[{"store":{"book":[{"category":"reference","author":"Nigel Rees","title":"Sayings of the Century","price":8.95},{"category":"fiction","author":"Evelyn Waugh","title":"Sword of Honour","price":12.99},{"category":"fiction","author":"Herman Melville","title":"Moby Dick","isbn":"0-553-21311-3","price":8.99},{"category":"fiction","author":"J. R. R. Tolkien","title":"The Lord of the Rings","isbn":"0-395-19395-8","price":22.99}],"bicycle":{"color":"red","price":19.95}}}]"

JSON.GET dockey $.store.bicycle.*

"["red",19.95]"

JSON.GET dockey $.store.bicycle.price

"[19.95]"

JSON.GET dockey $.store.book[0]

"[{"category":"reference","author":"Nigel Rees","title":"Sayings of the Century","price":8.95}]"

JSON.GET dockey "$.store.book[*]['title']"

"["Sayings of the Century","Sword of Honour","Moby Dick","The Lord of the Rings"]"

JSON.GET dockey $.store.book[0:2:1]

"[{"category":"reference","author":"Nigel Rees","title":"Sayings of the Century","price":8.95},{"category":"fiction","author":"Herman Melville","title":"Moby Dick","isbn":"0-553-21311-3","price":8.99},{"category":"fiction","author":"Evelyn Waugh","title":"Sword of Honour","price":12.99}]"

JSON.GET dockey $..price

"[8.95,12.99,8.99,22.99,19.95]"

JSON.GET dockey $.store.book[0,2]

"[{"category":"reference","author":"Nigel Rees","title":"Sayings of the Century","price":8.95},{"category":"fiction","author":"Herman Melville","title":"Moby Dick","isbn":"0-553-21311-3","price":8.99}]"

JSON.GET dockey $.store.book[?(@.isbn)]

"[{"category":"fiction","author":"Herman Melville","title":"Moby Dick","isbn":"0-553-21311-3","price":8.99},{"category":"fiction","author":"J. R. R. Tolkien","title":"The Lord of the Rings","isbn":"0-395-19395-8","price":22.99}]"

JSON.GET dockey '$.store.book[?(@.price < 10)]'

"[{"category":"reference","author":"Nigel Rees","title":"Sayings of the Century","price":8.95},{"category":"fiction","author":"Herman Melville","title":"Moby Dick","isbn":"0-553-21311-3","price":8.99}]"

JSON.GET dockey "$..book[?((@.price == 12.99 || @.price > $.store.bicycle.price) || @.category == 'reference')]"

"[{"category":"reference","author":"Nigel Rees","title":"Sayings of the Century","price":8.95},{"category":"fiction","author":"J. R. R. Tolkien","title":"The Lord of the Rings","isbn":"0-395-19395-8","price":22.99},{"category":"fiction","author":"Evelyn Waugh","title":"Sword of Honour","price":12.99}]"

JSON Pointer

O TairDoc suporta totalmente a sintaxe JSON Pointer (RFC 6901). Use caminhos delimitados por / para navegar em um documento.

Exemplo — recuperar um elemento de array aninhado:

Primeiro, crie o documento:

JSON.SET doc . '{"foo": "bar", "baz" : [1,2,3]}'

Recupere o primeiro elemento do array baz usando o caminho JSON Pointer /baz/0:

JSON.GET doc /baz/0

Saída esperada:

"1"