Tous les produits
Search

Ce produit

    Tair (Redis® OSS-Compatible):Liste des paramètres configurables pour Redis Open-Source Edition

    Centre de documentation

    Tair (Redis® OSS-Compatible):Liste des paramètres configurables pour Redis Open-Source Edition

    Dernière mise à jour :Aug 08, 2026

    Ajustez les paramètres de votre instance Tair (compatible avec OSS Redis) pour optimiser ses performances et sa sécurité. Les paramètres pris en charge varient selon la version du moteur et l'architecture.

    Important

    Cette rubrique concerne uniquement les paramètres des instances Redis Open-Source Edition. Pour les instances Tair Enterprise Edition, y compris les instances à mémoire optimisée, à mémoire persistante optimisée et basées sur disque, consultez la rubrique Liste des paramètres de configuration pour Tair Enterprise Edition.

    Remarques d'utilisation

    • Vous ne pouvez configurer que les paramètres répertoriés dans cette rubrique. Il est impossible de modifier les autres paramètres.

    • La modification de certains paramètres entraîne un redémarrage automatique de l'instance, provoquant une brève interruption de connexion de quelques secondes. La colonne Restart and Take Effect de la page de modification des paramètres indique si un redémarrage est requis. Pour plus d'informations, consultez la rubrique Définir les paramètres.

    • Si vous recevez l'erreur Parameter is not supported for current version lors de la configuration d'un paramètre, mettez à niveau la version mineure de votre instance.

    • Si vous recevez l'erreur ParamNotAllowedModify lors de la configuration d'un paramètre, cela signifie que le paramètre n'est pas pris en charge par l'architecture de l'instance actuelle. Vérifiez la colonne Architecture correspondant au paramètre dans les tableaux de cette rubrique pour confirmer que votre architecture d'instance le prend en charge. Par exemple, #no_loose_check-whitelist-always est pris en charge uniquement dans l'architecture classique 4.0/5.0, #no_loose_sentinel-enabled est pris en charge dans les architectures standard et cluster, et #no_loose_tls-min-version est pris en charge uniquement dans les architectures cluster et lecture/écriture fractionnée. Utilisez un paramètre compatible avec l'architecture actuelle ou configurez-le sur une instance dont l'architecture le prend en charge.

    Comment lire la matrice de prise en charge

    Chaque tableau de paramètres comprend des colonnes pour la version majeure et l'architecture. Les annotations suivantes s'appliquent :

    • ✔️ — le paramètre est pris en charge dans la version ou l'architecture spécifiée.

    • ❌ — le paramètre n'est pas pris en charge dans la version ou l'architecture spécifiée.

    Pour plus de détails sur les architectures, consultez les rubriques Architecture standard, Architecture cluster et Architecture lecture/écriture fractionnée.

    Paramètres du noyau de base de données

    Contrôle d'accès

    ParamètreDescriptionVersion 7.0Version 6.0Version 5.0Version 4.0Version 2.8
    #no_loose_check-whitelist-alwaysContrôle si les adresses IP des clients sont vérifiées par rapport à la liste d'autorisation de l'instance lorsque l'accès sans mot de passe via un VPC est activé. Valeur par défaut : no. Valeurs valides : yes — la vérification de la liste d'autorisation IP est appliquée même après l'activation de l'accès sans mot de passe. Les clients ne figurant pas sur la liste d'autorisation reçoivent l'erreur (error) ERR illegal address. no — la vérification de la liste d'autorisation IP est ignorée ; tout client situé dans le même VPC peut se connecter sans figurer sur la liste d'autorisation.
    Remarque

    Ce paramètre s'applique uniquement aux instances d'architecture classique. Les instances d'architecture cloud-native appliquent toujours la liste d'autorisation IP, indépendamment de ce paramètre.

    		❌❌Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️❌
    #no_loose_disabled-commandsDésactive les commandes à haut risque ou coûteuses. Valeur par défaut : vide (aucune commande désactivée). Spécifiez les noms des commandes en minuscules, séparés par des virgules. Exemples : flushall,flushdb,keys,hgetall,eval,evalsha,script.
    Remarque

    La désactivation de flushall n'affecte pas la fonctionnalité Purge Data de la console Tair. Certaines commandes, telles que CONFIG, ne peuvent pas être désactivées par les utilisateurs. Consultez la rubrique Commandes qui ne peuvent pas être désactivées.

    		Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️
    #no_loose_tls-min-versionDéfinit la version minimale de TLS acceptée par l'instance. Valeur par défaut : TLSv1. Valeurs valides : TLSv1, TLSv1.1, TLSv1.2.Standard ❌ Cluster ✔️ Lecture/écriture fractionnée ✔️Standard ❌ Cluster ✔️ Lecture/écriture fractionnée ✔️Standard ❌ Cluster ✔️ Lecture/écriture fractionnée ✔️Standard ❌ Cluster ✔️ Lecture/écriture fractionnée ✔️Standard ❌ Cluster ✔️ Lecture/écriture fractionnée ✔️

    Mode Sentinel

    ParamètreDescriptionVersion 7.0Version 6.0Version 5.0Version 4.0Version 2.8
    #no_loose_sentinel-enabledActive le mode compatible Sentinel pour les instances Standard ou Cluster en mode de connexion directe. Valeur par défaut : no. Valeurs valides : yes, no.Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ❌Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ❌Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ❌Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ❌❌
    #no_loose_sentinel-password-free-accessLorsque le mode Sentinel est activé, permet l'exécution des commandes liées à Sentinel sans mot de passe. Valeur par défaut : no. Valeurs valides : yes — les commandes Sentinel peuvent être exécutées sans mot de passe sur n'importe quelle connexion ; la commande SENTINEL peut s'abonner au canal +switch-master. no — un mot de passe est requis.Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️❌❌❌
    #no_loose_sentinel-password-free-commandsLorsque le mode Sentinel et le paramètre #no_loose_sentinel-password-free-access sont tous deux activés, spécifie les commandes supplémentaires pouvant s'exécuter sans mot de passe. Valeur par défaut : vide. Spécifiez les noms des commandes en minuscules, séparés par des virgules.
    Important

    Les commandes listées ici sont exécutables sans authentification sur n'importe quelle connexion. Configurez ce paramètre avec prudence.

    		Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️❌❌❌

    Persistance

    Paramètre Description Version 7.0 Version 6.0 Version 5.0 Version 4.0 Version 2.8
    appendonly Active ou désactive la persistance AOF (Append Only File) sur le nœud principal. Valeur par défaut :yes. Valeurs valides : yes — la persistance AOF est activée. no — la persistance AOF est désactivée ; la persistance RDB (Redis Database) s'exécute une fois par jour par défaut. Consultez la rubrique Sauvegarde automatique ou manuelle. Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️ Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️ Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️ Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️ Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️
    appendfsync Fréquence de fsync pour la persistance AOF. Valeur par défaut :everysec (non modifiable). Prend effet uniquement lorsque appendonly est défini sur yes. Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️ Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️ Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️ Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️ Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️

    Gestion de la mémoire et éviction

    ParamètreDescriptionVersion 7.0Version 6.0Version 5.0Version 4.0Version 2.8
    maxmemory-policyPolitique d'éviction des données. Lorsque l'instance atteint sa limite de mémoire (maxmemory), cette politique détermine quelles clés supprimer.
    Remarque

    maxmemory correspond à la taille de la spécification de l'instance (par exemple, une instance de 2 Go possède une valeur maxmemory de 2 Go). Dans l'architecture Cluster, l'éviction est déclenchée par nœud de données, même si la mémoire totale du cluster n'est pas épuisée. Gérez proactivement le déséquilibre des données. Consultez la rubrique Comment gérer le déséquilibre des données. Les politiques basées sur LRU (Least Recently Used), LFU (Least Frequently Used) et TTL (Time To Live) utilisent des algorithmes aléatoires approximatifs. Valeurs valides : volatile-lru (valeur par défaut pour les instances à mémoire optimisée et Redis Open-Source Edition) — supprime la clé utilisée le moins récemment parmi les clés dotées d'une date d'expiration. noeviction (valeur par défaut pour les instances à mémoire persistante) — bloque les nouvelles écritures lorsque la mémoire est pleine ; renvoie une erreur. volatile-lfu — supprime la clé utilisée le moins fréquemment parmi les clés dotées d'une date d'expiration. volatile-random — supprime aléatoirement parmi les clés dotées d'une date d'expiration. volatile-ttl — supprime les clés dont le TTL restant est le plus court parmi les clés dotées d'une date d'expiration. allkeys-lru — supprime la clé utilisée le moins récemment parmi toutes les clés. allkeys-lfu — supprime la clé utilisée le moins fréquemment parmi toutes les clés. allkeys-random — supprime aléatoirement parmi toutes les clés.

    		Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️
    maxmemory-eviction-tenacityContrôle l'agressivité avec laquelle l'instance supprime les clés par cycle d'éviction. Valeur par défaut : 10. Plage : 0–100. Des valeurs plus faibles réduisent la latence par cycle mais peuvent laisser plus de clés évictables en mémoire. Des valeurs plus élevées suppriment davantage de clés par cycle au prix d'une latence accrue ; une valeur de 100 ignore la latence et supprime continuellement jusqu'à ce que la mémoire descende en dessous de maxmemory ou qu'il ne reste plus aucune clé évictable. En cas de trafic d'écriture élevé, augmentez cette valeur, mais attendez-vous à une latence plus importante.
    Remarque

    Disponible uniquement dans Redis 7.0.

    		Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️❌❌❌❌
    active-expire-effortContrôle l'effort consacré par l'instance à chaque cycle pour supprimer les clés expirées. Valeur par défaut : 1. Plage : 1–10. Des valeurs plus élevées permettent de supprimer les clés expirées plus rapidement, mais consomment davantage de CPU.Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️❌❌❌
    client-output-buffer-limit pubsubLimite du tampon de sortie pour les clients Pub/Sub. Valeur par défaut : 33554432 8388608 60. Format : <hard-limit> <soft-limit> <soft-seconds>. hard-limit : déconnecte immédiatement le client lorsque le tampon atteint cette taille (en octets). soft-limit et soft-seconds : déconnecte le client si son tampon reste supérieur ou égal à la limite soft pendant le nombre de secondes spécifié.
    Important

    Les tampons de sortie volumineux consomment de la mémoire. Une accumulation excessive de commandes peut entraîner une éviction des données ou des plantages dus à un manque de mémoire. Vérifiez les spécifications de mémoire de votre instance avant d'ajuster ce paramètre.

    		Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️
    client-output-buffer-limit normalLimite du tampon de sortie pour les clients réguliers. Valeur par défaut : 524288000 0 0. Format : <hard-limit> <soft-limit> <soft-seconds>. Consultez client-output-buffer-limit pubsub pour plus de détails sur le format.
    Important

    Pris en charge uniquement sur Redis 6.0 ou versions ultérieures. Les tampons de sortie volumineux consomment de la mémoire. Une accumulation excessive de commandes peut entraîner une éviction des données ou des plantages dus à un manque de mémoire.

    		Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️❌❌❌

    Suppression asynchrone (lazyfree)

    La suppression lazyfree délègue la suppression des clés à un thread d'arrière-plan, réduisant ainsi les pics de latence causés par la suppression de clés volumineuses.

    ParamètreDescriptionVersion 7.0Version 6.0Version 5.0Version 4.0Version 2.8
    lazyfree-lazy-evictionUtilise la suppression asynchrone lors de l'éviction des clés. Valeur par défaut : no. Valeurs valides : yes, no.Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️❌
    lazyfree-lazy-expireUtilise la suppression asynchrone lors de la suppression des clés expirées. Valeur par défaut : yes. Valeurs valides : yes, no.Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️❌
    lazyfree-lazy-server-delUtilise la suppression asynchrone pour les opérations implicites DEL (par exemple, lorsqu'une commande SET écrase une clé existante). Valeur par défaut : yes. Valeurs valides : yes, no.Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️❌
    lazyfree-lazy-user-delUtilise la suppression asynchrone pour les commandes explicites DEL. Valeur par défaut : yes. Valeurs valides : yes, no.Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️❌❌❌
    lazyfree-lazy-user-flushConvertit les commandes FLUSHDB, FLUSHALL, SCRIPT FLUSH et FUNCTION FLUSH en mode de suppression asynchrone. Valeur par défaut : no. Valeurs valides : yes, no.
    Remarque

    Disponible uniquement dans Redis 7.0.

    		Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️❌❌❌❌

    Tâches d'arrière-plan et performances

    ParamètreDescriptionVersion 7.0Version 6.0Version 5.0Version 4.0Version 2.8
    hzFréquence d'exécution des tâches d'arrière-plan, y compris le nettoyage des clés expirées. Valeur par défaut : 10 (10 fois par seconde). Plage : 1–500. Des valeurs plus élevées augmentent la fréquence de nettoyage des clés expirées et la précision des délais d'expiration, mais consomment davantage de CPU. Maintenez cette valeur inférieure ou égale à 100.Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️
    dynamic-hzActive l'ajustement dynamique de la fréquence des tâches d'arrière-plan en fonction de l'activité des clients. Valeur par défaut : yes. Valeurs valides : yes, no.Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️❌❌
    timeoutDélai d'inactivité pour les connexions clientes, en secondes. Lorsqu'un client reste inactif pendant cette durée, l'instance ferme la connexion. Valeur par défaut : 0 (les connexions ne sont jamais fermées). Plage : 0–100000.Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️❌
    latency-trackingActive le suivi de la latence par commande. Valeur par défaut : yes. Valeurs valides : yes, no.
    Remarque

    Disponible uniquement dans Redis 7.0.

    		Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️❌❌❌❌
    tracking-table-max-keysNombre maximal de clés stockées dans la table de suivi de la mise en cache côté client. Valeur par défaut : 1000000. Plage : 0–1000000000.
    Remarque

    Disponible uniquement dans Redis 7.0.

    		Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️❌❌❌❌

    Journal des requêtes lentes

    Paramètre Description Version 7.0 Version 6.0 Version 5.0 Version 4.0 Version 2.8
    slowlog-log-slower-than Seuil pour le journal des requêtes lentes, en microsecondes (μs). Les commandes dont l'exécution dépasse cette valeur sont enregistrées. Valeur par défaut :20000 (20 ms). Plage : 10000–10000000. Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️ Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️ Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️ Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️ Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️
    slowlog-max-len Nombre maximal d'entrées stockées dans le journal des requêtes lentes. Valeur par défaut :1024. Plage : 100–10000. Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️ Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️ Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️ Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️ Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️

    Notifications d'espace de clés

    ParamètreDescriptionVersion 7.0Version 6.0Version 5.0Version 4.0Version 2.8
    notify-keyspace-eventsTypes d'événements que le serveur publie auprès des clients sous forme de notifications d'espace de clés. La valeur est une combinaison des indicateurs de caractères suivants. S'applique à toutes les bases de données de l'instance. L'activation des notifications consomme des ressources CPU. Pour plus de détails, consultez la documentation Notifications d'espace de clés Redis. Valeur par défaut : vide (notifications désactivées).
    Important

    La valeur doit inclure au moins K ou E ; sinon, aucune notification n'est envoyée. Indicateurs de caractères : K — événements d'espace de clés, publiés avec le préfixe _keyspace@<db>_. E — événements de keyevent, publiés avec le préfixe _keyevent@<db>_. g — événements génériques non spécifiques à un type de données (par exemple, DEL, EXPIRE, RENAME). $ — événements de commande string. l — événements de commande list. s — événements de commande set. h — événements de commande hash. z — événements de commande sorted set. x — événements d'expiration (publiés lorsqu'une clé expirée est supprimée, et non lorsqu'elle expire). e — événements d'éviction (publiés lorsqu'une clé est évictée par maxmemory-policy). A — tous les types d'événements ; alias pour g$lshzxe. Exemple : définissez la valeur sur Ex pour recevoir les événements d'expiration, puis exécutez PSUBSCRIBE _keyevent@0_* sur votre client pour recevoir les notifications keyevent pour DB0.

    		Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️

    Statistiques des principales clés

    ParamètreDescriptionVersion 7.0Version 6.0Version 5.0Version 4.0Version 2.8
    bigkey-thresholdSeuil du nombre d'éléments pour identifier les grandes clés dans les Statistiques des principales clés. Valeur par défaut : 2000. Plage : 500–100000.
    Remarque

    Si ce paramètre n'est pas visible dans vos paramètres, mettez à niveau la version mineure et réessayez.

    		Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️❌❌
    hotkey-thresholdSeuil QPS pour identifier les clés très sollicitées dans les Statistiques des principales clés. Valeur par défaut : 5000. Plage : 100–100000.
    Remarque

    Nécessite la version mineure 7.0.1.8, 6.0.2.9, 5.5.2.9 ou ultérieure.

    		Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️❌❌

    Encodage des données

    Les paramètres ci-dessous contrôlent l'encodage interne utilisé par Redis pour chaque type de données. Les encodages compacts (ziplist, listpack, intset) réduisent l'utilisation de la mémoire, mais basculent vers des encodages plus flexibles lorsque les données dépassent les seuils configurés.

    Encodage Hash

    Paramètre Description Version 7.0 Version 6.0 Version 5.0 Version 4.0 Version 2.8
    hash-max-listpack-entries Nombre maximal de paires clé-valeur dans un hash avant de basculer de l'encodage listpack vers hashtable. Pour Redis 7.0, listpack est l'encodage hash par défaut. Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️ ❌ ❌ ❌ ❌
    hash-max-listpack-value Longueur maximale de chaîne (en octets) pour les clés ou les valeurs dans un hash avant de basculer de l'encodage listpack vers hashtable. Pour Redis 7.0, listpack est l'encodage hash par défaut. Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️ ❌ ❌ ❌ ❌
    hash-max-ziplist-entries Nombre maximal de paires clé-valeur dans un hash avant de basculer de l'encodage ziplist vers hashtable. Pour Redis 6.0 et versions antérieures, ziplist est l'encodage hash par défaut. ❌ Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️ Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️ Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️ Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️
    hash-max-ziplist-value Longueur maximale de chaîne (en octets) pour les clés ou les valeurs dans un hash avant de basculer de l'encodage ziplist vers hashtable. Pour Redis 6.0 et versions antérieures, ziplist est l'encodage hash par défaut. ❌ Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️ Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️ Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️ Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️

    Encodage Sorted Set

    Paramètre Description Version 7.0 Version 6.0 Version 5.0 Version 4.0 Version 2.8
    zset-max-listpack-entries Nombre maximal d'éléments dans un sorted set avant de basculer de l'encodage listpack vers skiplist. Pour Redis 7.0, listpack est l'encodage sorted set par défaut. Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️ ❌ ❌ ❌ ❌
    zset-max-listpack-value Longueur maximale de chaîne (en octets) pour les éléments dans un sorted set avant de basculer de l'encodage listpack vers skiplist. Pour Redis 7.0, listpack est l'encodage sorted set par défaut. Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️ ❌ ❌ ❌ ❌
    zset-max-ziplist-entries Nombre maximal d'éléments dans un sorted set avant de basculer de l'encodage ziplist vers skiplist. Pour Redis 6.0 et versions antérieures, ziplist est l'encodage sorted set par défaut. ❌ Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️ Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️ Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️ Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️
    zset-max-ziplist-value Longueur maximale de chaîne (en octets) pour les éléments dans un sorted set avant de basculer de l'encodage ziplist vers skiplist. Pour Redis 6.0 et versions antérieures, ziplist est l'encodage sorted set par défaut. ❌ Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️ Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️ Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️ Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️

    Encodage List

    Paramètre Description Version 7.0 Version 6.0 Version 5.0 Version 4.0 Version 2.8
    list-max-listpack-size Contrôle la taille de chaque nœud quicklist pour les valeurs de liste, en utilisant l'encodage listpack (Redis 7.0). Les valeurs positives limitent le nœud par nombre d'éléments. Les valeurs négatives limitent par taille en octets : -5 (≤ 64 Ko), -4 (≤ 32 Ko), -3 (≤ 16 Ko), -2 (≤ 8 Ko, par défaut), -1 (≤ 4 Ko). Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️ ❌ ❌ ❌ ❌
    list-max-ziplist-size Contrôle la taille de chaque nœud quicklist pour les valeurs de liste, en utilisant l'encodage ziplist (Redis 6.0 et versions antérieures). Les valeurs positives limitent le nœud par nombre d'éléments. Les valeurs négatives limitent par taille en octets : -5 (≤ 64 Ko), -4 (≤ 32 Ko), -3 (≤ 16 Ko), -2 (≤ 8 Ko, par défaut), -1 (≤ 4 Ko). ❌ Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️ Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️ Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️ ❌
    list-max-ziplist-entries Nombre maximal d'éléments dans un nœud de liste avant de basculer de l'encodage ziplist. S'applique uniquement à Redis 2.8. ❌ ❌ ❌ ❌ Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️
    list-max-ziplist-value Longueur maximale en octets par élément dans un nœud de liste avant de basculer de l'encodage ziplist. S'applique uniquement à Redis 2.8. ❌ ❌ ❌ ❌ Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️
    list-compress-depth Nombre de nœuds quicklist à chaque extrémité d'une liste exemptés de compression. Valeur par défaut :0 (pas de compression). Plage : 0–65535. Une valeur de 1, par exemple, conserve le premier et le dernier nœud non compressés ; tous les nœuds intermédiaires sont compressés. Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️ Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️ Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️ Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️ ❌

    Encodage Set

    Paramètre Description Version 7.0 Version 6.0 Version 5.0 Version 4.0 Version 2.8
    set-max-intset-entries Nombre maximal d'éléments dans un set avant de basculer de l'encodage intset vers hashtable. L'encodage intset s'applique lorsque tous les éléments sont des entiers en base 10 dans la plage des entiers signés 64 bits. Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️ Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️ Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️ Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️ Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️

    Encodage Stream

    Paramètre Description Version 7.0 Version 6.0 Version 5.0 Version 4.0 Version 2.8
    stream-node-max-bytes Mémoire maximale par macro-nœud de stream, en octets. Valeur par défaut :0 (pas de limite). Plage : 0–999,999,999,999,999. Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️ Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️ Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️ ❌ ❌
    stream-node-max-entries Nombre maximal d'entrées par macro-nœud de stream. Valeur par défaut :0 (pas de limite). Plage : 0–999,999,999,999,999. Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️ Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️ Standard ✔️ Cluster ✔️ Lecture/écriture fractionnée ✔️ ❌ ❌

    Paramètres des nœuds proxy

    Les paramètres des nœuds proxy s'appliquent uniquement aux instances Cluster en mode proxy et aux instances de lecture/écriture fractionnée.

    Compatibilité

    ParamètreDescription
    cluster_compat_enableActive la compatibilité avec la syntaxe native du cluster Redis. Valeur par défaut : 1. Valeurs valides : 1 — active la compatibilité ; les séries de commandes READONLY, READWRITE et CLUSTER sont prises en charge. Consultez la rubrique Liste des commandes prises en charge en mode proxy. 0 — désactive la compatibilité.
    hello_enabledActive le basculement entre les protocoles RESP2 et RESP3 à l'aide de la commande HELLO. Valeur par défaut : 0. Valeurs valides : 1 — activé ; 0 — désactivé.
    Remarque

    Nécessite Proxy 7.0.9 ou version ultérieure.

    sentinel_compat_enableActive le mode compatible Sentinel pour les instances Cluster en mode proxy ou les instances de lecture/écriture fractionnée. Valeur par défaut : 0. Valeurs valides : 1 — activé ; 0 — désactivé.

    Gestion des connexions

    Paramètre Description
    max_session_processing Nombre maximal de requêtes en cours par connexion. Valeur par défaut :1000. Plage : 10–10000000. Une requête est considérée comme en cours depuis le moment où le proxy la transfère vers un nœud de données jusqu'à ce que le proxy reçoive la réponse. Cette limite empêche la croissance de la mémoire causée par les différences de vitesse de traitement entre le frontend et le backend du proxy.
    rt_threshold_ms Seuil du journal des requêtes lentes pour le nœud proxy, en millisecondes (ms). Valeur par défaut :500. Plage : 30–2000. Une entrée de journal des requêtes lentes est générée lorsque le temps aller-retour entre le proxy et un nœud de données dépasse ce seuil.
    ptod_enabled Contrôle si le proxy transmet l'adresse IP d'origine du client aux nœuds de données. Valeur par défaut :1. Valeurs valides : 1 — transmet l'IP du client ; 0 — les nœuds de données voient l'adresse IP du proxy à la place.

    Routage des requêtes

    Paramètre Description
    read_request_only_ronode_whenrwsplit_enable Contrôle le routage des requêtes provenant des comptes en lecture seule. Valeur par défaut :0. Valeurs valides : 1 — route les requêtes des comptes en lecture seule directement vers les réplicas en lecture, jamais vers le nœud principal. 0 — distribue les requêtes des comptes en lecture seule sur tous les nœuds (y compris le nœud principal) en fonction du poids.
    readonly_lua_route_ronode_enable Contrôle le routage des scripts Lua lorsque des réplicas en lecture sont disponibles. Valeur par défaut :0. Valeurs valides : 1 — les scripts Lua contenant uniquement des opérations de lecture sont transférés vers les réplicas en lecture. 0 — tous les scripts Lua sont traités par le nœud principal.

    Gestion des scripts Lua

    Paramètre Description
    script_check_enable Active la validation des scripts Lua par le proxy. Pour plus de détails sur les éléments vérifiés, consultez la rubrique Vérifications du proxy pour les scripts Lua. Valeur par défaut :1. Valeurs valides : 1 — le proxy valide les scripts Lua avant leur exécution. 0 — le proxy ignore la validation, sauf pour les connexions de compte en lecture seule, qui sont toujours vérifiées.
    transfer_subscrible_to_psubscrible_enable Convertit SUBSCRIBE en PSUBSCRIBE au niveau du proxy. Valeur par défaut :0. Valeurs valides : 1 — active la conversion. 0 — pas de conversion. Activez cette option si vous ne recevez pas de messages sur un canal abonné car les commandes SUBSCRIBE ou PUBLISH sont utilisées dans un script Lua.

    Observabilité

    Ces paramètres font partie des fonctionnalités d'observabilité. Ils nécessitent que les journaux d'audit soient activés avant que les statistiques ne soient enregistrées. Les statistiques sont collectées toutes les 5 secondes.

    Paramètre Description
    #no_loose_statistics-ip-enable Active les statistiques de connexion par adresse IP. Valeur par défaut :no. Valeurs valides : yes, no. Lorsque cette option est activée, l'instance enregistre les adresses IP des clients connectés.
    #no_loose_statistics-cmds Spécifie les commandes à surveiller pour l'adresse IP source et la fréquence d'accès. Valeur par défaut : vide (pas de surveillance). Spécifiez les noms des commandes en minuscules, séparés par des virgules.
    #no_loose_statistics-keys Spécifie les clés à surveiller pour l'adresse IP source et la fréquence d'accès. Valeur par défaut : vide (pas de surveillance). Séparez plusieurs noms de clés par des virgules.

    Après avoir activé ces paramètres, téléchargez les journaux d'audit depuis la console Simple Log Service. Consultez la rubrique Télécharger les journaux d'audit. Filtrez par type de journal :

    • Type 7 : Statistiques QPS par adresse IP

    • Type 8 : Statistiques de connexion par adresse IP

    • Type 9 : Statistiques des clés

    • Type 10 : Statistiques des commandes

    Pour éviter tout impact sur les performances, limitez le nombre de commandes et de clés spécifiées dans #no_loose_statistics-cmds et #no_loose_statistics-keys . Activez ces paramètres uniquement lors des tâches de dépannage ou de maintenance.