Tous les produits
Search
Centre de documentation

Tair (Redis® OSS-Compatible):Set an idle client connection timeout

Dernière mise à jour :Aug 08, 2026

Le paramètre timeout détermine la durée pendant laquelle Tair (compatible avec Redis OSS) maintient ouverte une connexion cliente inactive avant de la fermer et de libérer les ressources associées.

Par défaut, timeout vaut 0 : les connexions inactives ne sont jamais fermées. En production, cette configuration présente un risque. Si des exceptions côté client empêchent le nettoyage correct des connexions, celles-ci s'accumulent. Lorsque le pool de connexions est épuisé, les nouvelles requêtes échouent.

Définissez une valeur non nulle pour timeout sur les instances exécutant des charges de travail critiques afin que Tair puisse récupérer les connexions obsolètes avant l'épuisement du pool.

Fonctionnement du nettoyage des connexions inactives

Tair ne ferme pas immédiatement une connexion dès qu'elle atteint le seuil défini par timeout. Des tâches en arrière-plan analysent périodiquement les connexions inactives et les ferment. La fréquence de cette analyse dépend du paramètre hz.

Une valeur faible pour hz réduit la fréquence des analyses, ce qui introduit un délai entre le dépassement du délai d'expiration et la fermeture effective de la connexion. Par exemple, avec un timeout de 10 secondes, une connexion peut rester ouverte jusqu'à 12 secondes.

Pour réduire ce délai, augmentez la valeur de hz afin que les tâches en arrière-plan s'exécutent plus fréquemment.

Configurer le paramètre timeout

  1. Vérifiez que vous disposez d'une instance Tair (compatible avec Redis OSS) ou Redis Open-Source Edition, ainsi que des autorisations nécessaires pour modifier les paramètres de l'instance.

  2. Connectez-vous à la console et accédez à la page Instances. Dans la barre de navigation supérieure, sélectionnez la région où réside l'instance, repérez celle-ci, puis cliquez sur son ID.

  3. Dans le volet de navigation de gauche, cliquez sur Parameter Settings.

  4. Dans la liste des paramètres, recherchez le paramètre timeout et cliquez sur Modify dans la colonne Actions.

  5. Dans la boîte de dialogue, spécifiez une nouvelle valeur pour timeout.

    Property

    Description

    Valid range

    0–100000

    Unit

    Seconds

    Default

    0 (never close idle connections)

    Takes effect

    Immediately

  6. Cliquez sur OK.

Vérifier le résultat

La nouvelle valeur de timeout prend effet immédiatement après l'enregistrement de la modification. Confirmez la mise à jour en vérifiant la valeur actuelle sur la page Parameter Settings.

Référence API

API operation

Description

DescribeParameters

Interroger les paramètres de configuration et opérationnels d'une instance

ModifyInstanceConfig

Modifier les paramètres de configuration d'une instance