Tipo de dados básicos do Redis (string)
Tipo de armazenamento
int (inteiro), float (número de ponto flutuante de precisão simples), string (string)
Comandos de operação comuns
definir
-
comando
SET key value [EX seconds] [PX milliseconds] [NX|XX]
-
Descrição
Defina a chave com o valor "string" especificado.
Se a chave salvou um valor, esta operação substituirá diretamente o valor original e ignorará o tipo original.
Quando o comando set é executado com sucesso, o tempo de expiração definido antes será inválido -
Opções
A partir da versão 2.6.12, o redis adicionou uma série de opções ao comando SET:- EX segundos - Defina o tempo de expiração da chave, a unidade é hora e segundo
- PX milissegundos - defina o tempo de expiração da chave, a unidade é milissegundos
- NX- O valor da chave só será definido se a chave não existir
- XX-O valor da chave só será definido se a chave existir
Nota: Como o comando SET mais as opções podem substituir completamente as funções de SETNX, SETEX, PSETEX, em versões futuras, o redis pode ser descontinuado e, eventualmente, abandonar esses comandos.
-
valor de retorno
Se o
SET
comando foi executado normalmente e depois retornaOK
, ou se adicionouNX
ouXX
opções, mas não defina as condições. Em seguida, ele retornará nulo. -
exemplo
redis> SET mykey "Hello" OK redis> GET mykey "Hello" redis>
obter
-
comando
GET key
-
Descrição
Retorno
key
devalue
. Se a chave não existir, retorne um valor especialnil
. Se nãokey
forvalue
uma string, um erro é retornado, porqueGET
apenas strings do tipo string são processadasvalues
. -
valor de retorno
O valor correspondente à chave ou nulo (quando a chave não existe)
-
exemplo
redis> GET nonexisting (nil) redis> SET mykey "Hello" OK redis> GET mykey "Hello" redis>
mset
-
comando
MSET key value [key value ...]
-
Descrição
Corresponde às chaves fornecidas aos seus valores correspondentes.
MSET
Substituirá o valor existente pelo novo valor, assim como um comando SET normal . Se você não quiser sobrescrever os valores existentes, consulte o comando MSETNX .MSET
É atômico, então todas as chaves fornecidas são definidas de uma vez. É impossível para o cliente ver que algumas das chaves foram atualizadas e outras não. -
valor de retorno
Sempre OK, porque o MSET não falhará.
-
exemplo
redis> MSET key1 "Hello" key2 "World" OK redis> GET key1 "Hello" redis> GET key2 "World" redis>
mget
-
comando
MGET key [key ...]
-
Descrição
Retorna o valor de todas as chaves especificadas. Para cada chave que não corresponde a uma string ou não existe, um valor especial é retornado
nil
. Por causa disso, essa operação nunca falha. -
valor de retorno
Lista de valores correspondentes à chave especificada
-
exemplo
redis> SET key1 "Hello" OK redis> SET key2 "World" OK redis> MGET key1 key2 nonexisting 1) "Hello" 2) "World" 3) (nil) redis>
getrange
-
comando
GETRANGE key start end
-
Descrição
Aviso : este comando foi alterado para GETRANGE, denominado SUBSTR no Redis versão anterior a 2.0. Retorne a substring do valor da string correspondente à chave. Essa substring é determinada pelo deslocamento de início e fim (ambos estão na string). Você pode usar um deslocamento negativo para representar o subscrito começando do final da string. Portanto, -1 é o último caractere, -2 é o penúltimo caractere e assim por diante.
Quando essa função lida com solicitações fora do intervalo, ela limita o resultado a string.
-
exemplo
redis> SET mykey "This is a string" OK redis> GETRANGE mykey 0 3 "This" redis> GETRANGE mykey -3 -1 "ing" redis> GETRANGE mykey 0 -1 "This is a string" redis> GETRANGE mykey 10 100 "string" redis>
Strlen
-
comando
STRLEN key
-
Descrição
Retorna o comprimento do valor da string da chave. Se a chave corresponder a um tipo diferente de string, um erro será retornado.
-
valor de retorno
O comprimento do valor da string correspondente à chave ou 0 (a chave não existe)
-
exemplo
redis> SET mykey "Hello world" OK redis> STRLEN mykey (integer) 11 redis> STRLEN nonexisting (integer) 0 redis>
acrescentar
-
comando
APPEND key value
-
Descrição
Se
key
já existir e o valor for uma string, o comando serávalue
anexado ao final do valor original (valor) de. Sekey
não estiver presente, ele primeiro criará uma string vazia ekey
, em seguida, executará operações adicionais, esta situação APPEND será semelhante à operação SET . -
valor de retorno
Retorna o comprimento do valor da string (valor) após anexar.
-
exemplo
redis> EXISTS mykey (integer) 0 redis> APPEND mykey "Hello" (integer) 5 redis> APPEND mykey " World" (integer) 11 redis> GET mykey "Hello World" redis>
incr
-
comando
INCR key
-
Descrição
key
Execute uma operação de incremento atômico no valor armazenado no valor especificado .Se a chave especificada não existir, seu valor será definido como antes de realizar a operação incr
0
.Se o valor armazenado na chave especificada não for um tipo de string (fix :) ou o tipo de string armazenado não puder ser representado como um inteiro,
Em seguida, o servidor retornará um erro ao executar este comando (eq: (erro) O valor ERR não é um número inteiro ou está fora do intervalo).
Esta operação é limitada a dados inteiros assinados de 64 bits.
Observação : como o redis não tem um tipo claro para representar dados inteiros, essa operação é uma operação de string.
Ao realizar esta operação, a string armazenada correspondente à chave é analisada em dados decimais inteiros assinados de 64 bits .
Na verdade, o Redis usa internamente uma representação de inteiro para armazenar o valor inteiro correspondente, portanto, esse tipo de valor de string é armazenado como um inteiro, portanto, não há representação de string que armazena um inteiro.
-
valor de retorno
O
key
valor correspondente após a execução da operação de incremento . -
exemplo
redis> SET mykey "10" OK redis> INCR mykey (integer) 11 redis> GET mykey "11" redis>
incrby
-
comando
INCRBY key increment
-
Descrição
Adicione decremento ao número correspondente à chave. Se a chave não existir, ela será definida como 0 antes da operação. Se o tipo de valor da chave estiver errado ou se for uma string que não pode ser representada como um número, um erro será retornado. Esta operação suporta números positivos com sinal de até 64 bits.
Consulte o comando INCR para obter informações adicionais sobre as operações de aumento e diminuição.
-
valor de retorno
O valor após o aumento.
-
exemplo
redis> SET mykey "10" OK redis> INCRBY mykey 5 (integer) 15 redis>
incrbyfloat
-
comando
INCRBYFLOAT key increment
-
Descrição
key
Aumente o valor do número de ponto flutuante (armazenado na string) especificando um número de ponto flutuante . Quando a chave não existe, primeiro defina seu valor como 0 antes de operar. Qualquer um dos seguintes retornará um erro:- A chave contém um valor ilegal (não uma string).
- A chave atual ou o valor adicionado não podem ser analisados como um valor de ponto flutuante de precisão dupla (excedendo o intervalo de precisão)
Se o comando de operação for bem-sucedido, o valor adicionado irá substituir o valor original e armazená-lo no valor-chave correspondente, e retorná-lo no tipo de string. O valor armazenado na string ou o parâmetro de adição pode ser selecionado arbitrariamente com o exponencial símbolo, mas a adição é calculada O resultado será armazenado no formato de notação científica. Independentemente da precisão interna de cada cálculo, a precisão de saída é fixada em 17 casas decimais
-
valor de retorno
O
key
valor atual após o incremento é aumentado. -
exemplo
redis> SET mykey 10.50 OK redis> INCRBYFLOAT mykey 0.1 "10.6" redis> SET mykey 5.0e3 OK redis> INCRBYFLOAT mykey 2.0e2 "5200" redis>
decr
-
comando
DECR key
-
Descrição
Subtraia 1 do número correspondente à chave. Se a chave não existir, o valor correspondente a esta chave será definido como 0 antes da operação. Se a chave tiver um valor do tipo errado ou uma string que não pode ser representada como um número, um erro será retornado. Esta operação oferece suporte a números inteiros assinados de até 64 bits.
Consulte o comando INCR para obter informações adicionais sobre as operações de aumento e diminuição.
-
valor de retorno
Valor após redução
-
exemplo
redis> SET mykey "10" OK redis> DECR mykey (integer) 9 redis> SET mykey "234293482390480948029348230948" OK redis> DECR mykey ERR value is not an integer or out of range redis>
decrby
-
comando
DECRBY key decrement
-
Descrição
Diminua o número correspondente à chave. Se a chave não existir, ela será definida como 0 antes da operação. Se o tipo de valor da chave estiver errado ou se for uma string que não pode ser representada como um número, um erro será retornado. Esta operação suporta números positivos com sinal de até 64 bits.
Consulte o comando INCR para obter informações adicionais sobre as operações de aumento e diminuição.
-
valor de retorno
Retorna um número: o valor após a redução.
-
exemplo
redis> SET mykey "10" OK redis> DECRBY mykey 5 (integer) 5 redis>
do
-
comando
DEL key [key ...]
-
Descrição
Exclua o lote de chaves especificado. Se algumas chaves na exclusão não existirem, elas serão ignoradas.
-
valor de retorno
O número de chaves excluídas
-
exemplo
redis> SET key1 "Hello" OK redis> SET key2 "World" OK redis> DEL key1 key2 key3 (integer) 2 redis>