Tair (Redis® OSS-Compatible):Uso de redis-cli para conectarse a una instancia

Requisitos previos

Antes de empezar, asegúrese de haber completado lo siguiente:

• Establecido la contraseña de la cuenta de la instancia. Use la contraseña predeterminada de la cuenta o create a standard account con su propia contraseña. Para cambiar o restablecer una contraseña, consulte Change or reset the password.

• Agregado la dirección IP de su dispositivo a la lista blanca de IP de la instancia. Consulte Set IP whitelists.

• Obtenido el endpoint de la instancia. Consulte View endpoints.

Qué endpoint y dirección IP utilizar:

De forma predeterminada, las instancias solo cuentan con un endpoint de VPC. Para conectarse a través de internet, primero debe apply for a public endpoint .

Instalación de redis-cli

redis-cli se instala como parte del paquete de Redis. La versión de redis-cli no necesita coincidir con la versión de su instancia.

Conexión a una instancia

1. Vaya al directorio donde está instalado redis-cli.

   Linux

   Vaya al directorio src dentro de la carpeta de código fuente de Redis. Por ejemplo, ejecute cd /home/redis-7.2.0/src.

   macOS

   Vaya al directorio bin de Homebrew. Por ejemplo, ejecute cd /opt/homebrew/bin.

   Windows

   Abra la ventana de línea de comandos y vaya al directorio donde se encuentra redis-cli.

2. Seleccione el comando de conexión adecuado

   Antes de ejecutar el comando, confirme dos aspectos:

   • La arquitectura de su instancia: estándar o clúster. Compruébelo en la página de detalles de la instancia en la consola.

   • El tipo de conexión: endpoint de VPC o endpoint público. Esto determina qué nombre de host utilizar.

   Seleccione el comando que corresponda a su configuración:

   Escenario	Comando
   Arquitectura estándar, o arquitectura de clúster mediante endpoint de proxy	./redis-cli -h <hostname> -p <port>
   Arquitectura de clúster mediante dirección de conexión directa	./redis-cli -h <hostname> -p <port> -c

   En Windows PowerShell, reemplace ./redis-cli por .\redis-cli .

   Parámetros:

   Parámetro	Descripción	Cómo obtenerlo
   <hostname>	Endpoint de la instancia	Obtenga el endpoint de VPC o el endpoint público desde la consola. Consulte View endpoints.
   <port>	Puerto de la instancia	El valor predeterminado es 6379. Para un puerto personalizado, consulte Change the endpoint or port.
   -c	Habilitar modo clúster	Obligatorio solo para instancias cluster architecture que utilizan direct connection address.

   Ejemplo:

   ./redis-cli -h r-bp1zxszhcgatnx****.redis.rds.aliyuncs.com -p 6379

3. Autenticación

   Ejecute el comando AUTH después de conectarse:

   AUTH <password>

   El formato de la contraseña depende del tipo de cuenta:

   Tipo de cuenta	Formato de contraseña	Ejemplo
   Cuenta predeterminada (llamada default o el ID de la instancia)	Solo contraseña	AUTH Rp829dlwa
   Cuenta estándar	user:password	AUTH testaccount:Rp829dlwa

   Si password-free access over a VPC está habilitado, omita la autenticación y ejecute los comandos directamente.

4. Verificación de la conexión

   Una respuesta OK del comando AUTH confirma que la conexión se estableció correctamente. Ejecute una prueba rápida para comprobar el acceso de lectura y escritura:

   set testkey "hello"    # Write a test value
   OK
   get testkey            # Read it back
   "hello"
   set tempkey "bye" EX 5 # Write with a 5-second expiration
   get tempkey
   "bye"
                          # Wait 5 seconds
   get tempkey
   (nil)                  # Key has expired

   Para consultar la lista de comandos compatibles, vea Command overview.

Solución de problemas

Si la versión secundaria de su instancia está desactualizada, los mensajes de error pueden diferir de los mostrados a continuación. Update the minor version para obtener los mensajes de error más recientes.

Al utilizar herramientas de terceros como RDM, introduzca la contraseña en formato user:password en el campo correspondiente.

Temas relacionados

• Command overview: explore los comandos de Redis compatibles.

• Create and manage accounts: gestione cuentas y permisos de la instancia.