Compartilhar via

Bibliotecas de cliente

  • Artigo

O Cache do Azure para Redis é baseado no popular armazenamento de dados na memória de código aberto, Redis de código aberto. O Cache do Azure para Redis pode ser acessado por uma ampla variedade de clientes Redis para muitas linguagens de programação. Cada biblioteca de clientes tem sua própria API, que faz chamadas para o servidor Redis usando os comandos os Redis, mas as bibliotecas de clientes são criadas para se comunicar com qualquer servidor Redis.

Cada cliente mantém sua própria documentação de referência para a biblioteca. Os clientes também fornecem links para obter suporte por meio da comunidade de desenvolvedores da biblioteca de clientes. A equipe do Cache do Azure para Redis não detém o desenvolvimento nem o suporte para bibliotecas de clientes.

Embora não detenhamos nem ofereçamos suporte a nenhuma biblioteca de clientes, recomendamos algumas bibliotecas. As recomendações são baseadas na popularidade e se há uma comunidade online ativa para dar suporte e responder às suas perguntas. Só recomendamos usar a versão mais recente disponível e atualizar regularmente, à medida que novas versões forem disponibilizadas. Essas bibliotecas estão em desenvolvimento ativo e geralmente lançam novas versões com melhorias de confiabilidade e desempenho.

Biblioteca de clientes Linguagem RepositórioGitHub Documentação
StackExchange.Redis C# / .NET Link Mais informações podem ser obtidas aqui
Lettuce Java Link Mais informações podem ser obtidas aqui
Jedis Java Link
node_redis Node.js Link
Redisson Java Link Mais informações podem ser obtidas aqui
ioredis Node.js Link Mais informações podem ser obtidas aqui

Observação

O aplicativo pode se conectar e usar a instância de Cache do Azure para Redis com qualquer biblioteca de clientes que também possa se comunicar com o Redis de software livre.

Diretrizes específicas para a biblioteca de clientes

Para obter informações sobre as melhores práticas de diretrizes específicas da biblioteca de clientes, confira os seguintes links:

Redisson (Java)

Recomendamos que você use o Redisson 3.14.1 ou superior. As versões mais antigas contêm problemas conhecidos de vazamento de conexão que causam problemas após failovers. Monitore o log de alterações do Redisson pois outros problemas conhecidos podem afetar os recursos usados pelo aplicativo. Para obter mais informações, consulte CHANGELOG e Perguntas frequentes sobre o Redisson.

Outras observações:

  • O Redisson usa como padrão a estratégia de "leitura da réplica", diferente de alguns outros clientes. Para alterar isso, modifique a configuração 'readMode'.
  • O Redisson tem uma estratégia de pool de conexões com configurações mínimas e máximas configuráveis e os valores mínimos padrão são grandes. Os padrões grandes podem contribuir para comportamentos agressivos de reconexão ou "tempestades de conexão". Para reduzir o risco, considere o uso de menos conexões porque você pode fazer pipeline com eficiência de comandos ou lotes de comandos em algumas conexões.
  • O Redisson tem um tempo limite de conexão ocioso padrão de 10 segundos, o que leva a mais fechamentos e reaberturas de conexões do que o ideal.

Aqui está uma configuração de linha de base recomendada para o modo de cluster que você 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 que demonstra como usar o suporte do Redisson para JCache como o repositório para o estado de sessão HTTP no IBM Liberty no Azure, consulte Usar o Java EE JCache com Open Liberty ou WebSphere Liberty em um cluster do AKS (Serviço de Kubernetes do Azure).

Como usar as bibliotecas de clientes

Além da documentação de referência, você pode encontrar tutoriais que mostram como começar a usar o Cache do Azure para Redis por meio de diferentes linguagens e clientes de cache.

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

Próximas etapas