Partilhar via

Bibliotecas de cliente

  • Artigo

O Cache Redis do Azure é baseado no popular armazenamento de dados na memória de código aberto, Redis de código aberto. Os clientes Redis para muitas linguagens de programação podem acessar o Azure Managed Redis. Cada biblioteca de cliente tem sua própria API que faz chamadas para o servidor Redis usando comandos Redis, mas as bibliotecas de cliente são criadas para falar com qualquer servidor Redis.

Cada cliente mantém sua própria documentação de referência para sua biblioteca. Os clientes também fornecem links para obter suporte através da comunidade de desenvolvedores da biblioteca do cliente. A equipe do Cache do Azure para Redis não é proprietária do desenvolvimento ou do suporte para nenhuma biblioteca cliente.

Embora não possuamos nem ofereçamos suporte a nenhuma biblioteca cliente, recomendamos algumas bibliotecas. As recomendações baseiam-se na popularidade e na existência ou não de uma comunidade online ativa para apoiar e responder às suas perguntas. Recomendamos apenas a utilização da versão mais recente disponível e a atualização periódica à medida que forem sendo disponibilizadas novas versões. Estas bibliotecas estão em desenvolvimento ativo e lançam frequentemente novas versões com melhorias da fiabilidade e do desempenho.

Biblioteca de cliente Idioma Repositório do GitHub Documentação
StackExchange.Redis C#/.NET Ligação Obtenha mais informações aqui
Lettuce Java Ligação Obtenha mais informações aqui
Jedis Java Ligação
nó_redis Node.js Ligação
Redisson Java Ligação Obtenha mais informações aqui
Ioredis Node.js Ligação Obtenha mais informações aqui

Nota

Seu aplicativo pode usar qualquer biblioteca de cliente compatível com o Redis de código aberto para se conectar à sua instância do Cache do Azure para Redis.

Documentação de orientação para bibliotecas de cliente específicas

Para obter informações sobre as melhores práticas de orientação específicas da biblioteca de cliente, consulte as ligações seguintes:

Redisson (Java)

Recomendamos que utilize o redisson 3.14.1 ou superior. As versões mais antigas contêm problemas conhecidos de fugas de ligação que causam problemas após ativações pós-falha. Monitorize o changelog do Redisson para ver se outros problemas conhecidos podem afetar as funcionalidades utilizadas pela sua aplicação. Para obter mais informações, consulteCHANGELOG e as FAQ do Redisson.

Outras notas:

  • A estratégia predefinida do Redisson é 'ler da réplica', ao contrário de alguns outros clientes. Para alterar esse padrão, modifique a configuração 'readMode'.
  • O Redisson tem uma estratégia de conjunto de ligações com definições mínimas e máximas configuráveis, e os valores mínimos predefinidos são grandes. Os grandes padrões podem contribuir para comportamentos agressivos de reconexão ou "tempestades de conexão". Para reduzir o risco, considere a possibilidade de utilizar menos ligações, uma vez que pode canalizar eficazmente comandos, ou lotes de comandos, através de poucas ligações.
  • Redisson tem um tempo de conexão ocioso padrão de 10 segundos, o que leva a mais fechamento e reabertura de conexões do que o ideal.

Segue-se uma configuração da linha de base recomendada para o modo de cluster que pode modificar conforme necessário:

clusterServersConfig:
  idleConnectionTimeout: 30000
  connectTimeout: 15000
  timeout: 5000
  retryAttempts: 3
  retryInterval: 3000
  checkLockSyncedSlaves: false
  failedSlaveReconnectionInterval: 15000
  failedSlaveCheckInterval: 60000
  subscriptionsPerConnection: 5
  clientName: "redisson"
  loadBalancer: !<org.redisson.connection.balancer.RoundRobinLoadBalancer> {}
  subscriptionConnectionMinimumIdleSize: 1
  subscriptionConnectionPoolSize: 50
  slaveConnectionMinimumIdleSize: 2
  slaveConnectionPoolSize: 24
  masterConnectionMinimumIdleSize: 2
  masterConnectionPoolSize: 24
  readMode: "MASTER"
  subscriptionMode: "MASTER"
  nodeAddresses:
  - "redis://mycacheaddress:6380"
  scanInterval: 1000
  pingConnectionInterval: 60000
  keepAlive: false
  tcpNoDelay: true

Para obter um artigo sobre o suporte do TRadisson para JCache como o armazenamento para o estado da sessão HTTP no IBM Liberty no Azure, consulte Usar Java EE JCache com Open Liberty ou WebSphere Liberty em um cluster do Serviço Kubernetes do Azure (AKS).

Como utilizar bibliotecas de cliente

Além da documentação de referência, você pode encontrar tutoriais mostrando como começar a usar o Cache Redis do Azure usando diferentes idiomas e clientes de cache.

Para obter mais informações sobre como usar algumas dessas bibliotecas de cliente em tutoriais, consulte os seguintes artigos:

Próximos passos