Partilhar via


Bibliotecas de cliente

Importante

O Cache do Azure para Redis anunciou seu cronograma de desativação para todas as SKUs. Recomendamos mover as suas instâncias existentes do Azure Cache para Redis para Azure Managed Redis o mais rápido possível.

Para mais detalhes sobre a aposentadoria:

O Cache do Azure para Redis é baseado no armazenamento de dados na memória de código aberto Redis. Os clientes Redis para muitas linguagens de programação podem acessar o Azure Redis. Seu aplicativo pode usar qualquer biblioteca de cliente compatível com o Redis de código aberto para se conectar ao cache Redis do Azure.

Cada biblioteca de cliente tem sua própria API que chama servidores Redis usando comandos Redis. As bibliotecas de cliente são construídas para se comunicar com qualquer servidor Redis.

Os clientes mantêm a documentação de referência para suas próprias bibliotecas e fornecem links para obter suporte por meio da comunidade de desenvolvedores de bibliotecas de clientes. A Microsoft e a equipe Redis do Azure não possuem o desenvolvimento ou o suporte para nenhuma biblioteca cliente.

A Microsoft e o Azure Redis recomendam algumas bibliotecas, com base na popularidade e na existência ou não de uma comunidade de suporte online ativa para responder a perguntas. Essas bibliotecas estão em desenvolvimento ativo e frequentemente lançam novas versões com melhorias de confiabilidade e desempenho. A Microsoft recomenda usar a versão mais recente disponível e atualizar regularmente à medida que novas versões são disponibilizadas.

A tabela a seguir lista links e documentação para algumas bibliotecas de cliente recomendadas.

Biblioteca de cliente Idioma Repositório GitHub Documentação
StackExchange.Redis C#/.NET https://github.com/StackExchange/StackExchange.Redis StackExchange.Redis
Jedis Java https://github.com/redis/jedis
Alface Java https://github.com/lettuce-io/ Lettuce - Cliente Java Redis Avançado
Redisson Java https://github.com/redisson/redisson Redisson - Cliente Redis Java Real-Time Data Platform
Ioredis Node.js https://github.com/luin/ioredis Aulas
node_redis Node.js https://github.com/redis/node-redis

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 Azure Redis.

Orientações para bibliotecas de clientes específicas

Para obter orientações e práticas recomendadas específicas da biblioteca de clientes, consulte os seguintes links:

Como utilizar bibliotecas de cliente

Além da documentação de referência, você pode usar os seguintes tutoriais para começar a usar o Azure Redis usando diferentes idiomas e clientes de cache:

Práticas recomendadas para Redisson (Java)

Aqui estão algumas práticas recomendadas para a biblioteca de cliente Redisson :

  • Utilize Redisson 3.14.1 ou superior. As versões mais antigas contêm problemas conhecidos de fugas de conexão que causam problemas após falhas de recuperação.

  • Monitore o changelog do Redisson em busca de problemas conhecidos que possam afetar os recursos usados pelo seu aplicativo. Para obter mais informações, consulte o Histórico de lançamentos do Redisson e as Perguntas frequentes do Redisson.

  • Modifique a readMode configuração de configuração se não quiser usar a estratégia de réplica de leitura . Ao contrário de alguns outros clientes, o Redisson usa a réplica lida como padrão.

  • Para reduzir o risco de comportamentos agressivos de reconexão ou tempestades de conexão, considere definir menos conexões mínimas.

    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 incumprimentos podem contribuir para comportamentos agressivos de reconexão ou tempestades de ligações. Para reduzir esse risco, considere usar menos conexões. Você pode canalizar comandos ou lotes de comandos de forma eficiente em algumas conexões.

  • Redefina o tempo limite de conexão ociosa, se necessário. Redisson tem um tempo limite de conexão ocioso padrão de 10 segundos, o que pode levar a mais fechamento e reabertura de conexões do que o ideal.

  • Para obter informações sobre como usar o Redisson com Java EE JCache para armazenar o estado da sessão HTTP em um cluster do Serviço Kubernetes do Azure (AKS), consulte Usando o Azure Redis como cache de sessão para WebSphere Liberty ou Open Liberty.

  • Use a seguinte configuração de linha de base recomendada para o modo de cluster e modifique-a 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