Nota
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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:
- Procedimientos recomendados de StackExchange.Redis (.NET)
- Prácticas recomendadas de Lettuce (Java)
- Procedimientos recomendados de Jedis (Java)
- procedimientos recomendados deNode.js
- Procedimientos recomendados de PHP
- Procedimientos recomendados de HiRedisCluster
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:
- Codificación de una aplicación de .NET Framework
- Programación de una aplicación de .NET Core
- Codificación de una aplicación web de ASP.NET
- Codificación de una aplicación web de ASP.NET Core
- Codificación de una aplicación Java
- Codificación de una aplicación Node.js
- Codificación de una aplicación Python