Skip to content
mobius1qwe edited this page Nov 17, 2026 · 1 revision

Home > Redis e Valkey 🚧

Redis e Valkey

Important

Em desenvolvimento (2.0). Ainda não está numa versão lançada e pode mudar.

Vale para a 2.0 · Delphi XE em diante e Lazarus/FPC 3.2 em diante · Nível: intermediário

Em uma frase: o TRALRedisClient conversa com um servidor Redis ou Valkey; o TRALRedisStore guarda nele as sessões, os limites de pedidos e os tokens revogados, para que vários servidores do seu sistema, em máquinas diferentes, enxerguem os mesmos dados.

Você vai precisar: o pacote RALStoreRedisPackage (requer PascalRAL e RALNetPackage) e um servidor Redis ou Valkey (RESP3 e usuários de ACL pedem o Redis 6 ou mais novo; num mais velho o cliente fala RESP2). Para os hubs em vários servidores, também RALModuleWebSocketRedisPackage.

Na IDE, sem código

  1. Solte um TRALRedisClient (paleta RAL - Plugins) e preencha Host, Port e, se o servidor pede, Password (e UserName para um usuário de ACL).
  2. Solte um TRALRedisStore e aponte Client para ele.
  3. No plugin de limite (TRALRateLimitPlugin.Store) ou no módulo web (SessionStorage := wssStore, SessionStore), escolha esse store.

Pronto: dois servidores com a mesma configuração passam a somar o mesmo limite e a ler a mesma sessão, seja qual for o servidor que atende o pedido.

Comandos

uses RALRedisClient;

  Redis := TRALRedisClient.Create(Self);
  Redis.Host := 'redis.interno';
  Redis.Password := 'segredo';

  Redis.SetValue('saudacao', 'olá', 60000);   // expira em 60 s
  if Redis.GetValue('saudacao', Valor) then
    ShowMessage(string(Valor));
  Total := Redis.Increment('visitas');
  Redis.HashSet('cliente:42', 'nome', 'Ana');
  Redis.ListPush('fila', 'tarefa 1');
  Redis.Publish('avisos', 'manutenção às 22h');

Qualquer comando vai por Command, que devolve a resposta (você libera):

Resposta := Redis.Command(['ZADD', 'placar', '120', 'ana']);
try
  ShowMessage(Resposta.AsString);
finally
  Resposta.Free;
end;
  • Os valores são binários (RawByteString): passam bytes quaisquer, inclusive #0.
  • Uma resposta de erro do servidor (WRONGTYPE, NOAUTH...) levanta ERALRedisReplyError, com o texto do servidor em ServerError; falha de rede, senha recusada ou tempo esgotado levantam ERALRedisError.
  • O cliente pode ser usado por várias threads ao mesmo tempo: cada comando pega uma conexão do pool (PoolSize conexões ociosas guardadas) e devolve.
  • Protocol = rp3 (o padrão) fala RESP3; num servidor anterior ao Redis 6 a conexão volta sozinha ao RESP2.

Vários comandos de uma vez

Lote := Redis.NewPipeline;          // NewPipeline(True): MULTI/EXEC, tudo ou nada
try
  Lote.Add(['INCR', 'a']);
  Lote.Add(['INCR', 'b']);
  Respostas := Lote.Execute;        // uma ida e volta só
  try
    ...
  finally
    Respostas.Free;
  end;
finally
  Lote.Free;
end;

Num lote, um comando recusado vira uma resposta de erro na lista (Kind = rrkError), não uma exceção.

Publicar e assinar (pub/sub)

uses RALRedisSubscriber;

  Assinante := TRALRedisSubscriber.Create(Self);
  Assinante.Client := Redis;
  Assinante.Channels.Add('avisos');
  Assinante.Patterns.Add('pedido:*');
  Assinante.OnMessage := ChegouMensagem;
  Assinante.Active := True;

procedure TForm1.ChegouMensagem(Sender: TObject; const AChannel, APattern: StringRAL;
  const APayload: RawByteString);
begin
  Log(AChannel + ': ' + string(APayload));
end;

O assinante usa uma conexão e uma thread só dele. Se a conexão cair, ele reconecta depois de ReconnectInterval ms e assina tudo de novo. Subscribe e Unsubscribe mudam a lista com ele rodando. O evento roda na thread do assinante; num programa com tela, ligue SynchronizeEvents para recebê-lo na thread principal.

Sessões e limites em vários servidores

Store := TRALRedisStore.Create(Self);
Store.Client := Redis;
Store.KeyPrefix := 'loja:';          // separa aplicações que dividem o mesmo Redis

Web.SessionStorage := wssStore;
Web.SessionStore := Store;
Limite.Store := Store;               // TRALRateLimitPlugin

O TRALRedisStore é um TRALKeyValueStore como o TRALMemoryStore e o TRALFileStore: tudo o que aceita um store aceita este. O tempo de vida das chaves é contado pelo próprio Redis. Clear apaga só as chaves de KeyPrefix.

Hubs em vários servidores

Backplane := TRALHubRedisBackplane.Create(Self);
Backplane.Client := Redis;
Backplane.Hub := Hub;                 // o canal é ralhub:<nome do hub>

Funciona como o backplane MQTT da página Hubs: ao ativar o servidor, ele assina o canal; todo Emit vai aos outros servidores. Subscribed diz quando a assinatura está de pé.

TLS

SSL.Enabled := True liga TLS (o rediss:// dos outros clientes). A regra do certificado é a mesma do TRALClient: OnValidateServerCert, depois SSL.Pins, depois a validação da OpenSSL. CAFile, CertFile e KeyFile servem para um servidor com CA própria ou certificado de cliente.

Erros comuns

sintoma causa o que fazer
NOAUTH Authentication required o servidor tem senha e Password está vazio preencha Password
WRONGPASS ou "recusou o login" senha ou UserName errados confira a senha e o usuário de ACL
"não foi possível conectar" servidor parado, porta errada ou bind só em 127.0.0.1 confira Host/Port e o bind do redis.conf
a sessão não aparece no outro servidor stores com KeyPrefix diferente, ou bancos diferentes (Database) mesmo KeyPrefix e mesmo Database nos dois
o assinante não recebe o evento roda numa thread e você mexeu na tela SynchronizeEvents := True

Veja também

Começar

Servidor

MQTT 🚧

E-mail 🚧

Chatbot 🚧

Cliente

Motores

Avançado

Ajuda

🚧 = em desenvolvimento, pode mudar

Clone this wiki locally