Compartir vía


Bibliotecas cliente de Redis administradas de Azure

Este artículo le ayuda a elegir y usar las mejores bibliotecas cliente para Azure Managed Redis. Aprenderá qué bibliotecas usar para el lenguaje de programación, cómo controlar las directivas de agrupación en clústeres y evitar problemas comunes de conexión.

Azure Managed Redis se basa en el popular almacén de datos en memoria, Redis. Los clientes de Redis para muchos lenguajes de programación pueden acceder a Azure Managed Redis. 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 biblioteca cliente mantiene su propia documentación de referencia. Las bibliotecas 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 Managed Redis no posee el desarrollo ni la compatibilidad con ninguna biblioteca cliente.

Las siguientes recomendaciones se basan en la popularidad y en si hay alguna comunidad en línea activa que le de soporte técnico y responda 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 de cliente Idioma Repositorio de GitHub Documentación
StackExchange.Redis C#/.NET StackExchange.Redis GitHub Documentación de StackExchange.Redis
Lechuga Java Lettuce GitHub Documentación de Lettuce
Jedis Java Jedis GitHub Documentación de Jedis
node_redis Node.js. node_redis GitHub documentación de node_redis
ioredis Node.js. ioredis GitHub Referencia de api de ioredis

Nota:

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

Elección de la biblioteca cliente adecuada en función de la directiva de agrupación en clústeres

Azure Managed Redis admite la directiva de agrupación en clústeres enterprise y la directiva de agrupación en clústeres de OSS. Consulte más información aquí (agregue un vínculo a la información de directiva de agrupación en clústeres).

Todas las bibliotecas cliente funcionan con la instancia de Redis con la directiva de agrupación en clústeres enterprise. Sin embargo, si usa la directiva de agrupación en clústeres del sistema operativo, asegúrese de que la biblioteca cliente seleccionada admite la conexión a instancias de Redis en clúster.

Comandos bloqueados

Microsoft administra la configuración y la administración de instancias de Azure Managed Redis, lo que deshabilita los siguientes comandos de manera predeterminada. Para obtener más información sobre los comandos bloqueados, consulte Compatibilidad de comandos de administración de clústeres

Comandos de varias claves

Dado que las instancias AMR usan una configuración en clúster, es posible que vea excepciones CROSSSLOT en comandos que funcionan en varias claves. El comportamiento varía en función de la directiva de agrupación en clústeres utilizada. Si usa la directiva de agrupación en clústeres de OSS, los comandos de varias claves requieren que todas las claves se asignen a la misma ranura hash.

También puede ver errores CROSSSLOT con la directiva de agrupación en clústeres Enterprise. Solo se permiten los siguientes comandos de varias claves entre ranuras con clústeres Enterprise: DEL, MSET, MGET, EXISTS, UNLINK y TOUCH.

En bases de datos Activa-activa, los comandos de escritura de varias claves (DEL, MSET y UNLINK) solo se podrán ejecutar en las claves que estén en la misma ranura. Sin embargo, se permiten los siguientes comandos de varias claves entre ranuras de bases de datos Activa-Activa: MGET, EXISTS y TOUCH. Para obtener más información, consulte Agrupación en clústeres de base de datos.

Comandos bloqueados para la directiva de agrupación en clústeres enterprise

  • INFORMACIÓN DEL CLÚSTER
  • CLUSTER HELP
  • RANURA CLAVE DEL CLUSTER
  • NODOS DE CLÚSTER
  • RANURAS DE CLÚSTER

Comandos bloqueados para la replicación geográfica activa

  • FLUSHALL
  • FLUSHDB

Guía específica de bibliotecas cliente

Elija el lenguaje de programación para obtener procedimientos recomendados detallados e instrucciones de conexión:

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 Managed 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