Bibliotecas de cliente

  • Artículo

Azure Cache for Redis se basa en Redis, el conocido almacén de datos en memoria de código abierto. Se puede acceder mediante una amplia variedad de clientes de Redis para muchos lenguajes de programación. Cada biblioteca cliente tiene su propia API que realiza llamadas al servidor de Redis mediante comandos de Redis, pero las bibliotecas cliente se compilan para comunicarse con cualquier servidor de Redis.

Cada cliente mantiene su propia documentación de referencia para su biblioteca. Los clientes también proporcionan vínculos para obtener soporte técnico a través de la comunidad de desarrolladores de la biblioteca cliente. El equipo de Azure Cache for Redis no posee el desarrollo ni la compatibilidad con ninguna biblioteca cliente.

Aunque no poseemos ni se admiten bibliotecas cliente, se recomiendan algunas bibliotecas. Las recomendaciones se basan en la popularidad y si hay una comunidad en línea activa para apoyar y responder a sus preguntas. Solo se recomienda usar la versión disponible más reciente y actualizar periódicamente a medida que estén disponibles nuevas versiones. Estas bibliotecas están en desarrollo activo y, a menudo, publican nuevas versiones con mejoras en la confiabilidad y el rendimiento.

Biblioteca cliente Idioma RepositorioGitHub Documentación
StackExchange.Redis C#/.NET Vínculo Más información aquí
Lettuce Java Vínculo Más información aquí
Jedis Java Vínculo
node_redis Node.js Vínculo
Redisson Java Vínculo Más información aquí
ioredis Node.js Vínculo Más información aquí

Nota

La aplicación puede conectarse y usar la instancia de Azure Cache for Redis con cualquier biblioteca cliente que también pueda comunicarse con Redis de código abierto.

Guía específica de bibliotecas cliente

Para obtener información sobre los procedimientos recomendados específicos de la biblioteca cliente, consulte los vínculos siguientes:

Redisson (Java)

Se recomienda usar Redisson 3.14.1 o una versión superior. 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 otros problemas conocidos que pueden afectar a las características usadas por la aplicación. Para más información, consulte CHANGELOG y las preguntas más frecuentes de Redisson.

Otras notas:

  • Redisson adopta de forma predeterminada la estrategia de "lectura de réplica", a diferencia de otros clientes. Para cambiar esto, modifique el valor de configuración "readMode".
  • 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 el riesgo, considere la posibilidad de usar menos conexiones, dado que puede canalizar eficazmente comandos o lotes de comandos por unas pocas conexiones.
  • Redisson tiene un tiempo de espera de conexión de inactividad predeterminado de 10 segundos, lo que lleva a que se cierren y abran conexiones con una mayor frecuencia de lo que sería recomendable.

Esta es una configuración de línea de base recomendada para el modo de clúster que puede modificar 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

Para ver un artículo en el que se muestra cómo usar la compatibilidad de Redisson con JCache como almacén para el estado de sesión HTTP en Azure, consulte Uso de Java EE JCache con Open Liberty o WebSphere Liberty en un clúster de Azure Kubernetes Service (AKS).

Cómo usar bibliotecas cliente

Además de la documentación de referencia, hay varios tutoriales que muestran cómo empezar a trabajar con Azure Cache for Redis con distintos lenguajes y clientes de caché.

Para obtener más información sobre el uso de algunas de estas bibliotecas cliente en tutoriales, consulte los siguientes artículos:

Pasos siguientes