Modification de la configuration de Redis
IBM Cloud® Databases for Redis vous permet de modifier certains paramètres de configuration de Redis et ainsi d'ajuster vos bases de données à votre cas d'utilisation. Dans une configuration Redis typique, vous pouvez modifier la configuration
à partir de la ligne de commande en utilisant 'CONFIG SET
. Vous pouvez toujours utiliser la commande CONFIG SET
sur votre déploiement,
mais les modifications ne seront pas conservées si un basculement, un redémarrage de noeud ou un autre événement se produit sur votre déploiement. La modification de la configuration à l'aide de la commande CONFIG SET
peut être
effectuée à des fins de test, d'évaluation et de réglage.
Notez les restrictions suivantes concernant la configuration de Redis:
- Redis 4 : '
CONFIG
et toutes les sous-commandes sont obsolètes et ne fonctionneront plus à partir du 30 novembre 2021 - Redis 5 : aucune restriction
- Redis 6 (et versions ultérieures) : seuls
CONFIG GET
etCONFIG RESETSTAT
sont exposés
Pour apporter des modifications permanentes à la configuration de la base de données, utilisez le " Cloud Databases, le " Plug-in CLI ou le " API pour écrire les modifications dans le fichier de configuration de votre déploiement.
Pour effectuer une modification, vous envoyez un objet JSON avec les paramètres que vous souhaitez modifier et leurs nouvelles valeurs. Par exemple, pour définir le paramètre " maxmemory-policy
, vous devez fournir les informations
suivantes à l'interface de programmation ou à l'API.
{"configuration":{"maxmemory-policy":"allkeys-lru"}}
Utilisation de l'interface de ligne de commande
Affichez le schéma de configuration des paramètres possibles via le cli-plugin Cloud Databases à l'aide de la commande 'cdb deployment-configuration-schema
ibmcloud cdb deployment-configuration-schema <INSTANCE_NAME_OR_CRN>
Pour modifier votre configuration, utilisez la commande 'cdb deployment-configuration
.
ibmcloud cdb deployment-configuration <INSTANCE_NAME_OR_CRN> [@JSON_FILE | JSON_STRING]
La commande lit les modifications que vous souhaitez effectuer à partir de l'objet JSON ou d'un fichier.
Utilisation de l'API
Il existe deux noeuds finaux de configuration de déploiement, l'un permet d'afficher le schéma de configuration et l'autre permet de modifier la configuration. Pour afficher le schéma de configuration, envoyez une demande GET
à
/deployments/{id}/configuration/schema
.
Pour modifier la configuration, envoyez les paramètres que vous souhaitez modifier sous la forme d'un objet JSON dans le corps d'une demande PATCH
vers /deployments/{id}/configuration
.
Pour plus d'informations, voir la documentation de référence de l'API.
Paramètres de configuration disponibles
Pour vérifier la valeur actuelle d'un paramètre, utilisez 'CONFIG GET
à partir d'un client CLI. Vous pouvez vérifier tous les paramètres à l'aide de la commande CONFIG GET *
.
Un grand nombre de paramètres sont utilisés pour configurer Redis en tant que cache. Pour plus d'informations, voir la page Configuration de Redis en tant que cache.
Paramètre | Valeur par défaut | Remarques |
---|---|---|
maxmemory |
80 % de la mémoire de votre déploiement | Détermine la quantité de données que vous pouvez stocker dans Redis. |
appendonly |
yes |
Active ou désactive la persistance Redis. |
maxmemory-policy |
noeviction |
Détermine le comportement d'expulsion lorsque la limite maxmemory est atteinte. |
maxmemory-samples |
5 |
Règle l'algorithme d'expulsion LRU lorsque Redis est configuré en tant que cache. |
stop-writes-on-bgsave-error |
yes |
Redis arrête d'accepter des écritures s'il détecte un instantané de sauvegarde ayant échoué. |