Compartir a través de

Bibliotecas de cliente

  • Se aplica a: ✅ Azure Cache for Redis

Azure Cache for Redis se basa en el almacén de datos de código abierto de Redis en memoria. Los clientes de Redis para muchos lenguajes de programación pueden acceder a Azure Redis. La aplicación puede usar cualquier biblioteca cliente compatible con Redis de código abierto para conectarse a la caché de Azure Redis.

Cada biblioteca cliente tiene su propia API que llama a los servidores de Redis mediante comandos de Redis. Las bibliotecas cliente se compilan para comunicarse con cualquier servidor de Redis.

Los clientes mantienen la documentación de referencia para sus propias bibliotecas y proporcionan vínculos para obtener soporte técnico a través de la comunidad de desarrolladores de bibliotecas cliente. Microsoft y el equipo de Azure Redis no poseen el desarrollo ni la compatibilidad con ninguna biblioteca cliente.

Microsoft y Azure Redis recomiendan algunas bibliotecas, en función de la popularidad y si hay una comunidad de soporte técnico en línea activa para responder a preguntas. Estas bibliotecas están en desarrollo activo y a menudo lanzan nuevas versiones con mejoras de confiabilidad y rendimiento. Microsoft recomienda usar la versión disponible más reciente y actualizar periódicamente a medida que las nuevas versiones estén disponibles.

En la tabla siguiente se enumeran los vínculos y la documentación de algunas bibliotecas cliente recomendadas.

Biblioteca cliente Lenguaje del repositorio de GitHub de Documentación
StackExchange.Redis C#/.NET https://github.com/StackExchange/StackExchange.Redis StackExchange.Redis
Jedis Java https://github.com/redis/jedis
Lechuga Java https://github.com/lettuce-io/ Lettuce: cliente de Java Redis avanzado
Redisson Java https://github.com/redisson/redisson Redisson: cliente de Redis Java Real-Time Data Platform
ioredis Node.js. https://github.com/luin/ioredis Clases
node_redis Node.js. https://github.com/redis/node-redis

Nota:

La aplicación puede usar cualquier biblioteca cliente compatible con Redis de código abierto para conectarse a la instancia de Azure Redis.

Guía específica de bibliotecas cliente

Para obtener instrucciones y procedimientos recomendados específicos de la biblioteca cliente, consulte los vínculos siguientes:

Cómo usar bibliotecas cliente

Además de la documentación de referencia, puede usar los siguientes tutoriales para empezar a trabajar con Azure Redis mediante diferentes idiomas y clientes de caché:

Procedimientos recomendados para Redisson (Java)

Estos son algunos procedimientos recomendados para la biblioteca cliente de Redisson :

  • Use la versión Redisson 3.14.1 o posterior. Las versiones anteriores contienen problemas conocidos de pérdida de conexión que causan problemas después de las conmutaciones por error.

  • Supervise el registro de cambios de Redisson para ver si hay problemas conocidos que pueden afectar a las características que usa la aplicación. Para obtener más información, consulte el Historial de versiones de Redisson y el P+F de Redisson.

  • Modifique el ajuste de configuración readMode si no desea usar la estrategia de lectura desde la réplica. A diferencia de otros clientes, Redisson usa lectura desde la réplica como valor predeterminado.

  • Para reducir el riesgo de comportamientos agresivos de reconexión o tormentas de conexión, considere la posibilidad de establecer menos conexiones mínimas.

    Redisson cuenta con una estrategia de agrupación de conexiones con valores mínimos y máximos configurables, y los valores mínimos predeterminados son grandes. Los valores predeterminados grandes podrían contribuir a comportamientos de reconexión agresivos o tormentas de conexión. Para reducir este riesgo, considere la posibilidad de usar menos conexiones. Puede gestionar eficazmente comandos o lotes de comandos a través de algunas conexiones.

  • Restablezca el tiempo de espera de la conexión inactiva si es necesario. Redisson tiene un tiempo de espera de conexión de inactividad predeterminado de 10 segundos, lo que puede dar lugar a un mayor cierre y reabrimiento de conexiones que lo ideal.

  • Para obtener información sobre el uso de Redisson con JCache de Java EE para almacenar el estado de sesión HTTP en un clúster de Azure Kubernetes Service (AKS), consulte Uso de Azure Redis como caché de sesión para WebSphere Liberty o Open Liberty.

  • Use la siguiente configuración de línea base recomendada para el modo de clúster y modifíquela según sea necesario.

    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

Contenido relacionado