Estruturas de dados do Redis
Cada chave do Redis guarda um valor de um tipo, como string, lista, hash ou sorted set, que define quais comandos funcionam sobre ela. O Redis executa o comando por inteiro dentro do servidor, por isso o app envia o comando completo, como um LPUSH que acrescenta uma tarefa ou um INCR que soma um contador, sem ler o valor, alterar e gravar de volta.
Ficha e sumário da página
- Referência técnica
- Redis 8.10.3
- Revisão
- 13 de novembro de 2026
- Conteúdo
- Documentação oficial consultada
O tipo da chave define os comandos
O Redis guarda tudo num espaço de chaves único, sem tabelas nem colunas, no qual cada nome fica preso ao tipo do valor que criou a chave. A chave queue:default do Sidekiq é uma lista desde o primeiro LPUSH que a criou, por isso um comando de outro tipo sobre ela, como HGET, recebe o erro WRONGTYPE. A chave some quando o último item sai: uma lista esvaziada pelo worker deixa de existir até a próxima tarefa chegar.
Esse vínculo entre chave e tipo explica por que os apps escolhem o tipo com cuidado. O tipo certo traz o comando pronto para a tarefa, que o Redis executa em memória, perto do valor, sem idas e voltas entre o app e o servidor. Um contador de mensagens processadas, guardado numa string, sobe com um INCR, que o Redis aplica por inteiro mesmo com vários workers enviando o comando no mesmo instante.
Os seis tipos das filas e dos caches
Dos mais de dez tipos da documentação oficial, seis cobrem o que as filas e os caches dos apps usam:
stringUm valor de texto ou binário, como uma resposta em JSON guardada como cache, ou um número que INCR e DECR alteram.hashCampos e valores dentro de uma chave, como os atributos de um objeto, lidos com HGET sem trazer a chave inteira.listItens em ordem de inserção, acrescentados numa ponta e retirados na outra, o desenho de uma fila.setMembros únicos, sem ordem, com SADD e SISMEMBER para saber se um item já está no conjunto.sorted setMembros únicos com uma nota numérica, lidos em ordem de nota, como tarefas pela hora de execução.streamUm log de entradas só com acréscimo, lido por grupos de consumidores que confirmam cada entrada com XACK.
A lista é a estrutura das filas simples. A documentação do Redis cita duas aplicações diretas para ela: as pilhas e filas em geral e as filas de workers em segundo plano. Com LPUSH de um lado e BRPOP do outro, os itens saem na ordem de entrada. O B de BRPOP vem de blocking: o worker fica esperando na conexão até um item chegar ou o prazo acabar, sem consultar a lista em laço.
O sorted set cobre o caso que a lista não cobre: a ordem por um valor diferente da chegada. Cada membro carrega uma nota, pela qual o Redis mantém o conjunto ordenado. Quando a nota é um horário em segundos, o app pergunta ao Redis quais membros têm nota menor que agora e recebe as tarefas vencidas, em ordem.
O stream guarda as entradas como um log, cada uma com um ID crescente. Vários grupos de consumidores leem o mesmo log, cada grupo com a própria posição. A documentação descreve o stream como uma estrutura que funciona como um log só de acréscimo, com operações extras que contornam os limites de um log comum, como os grupos de consumidores. Por isso ele aparece quando uma mensagem precisa de confirmação de leitura, coisa que a lista e o pub/sub não oferecem.
As chaves do Sidekiq no Redis do Chatwoot
O Sidekiq, o processador de tarefas que o Chatwoot usa, combina quatro desses tipos para montar as filas. Os nomes abaixo estão no código do Sidekiq, nos arquivos client.rb e api.rb:
Redis do ChatwootUm banco lógico com as chaves do Sidekiq e as chaves de estado do app.queue:defaultLista. O app grava com LPUSH e o worker retira com BRPOP. Há uma por fila: queue:critical, queue:mailers e as demais.queuesSet com o nome de cada fila que já recebeu tarefa, gravado com SADD.scheduleSorted set das tarefas agendadas, com o horário de execução como nota.retrySorted set das tarefas que falharam e esperam nova tentativa.deadSorted set das tarefas que esgotaram as tentativas.stat:processedString com o total de tarefas processadas, lida com GET.
Cada caminho de tarefa passa por um tipo diferente. A tarefa comum vai direto para a lista da fila e sai pela ordem de chegada. A tarefa marcada para daqui a uma hora não entra na lista: o Sidekiq grava a tarefa no sorted set schedule, com o horário como nota. Depois, um processo do próprio Sidekiq move para a lista as tarefas cujo horário já passou. A tarefa que falha percorre o mesmo caminho pelo retry, com o horário da próxima tentativa como nota.
Para você, isso significa que o redis-cli mostra o estado das filas sem painel nenhum. O LLEN queue:default informa quantas tarefas esperam na fila padrão, enquanto o ZCARD retry informa quantas aguardam nova tentativa. Uma fila que só cresce aponta para workers parados ou lentos. Um retry cheio aponta para tarefas que falham repetidas vezes no mesmo ponto, como um e-mail com o servidor SMTP errado.
Tipos que vieram com o Redis 8
Da versão 8 em diante, o Redis Open Source traz dentro do servidor os tipos que antes eram módulos separados: JSON, busca, séries temporais e as estruturas probabilísticas, como o filtro de Bloom. A documentação de licenças do Redis registra que esses componentes seguem a mesma licença tripla do servidor e a mesma numeração de versão. A lista de tipos da documentação também traz os vector sets, usados em busca por similaridade.
Os apps das stacks dos portais não dependem desses tipos novos. O Sidekiq, o n8n e as filas do Laravel usam strings, hashes, listas, sets e sorted sets. Esses tipos existem no Redis desde as versões antigas e funcionam também no Valkey. Os tipos do Redis 8 entram quando o seu próprio código usa o Redis como banco de documentos JSON ou de vetores.
O tipo também define quanto de memória cada chave ocupa, um número que pesa porque a memória é o limite do Redis. O próxima página, Cache, expiração e memória, mostra como o TTL e a política de despejo definem qual chave sai quando ela acaba.