Partager via

Bibliothèques clientes

  • S’applique à: ✅ Azure Cache for Redis

Important

Azure Cache pour Redis a annoncé sa chronologie de mise hors service pour toutes les références SKU. Nous vous recommandons de déplacer vos instances Azure Cache pour Redis existantes vers Azure Managed Redis dès que vous le pouvez.

Pour plus d’informations sur la mise hors service :

Azure Cache pour Redis est basé sur le magasin de données open source Redis en mémoire. Les clients Redis pour de nombreux langages de programmation peuvent accéder à Azure Redis. Votre application peut utiliser n’importe quelle bibliothèque cliente compatible avec Redis open source pour vous connecter à votre cache Redis Azure.

Chaque bibliothèque cliente possède sa propre API qui appelle des serveurs Redis à l’aide de commandes Redis. Les bibliothèques clientes sont générées pour communiquer avec n’importe quel serveur Redis.

Les clients gèrent la documentation de référence pour leurs propres bibliothèques et fournissent des liens pour obtenir du support via la communauté des développeurs de bibliothèques clientes. Microsoft et l’équipe Redis Azure ne possèdent pas le développement ou la prise en charge des bibliothèques clientes.

Microsoft et Azure Redis recommandent certaines bibliothèques, en fonction de leur popularité et s’il existe une communauté de support en ligne active pour répondre aux questions. Ces bibliothèques sont en cours de développement actif et publient souvent de nouvelles versions avec des améliorations de fiabilité et de performances. Microsoft recommande d’utiliser la dernière version disponible et de mettre à niveau régulièrement à mesure que de nouvelles versions deviennent disponibles.

Le tableau suivant répertorie les liens et la documentation pour certaines bibliothèques clientes recommandées.

Bibliothèque cliente Langage Référentiel GitHub Documentation
StackExchange.Redis C#/.NET https://github.com/StackExchange/StackExchange.Redis StackExchange.Redis
Jedis Java https://github.com/redis/jedis
Laitue Java https://github.com/lettuce-io/ Lettuce - Client Java Redis avancé
Redisson Java https://github.com/redisson/redisson Redisson - Redis Java client Real-Time Data Platform
ioredis Node.js https://github.com/luin/ioredis Classes
node_redis Node.js https://github.com/redis/node-redis

Remarque

Votre application peut utiliser n’importe quelle bibliothèque cliente compatible avec Redis open source pour vous connecter à votre instance Azure Redis.

Conseils pour la bibliothèque cliente

Pour obtenir des conseils et des bonnes pratiques spécifiques à la bibliothèque cliente, consultez les liens suivants :

Utiliser des bibliothèques clientes

Outre la documentation de référence, vous pouvez utiliser les didacticiels suivants pour commencer à utiliser Azure Redis à l’aide de différents langages et clients de cache :

Meilleures pratiques pour Redisson (Java)

Voici quelques bonnes pratiques recommandées pour la bibliothèque cliente Redisson :

  • Utilisez Redisson 3.14.1 ou version ultérieure. Les versions antérieures contiennent des problèmes de fuite de connexion connus qui provoquent des problèmes après les basculements.

  • Surveillez le journal des modifications Redisson pour connaître les problèmes connus qui peuvent affecter les fonctionnalités que votre application utilise. Pour plus d’informations, consultez l’historique des versions de Redisson et la Foire aux questions sur Redisson.

  • Modifiez le readMode paramètre de configuration si vous ne souhaitez pas utiliser la stratégie de lecture à partir de la copie. Contrairement à d’autres clients, Redisson utilise la lecture à partir du réplica comme valeur par défaut.

  • Pour réduire le risque de comportements de reconnexion agressifs ou de tempêtes de connexion, envisagez de définir moins de connexions minimales.

    Redisson a une stratégie de regroupement de connexions avec des paramètres de minimum et maximum configurables, et les valeurs minimales par défaut sont grandes. Les grandes valeurs par défaut peuvent contribuer à des comportements de reconnexion agressifs ou à des tempêtes de connexion. Pour réduire ce risque, envisagez d’utiliser moins de connexions. Vous pouvez acheminer efficacement en flux des commandes ou des lots de commandes sur quelques connexions.

  • Réinitialisez le délai d’attente de la connexion si nécessaire. Redisson dispose d’un délai d’expiration de connexion inactif par défaut de 10 secondes, ce qui peut entraîner une fermeture et une réouverture des connexions plus qu’idéales.

  • Pour plus d’informations sur l’utilisation de Redisson avec Java EE JCache pour stocker l’état de session HTTP sur un cluster Azure Kubernetes Service (AKS), consultez Utilisation d’Azure Redis comme cache de session pour WebSphere Liberty ou Open Liberty.

  • Utilisez la configuration de base recommandée suivante pour le mode cluster et modifiez-la si nécessaire.

    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

Contenu connexe

  • Last updated on