redis-cli — Interface de Linha de Comando do Redis

Quando Usar

Use esta habilidade quando precisar de referência e guia de uso da interface de linha de comando do Redis (redis-cli). Use esta habilidade sempre que o usuário mencionar redis-cli, Redis CLI, ou qualquer tarefa envolvendo consulta, inspeção, depuração ou gerenciamento do Redis a partir da linha de comando. Dispara em leituras e gravações de chave/valor, SCAN ou keyspace...

redis-cli é a principal ferramenta de linha de comando para interagir com o Redis. Ele suporta dois modos: execução em linha de comando (executa um comando e sai) e modo interativo (um REPL com preenchimento automático por tabulação, histórico e dicas). Ele também fornece modos especiais para monitoramento, análise de latência, varredura de keyspace e importação/exportação de dados.

Recursos oficiais: Documentação do Redis CLI | Comandos | Download

Pré-requisitos

# Check if redis-cli is installed
redis-cli --version

# Install options:

# macOS (Homebrew)
brew install redis

# Ubuntu / Debian
sudo apt install redis-tools

# CentOS / RHEL
sudo yum install redis

# Alpine
apk add redis

# Build from source (binary only)
make redis-cli
# Binary at: src/redis-cli

# Docker (no installation needed)
docker run -it --rm redis redis-cli -h <host> -p <port> PING

Considerações de Segurança

IMPORTANTE: O Redis fornece operações poderosas que podem modificar ou excluir dados de forma irreversível. Preste muita atenção às seguintes diretrizes de segurança:

• Nunca passe senhas via -a em produção — visível no histórico do shell e nas listagens de processos. Use a variável de ambiente REDISCLI_AUTH em vez disso.
• KEYS * bloqueia o servidor em bancos de dados grandes — sempre use SCAN em código de produção.
• MONITOR registra todos os comandos incluindo dados sensíveis — use com cautela e nunca por longos períodos em servidores de produção.
• FLUSHALL / FLUSHDB são irreversíveis — verifique o banco de dados de destino com CLIENT LIST ou INFO keyspace primeiro.
• --rdb transferência durante operações de gravação pode produzir snapshots inconsistentes em servidores ocupados.

Referência Rápida

Conexão

# Basic connection (default: 127.0.0.1:6379)
redis-cli
redis-cli -h redis15.localnet.org -p 6390 PING

# With password (prefer REDISCLI_AUTH env var for security)
redis-cli -a myUnguessablePazzzzzword123 PING

# URI connection
redis-cli -u redis://user:password@host:port/dbnum PING

# TLS
redis-cli --tls --cacert /path/to/ca.crt -h redis.example.com PING

# Specific database
redis-cli -n 2 DBSIZE

# IPv4/IPv6 preference
redis-cli -4 PING   # prefer IPv4
redis-cli -6 PING   # prefer IPv6

Modo Linha de Comando vs. Interativo

# Command-line mode: execute one command and exit
redis-cli INCR mycounter
redis-cli GET mykey

# Interactive mode: type commands at the prompt
redis-cli
127.0.0.1:6379> PING
PONG
127.0.0.1:6379> SELECT 2
OK
127.0.0.1:6379[2]> DBSIZE
(integer) 1

O prompt mostra host:port[db]. Use CONNECT <host> <port> para alternar instâncias interativamente.

Tabela de Consulta de Dados

Operações de String (O(1)):

GET key                        # Get value
SET key value [NX|XX] [EX sec|PX ms|KEEPTTL]  # Set with conditions/TTL
SET key value GET              # Set new, return old value
GETSET key newvalue            # [Use SET key value GET instead]
MGET key1 key2 ...             # Get multiple values
INCR key                       # Increment integer (+1)
INCRBY key 10                  # Increment by amount
STRLEN key                     # String length
GETRANGE key 0 50              # Substring

Operações de Hash:

HGET key field                 # Get field value            O(1)
HMGET key f1 f2                # Get multiple fields        O(N)
HGETALL key                    # Get all fields/values      O(N)
HKEYS key                      # Get all field names        O(N)
HLEN key                       # Number of fields           O(1)
HEXISTS key field              # Check field exists         O(1)
HSCAN key 0 [MATCH pat]        # Iterate hash fields        O(1) per call

Operações de Lista:

LRANGE key 0 -1                # Get all elements           O(N)
LLEN key                       # List length                O(1)
LINDEX key 0                   # Get by index               O(N)
LPOS key value                 # Find element position      O(N)

Operações de Conjunto:

SMEMBERS key                   # Obtém todos os membros            O(N)

…