Tous les produits
Search
Centre de documentation

Tair (Redis® OSS-Compatible):Configuration parameter list for Tair Enterprise Edition

Dernière mise à jour :Aug 10, 2026

Tair (Enterprise Edition) vous permet d'ajuster le comportement des instances en modifiant un ensemble de paramètres pris en charge. Cette rubrique répertorie tous les paramètres configurables pour les instances optimisées pour la mémoire, à mémoire persistante et basées sur le disque.

Pour connaître les paramètres applicables aux instances Redis Open-Source Edition, consultez la rubrique Paramètres Redis pris en charge .

Notes d'utilisation

  • Seuls les paramètres répertoriés dans cette rubrique peuvent être configurés. Pour savoir comment définir un paramètre, consultez la section Présentation des paramètres de configuration.

  • Certains paramètres entraînent un redémarrage automatique de l'instance lors de l'application des modifications. Pendant ce redémarrage, l'instance peut subir une brève déconnexion de quelques secondes. Vérifiez la colonne Takes effect upon restart avant d'appliquer les changements.

  • 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 et réessayez.

  • Les paramètres pris en charge varient selon la version du moteur et l'architecture. Pour plus de détails sur l'architecture, consultez la rubrique Interroger les informations d'architecture.

Conventions de tableau

Les tableaux de cette rubrique utilisent les symboles suivants :

  • Coche : Pris en charge

  • Croix : Non pris en charge

Instances à mémoire optimisée et à mémoire persistante

Parameter

Description

Memory-optimized

Persistent memory

Takes effect upon restart

#no_loose_check-whitelist-always

Ce paramètre détermine si l'instance vérifie l'adresse IP du client par rapport à la liste d'autorisation après avoir activé l'accès sans mot de passe pour un VPC. Valeur par défaut : no.

  • yes : L'adresse IP du client doit figurer dans la liste d'autorisation, même après l'activation de l'accès sans mot de passe. Si la liste n'est pas correctement configurée, la connexion renvoie l'erreur (error) ERR illegal address.

  • no : La vérification de la liste d'autorisation est ignorée. Tout client situé dans le même VPC peut se connecter une fois l'accès sans mot de passe activé.

Remarque

Seules les instances utilisant l'architecture classique prennent en charge ce paramètre. Les instances basées sur une architecture cloud-native appliquent toujours la liste d'autorisation des adresses IP, que l'accès sans mot de passe soit activé ou non.

Standard : Pris en charge

Cluster : Pris en charge

Répartition lecture/écriture : Pris en charge

Non pris en charge

No

#no_loose_disabled-commands

Spécifiez les commandes à désactiver. Utilisez cette option pour bloquer les commandes à haut risque ou générant une latence élevée, telles que FLUSHALL, FLUSHDB, KEYS, HGETALL, EVAL, EVALSHA et SCRIPT.

  • Saisissez les commandes en minuscules, séparées par des virgules.

  • La désactivation de FLUSHALL n'affecte pas la fonctionnalité Clear Data de la console.

  • Certaines commandes, comme CONFIG, ne peuvent pas être désactivées. Consultez la rubrique Commandes qui ne peuvent pas être désactivées.

Standard : Pris en charge

Cluster : Pris en charge

Répartition lecture/écriture : Pris en charge

Standard : Pris en charge

Cluster : Pris en charge

Répartition lecture/écriture : Pris en charge

No

#no_loose_high-cost-key-enabled

#no_loose_high-cost-key-traffic-bytes-threshold

#no_loose_high-cost-key-parse-hashtag

#no_loose_high-cost-key-parse-prefix

#no_loose_high-cost-key-parse-prefix-delimiters

#no_loose_high-cost-key-parse-prefix-find-limit-n

#no_loose_high-cost-key-parse-prefix-skip-first-n

