Tair (Redis® OSS-Compatible):Utiliser redis-cli pour se connecter à une instance

Prérequis

Avant de commencer, assurez-vous d'avoir :

• Défini le mot de passe du compte de l'instance. Utilisez le mot de passe par défaut ou créez un compte standard avec son propre mot de passe. Pour modifier ou réinitialiser un mot de passe, consultez la rubrique Modifier ou réinitialiser le mot de passe.

• Ajouté l'adresse IP de votre appareil à la liste d'autorisation IP de l'instance. Consultez la rubrique Configurer les listes d'autorisation IP.

• Récupéré l'endpoint de l'instance. Consultez la rubrique Afficher les endpoints.

Quel endpoint et quelle adresse IP utiliser :

Par défaut, les instances ne disposent que d'un endpoint VPC. Pour vous connecter via Internet, demandez d'abord un endpoint public .

Installer redis-cli

redis-cli est installé avec le package Redis. La version de redis-cli n'a pas besoin de correspondre à celle de votre instance.

Se connecter à une instance

1. Accédez au répertoire où redis-cli est installé.

   Linux

   Accédez au répertoire src situé dans le dossier source Redis. Par exemple, exécutez cd /home/redis-7.2.0/src.

   macOS

   Accédez au répertoire bin de Homebrew. Par exemple, exécutez cd /opt/homebrew/bin.

   Windows

   Ouvrez la fenêtre de ligne de commande et accédez au répertoire où se trouve redis-cli.

2. Choisissez votre commande de connexion

   Avant d'exécuter la commande, vérifiez deux éléments :

   • L'architecture de votre instance — standard ou cluster. Vérifiez la page des détails de l'instance dans la console.

   • Votre type de connexion — endpoint VPC ou endpoint public. Cela détermine le nom d'hôte à utiliser.

   Sélectionnez la commande correspondant à votre configuration :

   Scénario	Commande
   Architecture standard, ou architecture cluster via un endpoint proxy	./redis-cli -h <hostname> -p <port>
   Architecture cluster via une adresse de connexion directe	./redis-cli -h <hostname> -p <port> -c

   Dans Windows PowerShell, remplacez ./redis-cli par .\redis-cli .

   Paramètres :

   Paramètre	Description	Comment l'obtenir
   <hostname>	Endpoint de l'instance	Récupérez l'endpoint VPC ou l'endpoint public depuis la console. Consultez la rubrique Afficher les endpoints.
   <port>	Port de l'instance	La valeur par défaut est 6379. Pour un port personnalisé, consultez la rubrique Modifier l'endpoint ou le port.
   -c	Activer le mode cluster	Requis uniquement pour les instances d'architecture cluster utilisant une adresse de connexion directe.

   Exemple :

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

3. Authentification

   Exécutez la commande AUTH après la connexion :

   AUTH <password>

   Le format du mot de passe dépend du type de compte :

   Type de compte	Format du mot de passe	Exemple
   Compte par défaut (nommé default ou l'ID de l'instance)	Mot de passe uniquement	AUTH Rp829dlwa
   Compte standard	user:password	AUTH testaccount:Rp829dlwa

   Si l'accès sans mot de passe via un VPC est activé, ignorez l'authentification et exécutez directement les commandes.

4. Vérifier la connexion

   Une réponse OK de la commande AUTH confirme que vous êtes connecté. Exécutez un test rapide pour vérifier l'accès en lecture et en écriture :

   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

   Pour obtenir la liste des commandes prises en charge, consultez la rubrique Présentation des commandes.

Dépannage

Si la version mineure de votre instance est obsolète, les messages d'erreur peuvent différer de ceux ci-dessous. Mettez à jour la version mineure pour obtenir les derniers messages d'erreur.

Lors de l'utilisation d'outils tiers tels que RDM, saisissez le mot de passe au format user:password dans le champ dédié au mot de passe.

Rubriques connexes

• Présentation des commandes — parcourir les commandes Redis prises en charge.

• Créer et gérer des comptes — gérer les comptes et les autorisations des instances.