Uso de herramientas de cliente para administrar datos en Azure Managed Redis

Puede usar las siguientes herramientas para acceder a los datos y administrarlos en Azure Managed Redis como cliente. Use estas herramientas para interactuar directamente con la instancia de Redis administrada de Azure y para depurar y solucionar problemas.

• Insight de Redis
• herramienta de línea de comandos redis-cli

Insight de Redis

Redis Insight es una herramienta gráfica de código abierto enriquecida y de la CLI para emitir comandos de Redis y ver el contenido de una instancia de Redis. Funciona con Azure Managed Redis y se admite en Linux, Windows y macOS.

Instalación de Redis Insight

Para instalar Redis Insight, siga las instrucciones de la documentación de Redis Insight.

Configuración del acceso a Azure Managed Redis con Redis Insight

Redis Insight puede autenticarse en una instancia de Redis gestionada de Azure mediante Microsoft Entra ID o autenticación de clave de acceso. Se recomienda usar Microsoft Entra ID para mejorar la seguridad.

A partir de la versión 3.2.0, Redis Insight puede autenticarse para Azure Managed Redis con Microsoft Entra ID mediante el flujo de OAuth 2.0 de PKCE, lo que permite la detección automática de bases de datos entre suscripciones y autenticación sin contraseña.

Para obtener instrucciones para configurar el acceso a Azure Managed Redis con Redis Insight, consulte el repositorio de GitHub GitHub de Redis Insight. Se trata de una configuración única por inquilino de Azure.

Conexión a Azure Managed Redis con Redis Insight

Después de configurar Microsoft Entra ID acceso, conéctese a una instancia de Redis administrada de Azure en Redis Insight siguiendo estos pasos:

1. En Redis Insight, en la pestaña Bases de datos de Redis , seleccione + Conectar base de datos existente.
2. En la ventana Agregar base de datos seleccione Azure Managed Redis.
3. Siga las indicaciones para conectarse mediante la autenticación de Microsoft Entra ID.
4. En la página Subscription, seleccione la suscripción que contiene la instancia de Redis administrada de Azure y seleccione Agregar base de datos.
5. Seleccione la instancia de Redis administrada (base de datos) de Azure a la que desea conectarse y, a continuación, seleccione Agregar base de datos. Puede seleccionar varias bases de datos para conectarse al mismo tiempo.
6. Repita los pasos anteriores para agregar instancias de Redis administradas de Azure según sea necesario, ya sea en la misma suscripción de Azure o en otra diferente.

• Después de agregar una instancia de Redis administrada de Azure, puede seleccionarla en la lista de bases de datos de Redis en Redis Insight y empezar a emitir comandos y ver datos.

• Para acceder a la CLI integrada, seleccione (>_ CLI) en la parte inferior de la pantalla de la base de datos seleccionada.

herramienta de línea de comandos redis-cli

Use la herramienta de línea de comandos redis-cli para interactuar con una instancia de Redis administrada de Azure como cliente. Use redis_cli como una manera ligera de emitir comandos y para realizar pruebas repetibles en scripts.

Instalación de redis-cli

La herramienta redis-cli se instala automáticamente con el paquete de Redis, que está disponible para varios sistemas operativos. Consulte la guía open source install Redis para obtener la documentación más detallada sobre su sistema operativo preferido.

Linux

redis-cli se ejecuta de forma nativa en Linux y la mayoría de las distribuciones incluyen un paquete de Redis que contiene la herramienta redis-cli. En Ubuntu, por ejemplo, instale el paquete de Redis con los siguientes comandos:

sudo apt-get update
sudo apt-get install redis

Windows

La mejor manera de usar redis-cli en un equipo de Windows es instalar el Windows Subsystem for Linux (WSL). El subsistema de Linux permite ejecutar herramientas de Linux directamente en Windows. Para instalar WSL, siga las instrucciones de instalación de WSL.

Una vez instalado WSL, puede instalar redis-cli mediante la administración de paquetes que esté disponible en la distribución de Linux que eligió para WSL.

Recopilar información de acceso a la caché

Puede recopilar la información necesaria para acceder a la memoria caché mediante estos métodos:

• Azure CLI utilizando az redisenterprise database list-keys
• Azure PowerShell con Get-AzRedisEnterpriseCacheKey
• Uso del portal de Azure

En esta sección, recuperará la información del portal de Azure.

Para conectar el servidor de Redis administrado de Azure, el cliente de caché necesita el punto de conexión de caché, el puerto y una clave para la memoria caché. Es posible que algunos clientes utilicen nombres ligeramente diferentes para estos elementos. Puede obtener esta información en el portal Azure.

• Para obtener el punto de conexión y el puerto de la memoria caché, seleccione Información general en el menú Recurso . El punto de conexión tiene el formato {yourcachename}.{region}.redis.azure.net. El puerto es 10000 para todas las instancias de Redis administradas de Azure.

• Para obtener las claves de acceso, seleccione Autenticación en el menú Configuración . A continuación, seleccione la pestaña Claves de acceso . Aquí puede encontrar las claves principales y secundarias de la memoria caché. Puede usar cualquiera de las claves para conectarse a la herramienta de cliente.

Conexión mediante redis-cli

Abra un shell o terminal en un equipo con el paquete de Redis instalado. Si usa WSL, puede usar el Windows Terminal para abrir una línea de comandos de Linux. Antes de conectarse con redis-cli, compruebe lo siguiente:

1. Si se necesita acceso TLS: de forma predeterminada, Azure instancias de Redis administradas usan TLS cifrado para las conexiones. Cada vez que se usa TLS en el servidor, se debe habilitar TLS en redis-cli mediante la opción --tls.
2. Puerto usado: todas las instancias de Redis administradas de Azure usan el puerto 10000. Tenga en cuenta que esto es diferente del valor predeterminado de la edición de la comunidad de Redis, que es 6379.
3. Si la instancia de caché usa la directiva de clúster de OSS: si usa la directiva de clúster del sistema operativo, agregue la opción -c para asegurarse de que se puede acceder a todas las particiones.

Ejemplos

1. Conéctese a una instancia de Redis administrada de Azure mediante la directiva de clúster de Enterprise con TLS:

   redis-cli -p 10000 -h {yourcachename}.{region}.redis.azure.net -a YourAccessKey --tls
   

2. Conéctese a una instancia de Redis administrada de Azure mediante la directiva de clúster de OSS y TLS:

   redis-cli -p 10000 -h {yourcachename}.{region}.redis.azure.net -a YourAccessKey --tls -c
   

Prueba de la conexión

Una vez establecida la conexión, puede emitir comandos a la instancia de Redis administrada de Azure. Una manera sencilla de probar la conexión es usar el comando PING. Este comando devuelve PONG en la consola.

yourcachename.region.redis.azure.net:10000> PING
PONG

También puede ejecutar comandos como SET y GET:

yourcachename.region.redis.azure.net:10000> SET hello world
OK
yourcachename.region.redis.azure.net:10000> GET hello
"world"

Ahora está conectado a la instancia de Redis administrada de Azure mediante el redis-cli.

Contenido relacionado

Para empezar, cree una nueva instancia de Redis administrada de Azure.