Conectar
Copie a URL de conexão da página do banco de dados no dashboard:rediss:// (dois s): o servidor só aceita TLS, e não existe porta sem criptografia. Não é preciso certificado do cliente; para verificar o servidor, use o .pem de Conexão → Certificado SSL/TLS como CA. Uma URL salva de um banco criado antes de 29 de setembro de 2026 ainda pode estar com redis://: troque para rediss://.
- node-redis
- ioredis
- Python
- redis-cli
Comportamento da conexão
- Clientes inativos são desconectados depois de 300 segundos. Use um cliente que reconecta sozinho (node-redis, ioredis e redis-py fazem isso) ou envie um
PINGperiódico, como nos exemplos acima. - Um único banco lógico (0).
SELECT 1ou maior respondeERR DB index is out of range: separe os dados com prefixos de chave (cache:,session:). - Até 256 clientes simultâneos; passando disso, os novos recebem
max number of clients reached. Crie um cliente por processo e reutilize-o. - A autenticação é a senha do usuário
default. Não é possível criar outros usuários de ACL.
Comandos
Todos os comandos de dados funcionam, assim como scripts Lua e Functions, pub/sub,MULTI/EXEC, SCAN e SLOWLOG. Estes estão bloqueados e respondem NOPERM: FLUSHALL, FLUSHDB, SHUTDOWN, CONFIG, DEBUG, ACL, REPLICAOF/SLAVEOF e FAILOVER.
Sem o CONFIG, a política de eviction e as notificações de keyspace não podem ser mudadas. Para esvaziar o banco, apague as chaves em lotes com SCAN e UNLINK:
Módulos integrados
As queries de busca rodam em tantas threads quantas forem as vCPUs do banco.
Memória
- O Redis pode guardar dados até 90% da RAM do banco de dados. Os outros 10% cobrem o overhead dele, os buffers dos clientes e o espaço de que um save precisa.
- A política é
noeviction: quando a memória enche, nada é removido. As escritas falham comOOM command not allowed when used memory > 'maxmemory', enquanto as leituras continuam funcionando e o servidor continua de pé. - Por isso, defina uma expiração nas chaves de cache (
SET key value EX 3600,EXPIRE) e dimensione a RAM para os dados que não expiram. - Mudar a RAM do banco o reinicia.
Respostas grandes
Um cliente cujas respostas não lidas passam de 32 MB (ou ficam acima de 16 MB por 60 segundos) é desconectado; para assinantes de pub/sub, os limites são 32 MB e 8 MB por 60 segundos. Comandos que devolvem respostas enormes, comoKEYS * ou HGETALL/SMEMBERS em chaves gigantes, e assinantes que leem devagar demais são cortados. Itere com SCAN, HSCAN e SSCAN no lugar.
Persistência
- O Redis salva os dados em disco a cada 60 segundos quando houve pelo menos uma escrita. Não há append-only file, então uma queda ou uma parada por falta de memória perde até os últimos ~60 segundos de escritas. Mantenha os dados que você não pode perder também em um banco de dados principal.
- Se um save falha (armazenamento cheio, ou memória insuficiente para salvar), as escritas respondem
MISCONFaté um save dar certo, e os snapshots falham enquanto isso. Um save precisa de armazenamento livre ao lado do arquivo de dados atual, mais ou menos do tamanho dos dados.

