Cache Redis

O runner de Cache Redis (CACHE_REDIS) é o plugin responsável por realizar operações de leitura, escrita, remoção e consulta de existência de dados em instâncias do Redis (seja em arquitetura Standalone, Cluster ou Sentinel).

Ele permite que os fluxos manipulem estruturas de dados temporárias e de altíssima performance para implementar estratégias de caching, controle de concorrência, limitações de taxa (rate-limiting) ou armazenamento de contadores e sessões temporárias.

---

Ciclo de Funcionamento

1. Resolução da Instância

   O runner obtém a conexão da instância Redis configurada no ambiente a partir do pool gerenciado de conexões.

2. Interpolação do Comando e Chave

   O motor de substituição resolve as expressões dinâmicas ${...} presentes no nome da chave (key), no valor (value) e nas propriedades de expiração (TTL).

3. Execução da Operação

   Executa o comando nativo correspondente no servidor Redis (ex: GET, SET, DEL, EXISTS, INCR, EXPIRE).

4. Mapeamento de Retorno

   Grava a resposta devolvida pelo Redis no histórico da etapa (historico.alias.body), disponibilizando o conteúdo para consulta nos nós seguintes do fluxo.

Arquitetura Standalone

Instância única do Redis, adequada para ambientes de desenvolvimento e cargas menores.

Arquitetura Cluster

Distribuição de dados entre múltiplos nós com particionamento (sharding) e alta disponibilidade.

Arquitetura Sentinel

Monitoramento e failover automático entre réplicas para maior resiliência do cache.

Tip

Se o bdot:ttl for omitido no comando SET, a chave não expira — defina o tempo de vida (Time To Live) para evitar acúmulo indefinido de dados no cache.

---

Parâmetros e Formulário de Configuração

Os parâmetros deste runner são configurados no Editor Visual e serializados no mapa de definição da etapa:

Campo no Formulário / Atributo JSON	Tipo	Obrigatório	Descrição
bdot:instancia	String	Sim	Nome ou identificador da instância do servidor/cluster Redis previamente cadastrada no ambiente.
bdot:operacao	String	Sim	Operação a ser realizada no Redis (GET, SET, DEL, EXISTS, EXPIRE, INCR).
bdot:chave	String	Sim	Chave de identificação no Redis. Suporta interpolação de variáveis (ex: sessao:${entrada.body.usuarioId}).
bdot:valor	String	Condicional	Conteúdo a ser gravado no Redis em formato texto ou JSON. Suporta interpolação. Obrigatório se bdot:operacao = SET.
bdot:ttl	Long	Não	Tempo de vida (Time To Live) do registro em segundos. Se omitido no comando SET, a chave não expira.

---

Exemplo de Configuração JSON da Etapa

Exemplo da estrutura das chaves bdot:* geradas pelo Editor Visual para este runner:

definicao.json

{
  "bdot:instancia": "redis_cluster_sessao",
  "bdot:operacao": "SET",
  "bdot:chave": "token_acesso:${dados.usuario.cpf}",
  "bdot:valor": "{\"status\": \"AUTORIZADO\", \"perfis\": ${dados.usuario.perfis}}",
  "bdot:ttl": 3600
}