Repository navigation
redis
Home > 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.
- Solte um
TRALRedisClient(paleta RAL - Plugins) e preenchaHost,Porte, se o servidor pede,Password(eUserNamepara um usuário de ACL). - Solte um
TRALRedisStoree aponteClientpara ele. - 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.
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...) levantaERALRedisReplyError, com o texto do servidor emServerError; falha de rede, senha recusada ou tempo esgotado levantamERALRedisError. - O cliente pode ser usado por várias threads ao mesmo tempo: cada comando pega uma
conexão do pool (
PoolSizeconexõ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.
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.
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.
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; // TRALRateLimitPluginO 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.
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é.
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.
| 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 |
- Log, erros, limites, saúde 🚧 (os stores)
- Sessões 🚧
- Hubs 🚧
Começar
Servidor
- Rotas e parâmetros
- Rotas avançadas: tipos, grupos, versões 🚧
- Ler o pedido e responder
- Objetos no corpo 🚧
- Resposta em fluxo 🚧
- Plugins 🚧
- Serviços (contêiner de dependências) 🚧
- Barramento de eventos 🚧
- Tarefas em segundo plano 🚧
- Recursos com estado 🚧
- Redis e Valkey 🚧
- Autenticação
- Banco de dados (DBWare)
- Servir site e arquivos
- JSON-RPC 2.0 🚧
- GraphQL 🚧
- Servidor MCP (IA) 🚧
-
Protocol Buffers 🚧
- gRPC 🚧
- WebSocket 🚧
- Hubs (WebSocket) 🚧
- SignalR 🚧
- Swagger e Postman
- Servidor SOAP 🚧
- WS-Security 🚧
- HTTPS
- Criptografia ponto a ponto
- Segurança para produção
- Colocar no ar
- Desempenho
- Testes em memória 🚧
MQTT 🚧
- O que é e quando usar 🚧
- Cliente MQTT 🚧
- Broker MQTT 🚧
- MQTT-SN 🚧
- Ponte REST 🚧
- Segurança 🚧
- Rede ruim 🚧
E-mail 🚧
- Mensagens 🚧
- Enviar 🚧
- Enviar por REST e ação 🚧
- Receber 🚧
- Ler a caixa postal 🚧
- Verificar o que chega 🚧
- Servir caixas postais 🚧
- S/MIME 🚧
- OpenPGP 🚧
Chatbot 🚧
- O robô e os canais 🚧
- Telegram 🚧
- WhatsApp oficial, Messenger e Instagram 🚧
- Gateways REST (WhatsApp não oficial) 🚧
- Discord 🚧
- Slack 🚧
- Microsoft Teams 🚧
- Conversa em etapas 🚧
Cliente
Motores
- Qual motor escolher?
- Compatibilidade
- Recursos
- QUIC
- Motor NgHttp2 (HTTP/2) 🚧
- Motor XSocket 🚧
- Motor AdvancedHTTP (experimental) 🚧
Avançado
Ajuda
- Problemas comuns
- Atualizar o Indy
- Várias versões do Delphi
- Vídeos e guias
- Módulos de terceiros
- Licenças
- Contribuir
- Roadmap e changelog
🚧 = em desenvolvimento, pode mudar