Cet ensemble de paramètres permet de surveiller les clés actives (clés générant un trafic d'accès élevé). Une fois la fonctionnalité activée, vous pouvez consulter les clés actives détectées dans CloudDBA > Top Key Statistics.

Important

L'activation de cette fonctionnalité augmente l'utilisation du CPU de plus de 5 %, proportionnellement au nombre de clés. Activez-la uniquement lorsque cela est nécessaire.

  • #no_loose_high-cost-key-enabled : Interrupteur permettant d'activer la fonctionnalité. Valeur par défaut : no (désactivé). Définissez la valeur sur yes pour l'activer.

  • #no_loose_high-cost-key-traffic-bytes-threshold : Seuil de trafic d'accès (en octets par seconde) déclenchant le signalement d'une clé active. Valeurs valides : 1024 à 4294967295. Valeur par défaut : 1048576 (1 Mo/s).

  • #no_loose_high-cost-key-parse-hashtag : Agrège les clés partageant le même {hashtag}. Si le trafic combiné de ces clés dépasse le seuil, le hashtag est signalé comme clé active. Valeur par défaut : no.

    Par exemple, {user}a et {user}b ne sont pas individuellement des clés actives. Toutefois, si leur trafic agrégé dépasse le seuil, Top Key Statistics identifie {user} comme une clé active de type Hashtag.

  • #no_loose_high-cost-key-parse-prefix : Agrège les clés partageant le même préfixe. Valeur par défaut : no. Les trois paramètres suivants ne s'appliquent que si ce paramètre est activé :

    • #no_loose_high-cost-key-parse-prefix-delimiters : Caractères utilisés comme séparateurs. Valeur par défaut : vide. Lorsque vous spécifiez plusieurs caractères (par exemple, : _), chaque caractère est traité comme un séparateur individuel.

    • #no_loose_high-cost-key-parse-prefix-skip-first-n : Nombre de séparateurs initiaux à ignorer. Valeurs valides : 0 à 5. Valeur par défaut : 0.

    • #no_loose_high-cost-key-parse-prefix-find-limit-n : Nombre maximal de segments à extraire en tant que préfixe. Valeurs valides : 1 à 5. Valeur par défaut : 1.

    Prenons l'exemple des clés service:user:123 et service:user:456 avec le séparateur :. Si skip-first-n vaut 1 et find-limit-n vaut 1, la clé active service:user est capturée. Si skip-first-n vaut 0 et find-limit-n vaut 2, les clés service et service:user sont toutes deux capturées.

Remarque

Pris en charge uniquement sur les instances optimisées pour la mémoire basées sur une architecture cloud-native, avec une version mineure 25.2.0.0 ou ultérieure. L'analyse des hashtags et des préfixes nécessite une version mineure 25.9.1.0 ou ultérieure.

Standard : Pris en charge

Cluster : Pris en charge

Répartition lecture/écriture : Pris en charge

Non pris en charge

No

#no_loose_lua-strict-mode

Active le mode strict pour les scripts Lua. Lorsqu'il est activé, les instances d'architecture standard se comportent comme les instances d'architecture cluster : les clés de données dans les scripts Lua doivent être transmises via le tableau KEYS et ne peuvent pas être générées dynamiquement. Cela permet aux scripts Lua d'utiliser le traitement parallèle multithread, ce qui améliore considérablement les performances. Valeur par défaut : no.

Remarque

Pris en charge uniquement sur les instances optimisées pour la mémoire compatibles avec Redis 6.0 ou versions ultérieures.

Standard : Pris en charge

Cluster : Non pris en charge

Répartition lecture/écriture : Non pris en charge

Non pris en charge

No

#no_loose_maxmemory-evict-percent-soft-limit

Définit le pourcentage d'utilisation de la mémoire à partir duquel l'éviction en arrière-plan commence, avant que l'instance n'atteigne sa limite Maxmemory. Cela permet une éviction précoce sans affecter les performances des commandes. Valeurs valides : 50 à 100. Valeur par défaut : 100.

La politique d'éviction reste régie par le paramètre maxmemory-policy.

Remarque

Pris en charge uniquement sur les instances optimisées pour la mémoire compatibles avec Redis 6.0 ou versions ultérieures, avec une version mineure 25.2.0.0 ou ultérieure.

Standard : Pris en charge

Cluster : Pris en charge

Répartition lecture/écriture : Pris en charge

Non pris en charge

No

#no_loose_publish-no-wait-result

Améliore le débit de la commande PUBLISH en ne attendant pas le nombre d'abonnés. Lorsqu'elle est activée, la commande PUBLISH renvoie toujours 0. Valeur par défaut : no.

Remarque

Pris en charge uniquement sur les instances optimisées pour la mémoire compatibles avec Redis 6.0 ou versions ultérieures.

Standard : Pris en charge

Cluster : Pris en charge

Répartition lecture/écriture : Pris en charge

Non pris en charge

No

#no_loose_qps-limit-dim

#no_loose_qps-limit

Cet ensemble de paramètres permet de limiter le débit QPS (requêtes par seconde), ce qui vous permet de contrôler l'accès à l'instance. Lorsqu'il est activé, si le nombre de requêtes adressées à l'instance atteint le seuil configuré, l'instance refuse les nouvelles requêtes et renvoie l'erreur -THROTTLED.

  • #no_loose_qps-limit-dim : Dimension de limitation. Valeurs valides :

    • read (par défaut) : Limite les requêtes de lecture.

    • write : Limite les requêtes d'écriture.

    • rw : Limite les requêtes de lecture et d'écriture.

    • all : Limite toutes les commandes.

    • other : Limite les commandes diverses telles que INFO et PING.

  • #no_loose_qps-limit : Limite supérieure de QPS. Valeurs valides : 0 à 1000000000. La valeur par défaut est 0, ce qui désactive la limitation. Si ce paramètre est défini sur 0, le paramètre #no_loose_qps-limit-dim ne prend pas effet.

Remarque
  • Pris en charge uniquement sur les instances optimisées pour la mémoire compatibles avec Redis 6.0 ou versions ultérieures, avec une version mineure 25.1.0.0 ou ultérieure.

  • Nous vous recommandons de gérer les erreurs THROTTLED côté client au préalable pour éviter les exceptions. Nous vous conseillons également d'éviter les nouvelles tentatives fréquentes lorsque le client reçoit une erreur THROTTLED.

Standard : Pris en charge

Cluster : Pris en charge

Répartition lecture/écriture : Pris en charge

Non pris en charge

No

#no_loose_sentinel-enabled

Active le mode compatible avec Sentinel pour l'instance. Valeur par défaut : no.

  • yes : Activé.

  • no : Désactivé.

Standard : Pris en charge

Cluster : Pris en charge

Répartition lecture/écriture : Non pris en charge

Standard : Pris en charge

Cluster : Pris en charge

Répartition lecture/écriture : Non pris en charge

No

#no_loose_sentinel-password-free-access

Lorsque le mode Sentinel est activé, ce paramètre contrôle si les commandes Sentinel peuvent être exécutées sans mot de passe sur n'importe quelle connexion. Valeur par défaut : no.

  • yes : L'exécution sans mot de passe des commandes Sentinel est autorisée. Vous pouvez également utiliser la commande SENTINEL pour écouter le canal +switch-master.

  • no : Désactivé.

Standard : Pris en charge

Cluster : Pris en charge

Répartition lecture/écriture : Pris en charge

Standard : Pris en charge

Cluster : Pris en charge

Répartition lecture/écriture : Pris en charge

No

#no_loose_sentinel-password-free-commands

Lorsque le mode Sentinel est activé et que le paramètre #no_loose_sentinel-password-free-access est défini sur yes, ce paramètre spécifie les commandes supplémentaires pouvant être exécutées sans mot de passe sur n'importe quelle connexion. Valeur par défaut : vide.

Important

Les commandes configurées ici peuvent être exécutées sans authentification sur n'importe quelle connexion. Saisissez les commandes en minuscules, séparées par des virgules.

Standard : Pris en charge

Cluster : Pris en charge

Répartition lecture/écriture : Pris en charge

Standard : Pris en charge

Cluster : Pris en charge

Répartition lecture/écriture : Pris en charge

No

#no_loose_slow-query-isolation-weight

Définit le seuil (nombre de sous-éléments dans une clé) au-dessus duquel les commandes de requête lente sont routées vers un thread isolé, libérant ainsi le thread principal pour les commandes régulières. Les commandes concernées sont : KEYS, SMEMBERS, HKEYS, HVALS, HGETALL, EXHKEYS, EXHVALS et EXHGETALL. Pour la commande KEYS, le seuil s'applique au nombre de clés dans la base de données actuelle. Valeurs valides : 1 à 999999999999999. Valeur par défaut : 1000.

Par exemple, si un ensemble (Set) contient plus de 1 000 membres, la commande SMEMBERS sur cette clé utilise le thread isolé. Lorsque la file d'attente en attente du thread isolé dépasse 500 requêtes, les commandes suivantes retombent sur les threads réguliers.

Remarque

Évitez de définir ce seuil trop bas. Une pression excessive sur le thread isolé gaspille des ressources. Si la plupart des requêtes sont des commandes de requête lente, envisagez de désactiver l'isolation en définissant ce paramètre sur 999999999999999. Pris en charge uniquement sur les instances optimisées pour la mémoire basées sur une architecture cloud-native.

Standard : Pris en charge

Cluster en connexion directe : Pris en charge

Cluster avec proxy : Non pris en charge

Répartition lecture/écriture : Non pris en charge

Non pris en charge

No

#no_loose_tsync-repl-mode

Mode de synchronisation entre les nœuds primaire et secondaire. Valeurs valides :

  • async (par défaut) : Utilise la réplication asynchrone native de Redis.

  • semisync : Mode semi-synchrone. Lorsqu'il est activé, le nœud primaire réplique les opérations de mise à jour vers le nœud secondaire avant de renvoyer une réponse au client. Ce mode augmente la latence d'écriture d'environ 0,5 ms à 3 ms. Il convient aux scénarios nécessitant une cohérence élevée des données et pouvant tolérer une certaine dégradation des performances d'écriture.

    Lorsque le nœud secondaire est indisponible ou qu'une exception réseau se produit entre les nœuds primaire et secondaire, le mode semi-synchrone revient en mode asynchrone.

Remarque

Pris en charge uniquement sur les instances optimisées pour la mémoire compatibles avec Redis 6.0 ou versions ultérieures, avec une version mineure 23.12.2.0 ou ultérieure.

Standard : Pris en charge

Cluster : Pris en charge

Répartition lecture/écriture : Pris en charge

Non pris en charge

No

#no_loose_tsync-semisync-wait-timeout-ms

Avant d'ajuster ce paramètre, vous devez d'abord activer le mode semi-synchrone (définir #no_loose_tsync-repl-mode sur semisync).

Ce paramètre définit le délai d'expiration pour le mode semi-synchrone. Si le temps d'attente d'une requête d'écriture pour la synchronisation primaire-secondaire dépasse ce seuil, la requête est immédiatement renvoyée au client, même si elle n'a pas encore été répliquée vers le nœud secondaire. Unité : millisecondes. Valeurs valides : 1 à 7200000. Valeur par défaut : 100.

Remarque

Pris en charge uniquement sur les instances optimisées pour la mémoire compatibles avec Redis 6.0 ou versions ultérieures, avec une version mineure 23.12.2.0 ou ultérieure. Modifiez avec précaution.

Standard : Pris en charge

Cluster : Pris en charge

Répartition lecture/écriture : Pris en charge

Non pris en charge

No

#no_loose_tls-min-version

Définit la version minimale de TLS acceptée par l'instance. Valeur par défaut : TLSv1.

Valeurs valides : TLSv1, TLSv1.1, TLSv1.2.

Standard : Non pris en charge

Cluster : Pris en charge

Répartition lecture/écriture : Pris en charge

Non pris en charge

No

#no_loose_ts-auto-del-empty-skey-enable

Contrôle la suppression automatique d'une Skey dans une structure de données TairTS lorsque tous ses points de données ont expiré. Valeur par défaut : yes.

  • yes : la Skey est supprimée à l'expiration de tous les points de données.

  • no : la Skey vide est conservée.

Remarque

Prise en charge uniquement sur les instances optimisées pour la mémoire compatibles avec Redis 6.0 ou version ultérieure, dont la version mineure est 24.7.0.0 ou supérieure.

Standard : pris en charge

Cluster : pris en charge

Lecture/écriture séparées : pris en charge

Standard : pris en charge

Cluster : pris en charge

Lecture/écriture séparées : pris en charge

Non

active-expire-effort

Définit l'agressivité du nettoyage des clés expirées en arrière-plan. Des valeurs plus élevées réduisent plus rapidement la mémoire occupée par les clés expirées, mais augmentent l'utilisation du CPU et la latence. Valeurs valides : 1 à 10. Valeur par défaut : 1.

Remarque

Prise en charge uniquement sur les instances à mémoire persistante.

Non pris en charge

Standard : pris en charge

Cluster : pris en charge

Lecture/écriture séparées : pris en charge

Non

appendfsync

Fréquence fsync pour la persistance Append-Only File (AOF). Ce paramètre prend effet uniquement si appendonly est activé. Valeur par défaut : everysec (non modifiable).

Standard : pris en charge

Cluster : pris en charge

Lecture/écriture séparées : pris en charge

Standard : pris en charge

Cluster : pris en charge

Lecture/écriture séparées : pris en charge

Non

appendonly

Active ou désactive la persistance AOF sur le nœud principal. Valeur par défaut : yes.

  • yes : la persistance AOF est activée.

  • no : la persistance AOF est désactivée.

Remarque

La persistance Redis Database (RDB) s'exécute une fois par jour par défaut. Pour plus d'informations, consultez Sauvegarde automatique ou manuelle.

Avertissement

Une fois la fonction AOF désactivée, l'instance ne s'appuie que sur les sauvegardes RDB pour la récupération des données. En cas de défaillance extrême, les données écrites après la dernière sauvegarde RDB risquent de ne pas être récupérables. Si votre activité exige une haute récupérabilité des données, nous vous recommandons de maintenir la fonction AOF activée.

Standard : pris en charge

Cluster : pris en charge

Lecture/écriture séparées : pris en charge

Standard : pris en charge

Cluster : pris en charge

Lecture/écriture séparées : pris en charge

Oui

bigkey-threshold

Seuil du nombre d'éléments permettant d'identifier les grandes clés (clés comportant de nombreux éléments) dans Statistiques des principales clés. Valeurs valides : 500 à 100000. Valeur par défaut : 2000.

Remarque

Si ce paramètre n'apparaît pas dans les paramètres, mettez à niveau la version mineure et réessayez.

Standard : pris en charge

Cluster : pris en charge

Lecture/écriture séparées : pris en charge

Non pris en charge

Non

bigkey-mem-threshold

Seuil de taille mémoire permettant d'identifier les grandes clés (clés consommant beaucoup de mémoire) dans Statistiques des principales clés. Unité : octets. Valeurs valides : 1048576 à 1073741824 (1 Mo à 1 Go). Valeur par défaut : 536870912 octets (512 Mo).

Remarque

Prise en charge uniquement sur les instances cloud-native optimisées pour la mémoire dont la version mineure est 25.6.0.0 ou supérieure.

Standard : pris en charge

Cluster : pris en charge

Lecture/écriture séparées : pris en charge

Non pris en charge

Non

bigkey-field-mem-threshold

Seuil moyen de taille mémoire par sous-élément permettant d'identifier les grandes clés (clés consommant beaucoup de mémoire) dans Statistiques des principales clés. Unité : octets. Valeurs valides : 1024 à 1073741824 (1 Ko à 1 Go). Valeur par défaut : 1048576 octets (1 Mo).

Remarque
  • Prise en charge uniquement sur les instances cloud-native optimisées pour la mémoire dont la version mineure est 25.6.0.0 ou supérieure.

  • À compter du 26 mai 2026, la valeur par défaut de ce paramètre passe de 50 Mo à 1 Mo.

Standard : pris en charge

Cluster : pris en charge

Lecture/écriture séparées : pris en charge

Non pris en charge

Non

client-output-buffer-limit pubsub

client-output-buffer-limit normal

Limite le tampon de sortie pour les clients pub/sub et les clients normaux. Format : <limite stricte> <limite souple> <secondes souples>.

  • Valeur par défaut pour pubsub : 33554432 8388608 60

  • Valeur par défaut pour normal : 524288000 0 0

Lorsque le tampon de sortie d'un client atteint la limite stricte, la connexion est immédiatement fermée. Lorsque le tampon atteint la limite souple et y reste pendant le nombre de secondes spécifié, la connexion est fermée.

Important
  • Seules les instances optimisées pour la mémoire compatibles avec Redis 6.0 ou version ultérieure prennent en charge client-output-buffer-limit normal.

  • Le tampon de sortie client consomme de la mémoire d'exécution. Si trop de commandes s'accumulent, l'instance peut déclencher l'éviction des données ou manquer de mémoire. Vérifiez la capacité mémoire de votre instance avant d'ajuster ces valeurs.

Standard : pris en charge

Cluster : pris en charge

Lecture/écriture séparées : pris en charge

Standard : pris en charge

Cluster : pris en charge

Lecture/écriture séparées : pris en charge

Non

dynamic-hz

Active l'ajustement dynamique de la fréquence d'exécution des tâches en arrière-plan. Valeur par défaut : yes.

  • yes : activé.

  • no : désactivé.

Standard : pris en charge

Cluster : pris en charge

Lecture/écriture séparées : pris en charge

Standard : pris en charge

Cluster : pris en charge

Lecture/écriture séparées : pris en charge

Non

globalvectorindex_enabled

Active ou désactive l'index global TairVector. Valeur par défaut : 0.

  • 0 : désactivé.

  • 1 : activé.

Standard : non pris en charge

Cluster : pris en charge

Lecture/écriture séparées : non pris en charge

Non pris en charge

Non

hash-max-ziplist-entries

hash-max-ziplist-value

Pour les instances compatibles avec Redis 6.0 et versions antérieures, un objet hash utilise l'encodage ziplist lorsque les deux conditions suivantes sont remplies : le nombre de paires clé-valeur est inférieur à hash-max-ziplist-entries, et la longueur de chaîne de toutes les clés et valeurs est inférieure à hash-max-ziplist-value.

Standard : pris en charge

Cluster : pris en charge

Lecture/écriture séparées : pris en charge

Standard : pris en charge

Cluster : pris en charge

Lecture/écriture séparées : pris en charge

Non

hash-max-listpack-entries

hash-max-listpack-value

Pour les instances compatibles avec Redis 7.0 et versions ultérieures, un objet hash utilise l'encodage listpack lorsque les deux conditions suivantes sont remplies : le nombre de paires clé-valeur est inférieur à hash-max-listpack-entries, et la longueur de chaîne de toutes les clés et valeurs est inférieure à hash-max-listpack-value.

Standard : pris en charge

Cluster : pris en charge

Lecture/écriture séparées : pris en charge

Non pris en charge

Non

hotkey-threshold

Seuil QPS permettant d'identifier les clés fréquentes dans Statistiques des principales clés. Valeurs valides : 100 à 100000. Valeur par défaut : 5000.

Remarque

Prise en charge uniquement sur les instances cloud-native optimisées pour la mémoire. Les versions mineures requises sont :

  • Compatible avec Redis 5.0 : 5.5.0.50 ou version ultérieure.

  • Compatible avec Redis 6.0 et Redis 7.0 : 25.2.0.0 ou version ultérieure.

Standard : pris en charge

Cluster : pris en charge

Lecture/écriture séparées : pris en charge

Non pris en charge

Non

hz

Définit le nombre d'exécutions par seconde des tâches en arrière-plan, telles que le nettoyage des clés expirées. Valeurs valides : 1 à 500. Valeur par défaut : 10.

Des valeurs plus élevées entraînent un nettoyage des clés plus fréquent et une gestion des délais d'attente plus précise, mais augmentent également l'utilisation du CPU. Évitez les valeurs supérieures à 100.

Standard : pris en charge

Cluster : pris en charge

Lecture/écriture séparées : pris en charge

Standard : pris en charge

Cluster : pris en charge

Lecture/écriture séparées : pris en charge

Non

lazyfree-lazy-eviction

Contrôle si l'éviction utilise la suppression asynchrone (lazyfree). Valeur par défaut : no.

  • yes : activé.

  • no : désactivé.

Standard : pris en charge

Cluster : pris en charge

Lecture/écriture séparées : pris en charge

Standard : pris en charge

Cluster : pris en charge

Lecture/écriture séparées : pris en charge

Non

lazyfree-lazy-expire

Contrôle si la suppression des clés expirées utilise la suppression asynchrone (lazyfree). Valeur par défaut : yes.

  • yes : activé.

  • no : désactivé.

Standard : pris en charge

Cluster : pris en charge

Lecture/écriture séparées : pris en charge

Standard : pris en charge

Cluster : pris en charge

Lecture/écriture séparées : pris en charge

Non

lazyfree-lazy-server-del

Contrôle si la commande DEL utilise la suppression asynchrone (lazyfree). Valeur par défaut : yes.

  • yes : activé.

  • no : désactivé.

Standard : pris en charge

Cluster : pris en charge

Lecture/écriture séparées : pris en charge

Standard : pris en charge

Cluster : pris en charge

Lecture/écriture séparées : pris en charge

Non

lazyfree-lazy-user-del

Contrôle si la commande DEL déclenchée par l'utilisateur utilise la suppression asynchrone (lazyfree). Valeur par défaut : yes.

  • yes : activé.

  • no : désactivé.

Non pris en charge

Standard : pris en charge

Cluster : pris en charge

Lecture/écriture séparées : pris en charge

Non

list-compress-depth

Définit le nombre de nœuds conservés non compressés à chaque extrémité d'une liste. Les nœuds situés au milieu sont compressés. Valeurs valides : 0 à 65535. Valeur par défaut : 0 (aucune compression).

Standard : pris en charge

Cluster : pris en charge

Lecture/écriture séparées : pris en charge

Standard : pris en charge

Cluster : pris en charge

Lecture/écriture séparées : pris en charge

Non

list-max-ziplist-size

list-max-listpack-size

Contrôle la taille ou la longueur du ziplist (Redis 6.0 et versions antérieures) ou du listpack (Redis 7.0 et versions ultérieures) sur chaque nœud quicklist.

  • Les valeurs positives limitent le nombre d'éléments de données par nœud. Par exemple, 5 signifie au maximum 5 éléments par nœud.

  • Les valeurs négatives limitent la taille en octets :

    • -1 : 4 Ko

    • -2 (par défaut) : 8 Ko

    • -3 : 16 Ko

    • -4 : 32 Ko

    • -5 : 64 Ko

Standard : pris en charge

Cluster : pris en charge

Lecture/écriture séparées : pris en charge

Standard : pris en charge

Cluster : pris en charge

Lecture/écriture séparées : pris en charge

Non

maxmemory-policy

Politique d'éviction appliquée lorsque l'instance atteint sa limite Maxmemory. Valeur par défaut : volatile-lru pour les instances optimisées pour la mémoire ; noeviction pour les instances à mémoire persistante.

Notes :

  • La valeur Maxmemory correspond à la taille de l'instance achetée et ne peut pas être modifiée.

  • Dans une architecture en cluster, l'éviction est déclenchée par nœud de données lorsque celui-ci atteint sa limite Maxmemory, même si la mémoire totale du cluster n'est pas saturée. Gérez proactivement le déséquilibre des données. Pour plus d'informations, consultez la rubrique Comment gérer le déséquilibre des données ?.

  • Les politiques LRU (Least Recently Used), LFU (Least Frequently Used) et volatile-ttl utilisent des algorithmes aléatoires approximatifs.

Politiques disponibles :

  • volatile-lru : Évince la clé utilisée le moins récemment parmi les clés disposant d'une durée d'expiration définie.

  • noeviction : Rejette les nouvelles écritures lorsque la mémoire est pleine et renvoie une erreur.

  • volatile-lfu : Évince la clé utilisée le moins fréquemment parmi les clés disposant d'une durée d'expiration définie.

  • volatile-random : Évince aléatoirement une clé disposant d'une durée d'expiration définie.

  • volatile-ttl : Évince la clé dont la durée de vie restante (TTL) est la plus courte parmi les clés disposant d'une durée d'expiration définie.

  • allkeys-lru : Évince la clé utilisée le moins récemment parmi toutes les clés.

  • allkeys-lfu : Évince la clé utilisée le moins fréquemment parmi toutes les clés.

  • allkeys-random : Évince aléatoirement une clé parmi toutes les clés.

Standard : Pris en charge

Cluster : Pris en charge

Lecture/écriture séparées : Pris en charge

Standard : Pris en charge

Cluster : Pris en charge

Lecture/écriture séparées : Pris en charge

Non

notify-keyspace-events

Définit les notifications d'événements keyspace envoyées par l'instance. L'activation de cette option consomme des ressources CPU supplémentaires. Pour plus de détails, consultez la documentation Redis keyspace notifications.

Important

La valeur doit contenir au moins K ou E ; sinon, aucune notification n'est envoyée.

Utilisez toute combinaison des caractères suivants :

  • K : Notifications keyspace (préfixées par __keyspace@<db>__).

  • E : Notifications key-event (préfixées par __keyevent@<db>__).

  • g : Commandes génériques telles que DEL, EXPIRE et RENAME.

  • $ : Commandes String.

  • l : Commandes List.

  • s : Commandes Set.

  • h : Commandes Hash.

  • z : Commandes Sorted set.

  • x : Événements d'expiration. Envoyés lorsqu'une clé expirée est supprimée.

  • e : Événements d'éviction. Envoyés lorsqu'une clé est supprimée par la politique d'éviction.

  • A : Alias pour g$lshzxe. Abonnement à tous les événements ci-dessus.

Exemple : Pour recevoir les événements d'expiration, définissez ce paramètre sur Ex, puis exécutez PSUBSCRIBE __keyevent@0__* sur le client pour vous abonner aux notifications key-event de la base de données 0.

Standard : Pris en charge

Cluster : Pris en charge

Lecture/écriture séparées : Pris en charge

Standard : Pris en charge

Cluster : Pris en charge

Lecture/écriture séparées : Pris en charge

Non

pena_rename_move_compatible_enabled

Active le mode compatible pour les commandes MOVE et RENAME. Contrairement à Redis natif (complexité O(1)), ces commandes présentent une complexité O(n) dans Tair. Les opérations sur de grandes clés peuvent donc prendre un temps considérable. Valeur par défaut : no.

  • no : Désactivé.

  • yes : Activé. Les commandes peuvent alors être utilisées avec la même syntaxe que dans Redis natif.

Remarque

Pris en charge uniquement sur les instances à mémoire persistante de version 1.2.4 ou ultérieure.

Non pris en charge

Standard : Pris en charge

Cluster : Pris en charge

Lecture/écriture séparées : Pris en charge

Non

set-max-intset-entries

Définit la taille maximale d'un ensemble Set utilisant l'encodage intset. Un ensemble Set utilise l'encodage intset lorsque tous ses membres sont des entiers en base 10 compris dans la plage des entiers signés 64 bits.

Standard : Pris en charge

Cluster : Pris en charge

Lecture/écriture séparées : Pris en charge

Standard : Pris en charge

Cluster : Pris en charge

Lecture/écriture séparées : Pris en charge

Non

slowlog-log-slower-than

Seuil de temps d'exécution pour l'enregistrement d'une commande dans le journal des requêtes lentes. Les commandes dont l'exécution dépasse cette valeur sont enregistrées. Unité : microsecondes. Valeurs valides : 10000 à 10000000. Valeur par défaut : 20000 (20 ms).

Standard : Pris en charge

Cluster : Pris en charge

Lecture/écriture séparées : Pris en charge

Standard : Pris en charge

Cluster : Pris en charge

Lecture/écriture séparées : Pris en charge

Non

slowlog-max-len

Nombre maximal d'entrées conservées dans le journal des requêtes lentes. Valeurs valides : 100 à 10000. Valeur par défaut : 1024.

Standard : Pris en charge

Cluster : Pris en charge

Lecture/écriture séparées : Pris en charge

Standard : Pris en charge

Cluster : Pris en charge

Lecture/écriture séparées : Pris en charge

Non

stream-node-max-bytes

Quantité maximale de mémoire qu'un seul nœud macro dans un flux Stream peut consommer. Unité : octets. Valeurs valides : 0 à 999999999999999. Valeur par défaut : 4096. Définissez la valeur sur 0 pour supprimer la limite.

Standard : Pris en charge

Cluster : Pris en charge

Lecture/écriture séparées : Pris en charge

Standard : Pris en charge

Cluster : Pris en charge

Lecture/écriture séparées : Pris en charge

Non

stream-node-max-entries

Nombre maximal d'entrées qu'un seul nœud macro dans un flux Stream peut stocker. Valeurs valides : 0 à 999999999999999. Valeur par défaut : 100. Définissez la valeur sur 0 pour supprimer la limite.

Standard : Pris en charge

Cluster : Pris en charge

Lecture/écriture séparées : Pris en charge

Standard : Pris en charge

Cluster : Pris en charge

Lecture/écriture séparées : Pris en charge

Non

timeout

Nombre de secondes d'inactivité avant que l'instance ne ferme une connexion client. Valeurs valides : 0 à 100000. Valeur par défaut : 0 (les connexions ne sont jamais fermées en raison de l'inactivité).

Standard : Pris en charge

Cluster : Pris en charge

Lecture/écriture séparées : Pris en charge

Standard : Pris en charge

Cluster : Pris en charge

Lecture/écriture séparées : Pris en charge

Non

zset-max-ziplist-entries

zset-max-ziplist-value

Pour les instances compatibles avec Redis 6.0 et versions antérieures, un ensemble trié utilise l'encodage ziplist lorsque les deux conditions suivantes sont remplies : le nombre de paires clé-valeur est inférieur à zset-max-ziplist-entries, et la longueur de chaîne de toutes les clés et valeurs est inférieure à zset-max-ziplist-value.

Standard : Pris en charge

Cluster : Pris en charge

Lecture/écriture séparées : Pris en charge

Standard : Pris en charge

Cluster : Pris en charge

Lecture/écriture séparées : Pris en charge

Non

zset-max-listpack-entries

zset-max-listpack-value

Pour les instances compatibles avec Redis 7.0 et versions ultérieures, un ensemble trié utilise l'encodage listpack lorsque les deux conditions suivantes sont remplies : le nombre de paires clé-valeur est inférieur à zset-max-listpack-entries, et la longueur de chaîne de toutes les clés et valeurs est inférieure à zset-max-listpack-value.

Standard : Pris en charge

Cluster : Pris en charge

Lecture/écriture séparées : Pris en charge

Non pris en charge

Non

Instances sur disque

Paramètre

Description

Sur disque

Takes effect upon restart

#no_loose_disabled-commands

Spécifie les commandes à désactiver. Utilisez ce paramètre pour bloquer les commandes à haut risque ou à forte latence, telles que FLUSHALL, FLUSHDB, KEYS, HGETALL, EVAL, EVALSHA et SCRIPT.

  • Saisissez les commandes en minuscules, séparées par des virgules.

  • La désactivation de FLUSHALL n'affecte pas la fonctionnalité Clear Data dans la console.

  • Certaines commandes, comme CONFIG, ne peuvent pas être désactivées. Consultez la section Commandes qui ne peuvent pas être désactivées.

Standard : Pris en charge

Cluster : Pris en charge

Non

#no_loose_lua-strict-mode

Active le mode strict pour les scripts Lua. Les clés de données doivent être transmises via le tableau KEYS et ne peuvent pas être générées dynamiquement. Cela permet le traitement parallèle multithread pour les scripts Lua. Valeur par défaut : no.

Standard : Pris en charge

Cluster : Pris en charge

Non

batch-scan-count

batch-scan-size

scan-background-interval-ms

Paramètres du processus d'interrogation des clés en arrière-plan, qui vérifie le TTL et effectue le garbage collection.

  • scan-background-interval-ms : L'intervalle d'interrogation. Unité : millisecondes. Valeur par défaut : 1000 (1 seconde).

  • batch-scan-count : Le nombre de clés interrogées par itération. Valeur par défaut : 20000.

  • batch-scan-size : La quantité maximale de données interrogées par itération. Unité : octets. Valeur par défaut : 2097152 (2 Mo).

La boucle d'interrogation se termine lorsque batch-scan-count ou batch-scan-size est atteint, puis attend le prochain intervalle.

Remarque

La diminution de scan-background-interval-ms augmente la fréquence du garbage collection, mais consomme également plus de bande passante disque. Évitez les modifications agressives qui pourraient affecter les performances des requêtes utilisateur.

Standard : Pris en charge

Cluster : Pris en charge

Non

bigkey-threshold

Le seuil du nombre d'éléments permettant d'identifier les grandes clés (clés comportant de nombreux éléments) dans Top Key Statistics. Valeurs valides : 500 à 100000. Valeur par défaut : 2000.

Remarque

Pris en charge uniquement sur les instances sur disque avec la version 2.6.0 ou ultérieure.

Standard : Pris en charge

Cluster : Pris en charge

Non

hotkey-threshold

Le seuil QPS permettant d'identifier les clés fréquentes dans Top Key Statistics. Valeurs valides : 100 à 100000. Valeur par défaut : 5000.

Remarque

Pris en charge uniquement sur les instances sur disque avec la version 2.6.0 ou ultérieure.

Standard : Pris en charge

Cluster : Pris en charge

Non

latency-monitor-threshold

Le seuil de durée pour l'enregistrement d'un événement de latence. Les événements dépassant ce seuil sont consignés. Unité : millisecondes. Valeurs valides : 0 à 10000000. Valeur par défaut : 100.

Standard : Pris en charge

Cluster : Pris en charge

Non

max-rename-commit-size

La quantité maximale de données (en octets) d'une clé que la commande RENAME peut traiter. Si les données réelles dépassent cette limite, l'opération échoue. Valeurs valides : 1024 à 268435456. Valeur par défaut : 16777216 (16 Mo).

Standard : Pris en charge

Cluster : Pris en charge

Non

max-write-batch-size

La limite de taille (en octets) pour les données intermédiaires en mémoire générées lors de l'exécution des commandes dans le format de stockage sur disque. Valeurs valides : 0 à 1073741824. Valeur par défaut : 0 (aucune limite).

Remarque

Si votre charge de travail est susceptible de produire de grandes quantités de données intermédiaires, définissez ce paramètre sur 1073741824 (1 Go) pour éviter les problèmes de mémoire insuffisante.

Standard : Pris en charge

Cluster : Pris en charge

Non

optimise-huge-value

Active l'optimisation des performances pour les grandes valeurs. Valeur par défaut : no.

  • no : Désactivé.

  • yes : Activé. Peut approximativement doubler les performances d'écriture pour les grandes valeurs, mais réduit l'efficacité des requêtes de plage (SCAN, HGETALL, ZRANGE) et provoque des fluctuations plus importantes de l'utilisation de la mémoire. Activez cette option uniquement lorsque la taille moyenne des valeurs dépasse 16 Ko et que le débit d'écriture est élevé.

Remarque

Pris en charge uniquement sur les instances SSD sur disque avec la version 2.6.0 ou ultérieure.

Standard : Pris en charge

Cluster : Pris en charge

Non

slowlog-log-slower-than

Le seuil de temps d'exécution pour l'enregistrement d'une commande dans le journal des requêtes lentes. Unité : microsecondes. Valeurs valides : 10000 à 10000000. Valeur par défaut : 1000000.

Standard : Pris en charge

Cluster : Pris en charge

Non

slowlog-max-len

Le nombre maximal d'entrées conservées dans le journal des requêtes lentes. Valeurs valides : 100 à 10000. Valeur par défaut : 1024.

Standard : Pris en charge

Cluster : Pris en charge

Non

timeout

Le nombre de secondes d'inactivité avant que l'instance ne ferme une connexion client. Valeurs valides : 0 à 100000. Valeur par défaut : 0 (les connexions ne sont jamais fermées en raison de l'inactivité).

Standard : Pris en charge

Cluster : Pris en charge

Non

timeout_retry_to_slave_enabled

L'interrupteur pour la fonctionnalité de nouvelle tentative des requêtes anormales. Valeurs valides :

  • 0 (par défaut) : Désactive la fonctionnalité.

  • 1 : Active la fonctionnalité. Lorsqu'elle est activée, si une requête de lecture expire et atteint la valeur de timeout_ms_retry_to_slave, le proxy transfère automatiquement la requête de lecture vers un nœud secondaire pour garantir le taux de réussite des requêtes de lecture.

Standard : Non pris en charge

Cluster : Pris en charge

Lecture/écriture : Non pris en charge

Non

timeout_ms_retry_to_slave

La période d'expiration qui déclenche une nouvelle tentative de requête. Ce paramètre doit être utilisé conjointement avec timeout_retry_to_slave_enabled. Unité : millisecondes. Valeurs valides : 10 à 5000. Valeur par défaut : 500.

Standard : Non pris en charge

Cluster : Pris en charge

Lecture/écriture : Non pris en charge

Non

txn-isolation-lock

Active les verrous de transaction, qui permettent aux instances sur disque d'exécuter les commandes MULTI, EXEC et les scripts Lua. L'activation de ce paramètre peut entraîner une dégradation des performances allant jusqu'à 10 %. Valeur par défaut : no.

  • no : Désactivé.

  • yes : Activé. Ces commandes fonctionnent alors avec la même syntaxe que dans Redis natif.

Standard : Pris en charge

Cluster : Pris en charge

Non

Paramètres des nœuds proxy

Ces paramètres sont fournis par les nœuds proxy et s’appliquent uniquement aux instances utilisant une architecture en cluster en mode proxy ou une architecture de répartition lecture/écriture.

Parameter

Description

Takes effect upon restart

cluster_compat_enable

Contrôle la compatibilité avec la syntaxe native du cluster Redis. Valeur par défaut : 1.

  • 0 : Désactivé.

  • 1 : Activé. Lorsque cette option est activée, les commandes des classes READONLY, READWRITE et CLUSTER sont prises en charge. Pour plus de détails, consultez la rubrique List of commands supported in proxy mode.

Non

hello_enabled

Détermine si la commande HELLO permet de basculer entre les protocoles RESP2 et RESP3. Valeur par défaut : 0.

  • 0 : Désactivé.

  • 1 : Activé.

Remarque

Pris en charge uniquement sur la version 7.0.9 du Proxy et les versions ultérieures.

Non

max_session_processing

Nombre maximal de requêtes en cours de traitement par connexion. Valeurs valides : 10 à 10000000. Valeur par défaut : 1000.

Lorsqu’un nœud proxy transmet une requête à un nœud de données sans avoir encore reçu de réponse, cette requête est considérée comme étant en cours de traitement. Ce paramètre limite l’accumulation de requêtes due aux différences de vitesse de traitement entre le frontal et le dorsal du proxy, ce qui empêche une croissance excessive de la mémoire.

Non

#no_loose_statistics-ip-enable

#no_loose_statistics-cmds

#no_loose_statistics-keys

Groupe de paramètres dédié à la fonctionnalité d’observability. Après avoir défini ces paramètres, vous devez également activer le audit log pour qu’ils prennent effet. Les statistiques sont collectées par intervalles de 5 secondes.

  • #no_loose_statistics-ip-enable : Active les statistiques par adresse IP, qui enregistrent les adresses IP des connexions établies. Valeurs valides : yes (activer) et no (valeur par défaut, désactiver).

  • #no_loose_statistics-cmds : Commandes à suivre. Enregistre l’adresse IP source et la fréquence pour chaque commande suivie. Valeur par défaut : vide (aucune commande suivie). Séparez plusieurs commandes par des virgules.

  • #no_loose_statistics-keys : Clés à suivre. Enregistre l’adresse IP source et la fréquence pour chaque clé suivie. Valeur par défaut : vide (aucune clé suivie). Séparez plusieurs clés par des virgules.

Remarque
  • Seules les instances optimisées pour la mémoire prennent en charge ce groupe de paramètres.

  • Pour minimiser l’impact sur les performances, limitez le nombre de commandes et de clés suivies. N’activez cette fonctionnalité qu’à des fins de dépannage ou d’exploitation et de maintenance.

Pour récupérer les statistiques, téléchargez les journaux d’audit depuis la console Simple Log Service (consultez la rubrique Download audit logs) et filtrez selon les valeurs suivantes du champ type :

  • 7 : Statistiques QPS par adresse IP

  • 8 : Statistiques de connexion par adresse IP

  • 9 : Statistiques des clés

  • 10 : Statistiques des commandes

Non

ptod_enabled

Détermine si le proxy transmet l’adresse IP originale du client au nœud de données. Valeur par défaut : 1.

  • 0 : Désactivé. Le nœud de données voit les adresses IP des nœuds proxy au lieu des adresses IP des clients.

  • 1 : Transmission activée.

Non

query_cache_enabled

query_cache_expire

query_cache_mode

Paramètres de la fonctionnalité de cache de requêtes du nœud proxy. Lorsqu’elle est activée, le proxy met en cache les résultats des clés fréquemment utilisées (« hot keys ») et renvoie directement les réponses mises en cache sans transmettre les requêtes aux shards de données.

Important

Les données clé-valeur mises en cache ne sont pas actualisées pendant la période de validité du cache. Vérifiez que votre charge de travail peut tolérer la cohérence à terme avant d’activer cette fonctionnalité.

  • query_cache_enabled : Active la fonctionnalité. Valeur par défaut : 0 (désactivé). Définissez la valeur sur 1 pour l’activer.

  • query_cache_expire : Période de validité du cache. Unité : millisecondes. Valeurs valides : 100 à 60000. Valeur par défaut : 1000. Une valeur plus courte réduit le taux de succès du cache ; une valeur plus longue augmente la fenêtre durant laquelle les clients peuvent lire des données obsolètes.

  • query_cache_mode : Mode de fonctionnement.

    • 0 (valeur par défaut) : Met en cache uniquement les clés fréquemment utilisées poussées par les shards de données.

    • 1 : Met en cache toutes les clés en utilisant l’éviction LRU (Least Recently Used). Étant donné que chaque thread de proxy dispose d’une limite de cache de 100 Mo, l’éviction LRU peut réduire le taux de succès et les performances globales.

Non

read_request_only_ronode_whenrwsplit_enable

Détermine si les requêtes provenant de comptes en lecture seule sont transmises exclusivement aux réplicas de lecture. Valeur par défaut : 0.

  • 0 : Désactivé. Les requêtes provenant de comptes en lecture seule sont distribuées sur tous les nœuds (y compris le nœud principal) en fonction de leur poids.

  • 1 : Activé. Les requêtes provenant de comptes en lecture seule sont dirigées directement vers les réplicas de lecture et non vers le nœud principal.

Non

readonly_lua_route_ronode_enable

Contrôle le mode d’exécution Lua sur les réplicas de lecture. Valeur par défaut : 0.

  • 0 : Désactivé. Les commandes Lua sont traitées par le nœud principal.

  • 1 : Activé. Les scripts Lua contenant uniquement des opérations de lecture sont transmis aux réplicas de lecture.

Non

rt_threshold_ms

Seuil du journal des requêtes lentes pour le nœud proxy. Une entrée de journal est générée lorsque le délai entre l’envoi d’une requête par le proxy et la réception de la réponse dépasse cette valeur. Unité : millisecondes. Valeurs valides : 30 à 2000. Valeur par défaut : 500.

Non

script_check_enable

Détermine si le proxy vérifie les scripts Lua avant leur exécution. Pour la liste des vérifications, consultez la rubrique Proxy check items for Lua. Valeur par défaut : 1.

  • 0 : Vérifications désactivées. Notez que les vérifications de script sont toujours activées pour les comptes en lecture seule, indépendamment de ce paramètre.

  • 1 : Vérifications activées.

Non

sentinel_compat_enable

Active le mode compatible Sentinel pour le proxy. Valeur par défaut : 0.

  • 0 : Désactivé.

  • 1 : Activé.

Non

transfer_subscrible_to_psubscrible_enable

Détermine si le proxy convertit les commandes SUBSCRIBE en PSUBSCRIBE. Valeur par défaut : 0.

  • 0 : Désactivé.

  • 1 : Activé. Activez cette option si vous ne recevez pas de notifications sur un canal abonné parce que des scripts Lua utilisent des commandes de la classe PUB/SUB.

Non