Redis : utilisation en console

redis-cli est le client en ligne de commande de Redis.

Se connecter

redis-cli                                   # 127.0.0.1:6379
redis-cli -h serveur.exemple.com -p 6379
redis-cli -n 2                              # base numéro 2 (0 à 15)
redis-cli --user app --askpass              # compte ACL, mot de passe demandé
redis-cli -u redis://app@serveur.exemple.com:6379/0

Éviter -a MOT_DE_PASSE : le mot de passe apparaît dans la liste des processus et l’historique. Préférer --askpass ou la variable REDISCLI_AUTH.

Commandes de base

127.0.0.1:6379> PING
PONG
127.0.0.1:6379> SET site "exemple"
OK
127.0.0.1:6379> GET site
"exemple"
127.0.0.1:6379> EXISTS site
(integer) 1
127.0.0.1:6379> DEL site
(integer) 1
127.0.0.1:6379> SELECT 1
OK

Commande	Rôle
SET clé valeur / GET clé	Écrire / lire
SET clé valeur NX	Écrire seulement si la clé n’existe pas
MSET, MGET	Plusieurs clés
INCR, INCRBY, DECR	Compteurs atomiques
EXISTS, DEL, UNLINK	Tester, supprimer (UNLINK libère la mémoire en arrière-plan)
TYPE clé	Type de la valeur
RENAME ancien nouveau	Renommer
DBSIZE	Nombre de clés de la base courante

Parcourir les clés

127.0.0.1:6379> SCAN 0 MATCH session:* COUNT 100
127.0.0.1:6379> KEYS session:*

Attention

KEYS parcourt toute la base et bloque le serveur : à éviter en production. Utiliser SCAN (itératif : relancer avec le curseur renvoyé jusqu’à 0), ou en ligne de commande redis-cli --scan --pattern 'session:*'.

Inspecter le serveur

redis-cli INFO                       # toutes les sections
redis-cli INFO memory
redis-cli INFO stats
redis-cli INFO keyspace              # nombre de clés par base
redis-cli CLIENT LIST                # connexions en cours
redis-cli CONFIG GET maxmemory
redis-cli SLOWLOG GET 10             # 10 commandes lentes récentes
redis-cli --latency                  # latence en continu (Ctrl+C pour arrêter)

Surveiller en direct

redis-cli MONITOR                    # affiche toutes les commandes reçues
redis-cli --bigkeys                  # repère les plus grosses clés par type
redis-cli --memkeys                  # consommation mémoire des clés

MONITOR ralentit le serveur et affiche des données : réserver à un diagnostic bref.

Mode non interactif

redis-cli GET site
redis-cli SET compteur 10
redis-cli --raw GET site                         # sans guillemets ni types
echo "GET site" | redis-cli
redis-cli -n 1 --scan --pattern 'cache:*' | xargs -r -n 100 redis-cli -n 1 UNLINK

La dernière commande supprime par lots toutes les clés d’un motif.

Vider les données

redis-cli FLUSHDB ASYNC              # base courante
redis-cli FLUSHALL ASYNC             # toutes les bases

Attention

FLUSHALL supprime toutes les données, sans confirmation. Vérifier l’instance visée (-h, -n) avant de l’exécuter.

Transactions et scripts

127.0.0.1:6379> MULTI
127.0.0.1:6379(TX)> INCR a
127.0.0.1:6379(TX)> INCR b
127.0.0.1:6379(TX)> EXEC

MULTI / EXEC exécute un groupe de commandes sans interruption par d’autres clients (sans retour arrière en cas d’erreur d’une commande).

Dépannage

Symptôme	Piste
NOAUTH Authentication required	Authentification nécessaire : AUTH ou --askpass
WRONGPASS	Mot de passe ou compte incorrect
(error) NOPERM	Le compte ACL n’a pas le droit à cette commande ou cette clé
READONLY You can't write against a read only replica	Connexion à une réplique
La console se bloque après KEYS *	Base volumineuse : utiliser SCAN

Ubuntu 24.04 et 26.04 : différences à connaître

Les commandes de ce guide sont les mêmes avec Redis 7.0 et 8.0.

Pour aller plus loin

• Manuel : man redis-cli, commandes
• Suite : Types de données

Dans la même rubrique

• Installation
• Utilisation en console
• Types de données
• Expiration et mémoire
• Persistance et sauvegarde
• Sécurité et accès distant
• Dépannage