Pular para o conteúdo principal
Um servidor Redis gerenciado acessado por TLS, com os módulos Search, JSON, TimeSeries, probabilísticos e vector sets integrados. O que vale para todos os engines (limites, snapshots, Insights) está na visão geral de Bancos de dados.

Conectar

Copie a URL de conexão da página do banco de dados no dashboard:
O esquema é 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://.

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 PING periódico, como nos exemplos acima.
  • Um único banco lógico (0). SELECT 1 ou maior responde ERR 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 com OOM 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, como KEYS * 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 MISCONF até 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.

Redefinição de senha

Redefinir a senha reinicia o Redis, que só lê a senha quando inicia: ele fica offline por alguns segundos e todas as conexões são fechadas. Atualize a URL nas suas aplicações e deixe que elas reconectem.

Snapshots

Um snapshot do Redis é o arquivo de dados salvo. Restaurar um traz os dados de volta e mantém a senha atual do banco. Veja snapshots e restauração.

Erros comuns

Contate-nos

Se você continuar enfrentando dificuldades técnicas, nossa equipe de suporte especializada está disponível para auxiliá-lo. Entre em contato conosco e teremos prazer em ajudá-lo a resolver qualquer questão: a qualidade do suporte é uma grande parte do motivo pelo qual desenvolvedores avaliam a Square Cloud com 4,9/5 em 402 avaliações no Google e Trustpilot.