How to modify cluster and node parameters in the PolarDB console - PolarDB

Après la création d'un cluster PolarDB, vous pouvez utiliser la console pour modifier les paramètres du cluster et des nœuds, ainsi que pour exporter les paramètres du cluster sous forme de modèle. Vous pouvez également appliquer un modèle de paramètres afin de modifier rapidement ceux d'autres clusters situés dans la même région. Cette rubrique explique comment modifier des paramètres, les exporter en tant que modèle et appliquer un modèle existant.

Informations générales

Vous pouvez configurer les paramètres des nœuds PolarDB selon vos besoins métier.

Par défaut, les nouveaux nœuds ajoutés à un cluster utilisent les paramètres du cluster.
En cas de défaillance du nœud principal :
- L'ancien nœud principal devient un nœud en lecture seule et conserve ses paramètres inchangés.
- Un ancien nœud en lecture seule est promu au rang de nœud principal et conserve ses paramètres d'origine.
Si la zone principale tombe en panne, un nœud de la zone secondaire est promu nœud principal et adopte les paramètres du cluster.

Remarques sur l'utilisation

Pour garantir la compatibilité avec les fichiers de configuration MySQL, tous les paramètres de cluster dans la console PolarDB utilisent le préfixe loose_.

Ainsi, loose_rds_audit_log_event_buffer_size et rds_audit_log_event_buffer_size désignent le même paramètre.
Seuls certains paramètres ou valeurs de nœud sont modifiables. Consultez les options disponibles dans la console pour plus de détails.
Pour modifier un paramètre de nœud non accessible via la console, accédez au Quota Center. Repérez le quota nommé Set cluster and node parameters, cliquez sur Apply dans la colonne Actions, puis saisissez l'ID du cluster ainsi que les paramètres à modifier dans le champ Reason for Request.
Remarque
- À l'heure actuelle, seuls les paramètres suivants peuvent être modifiés :
  - PolarDB for MySQL 5,6 et 5,7 : le paramètre de nœud innodb_buffer_pool_size.
  - PolarDB for MySQL 8,0 : les paramètres de nœud innodb_buffer_pool_size, loose_oss_outfile_buffer_size, loose_max_oss_outfile_threads et loose_csv_oss_buff_size.
- Pour toute question ou pour modifier d'autres paramètres, contactez-nous.

Modifier les valeurs des paramètres

La modification des paramètres du cluster s'applique à tous ses nœuds, tandis que celle des paramètres de nœud ne concerne que le nœud spécifié. L'exemple suivant illustre la modification des paramètres au niveau du cluster.

Connectez-vous à la console PolarDB.
Dans le coin supérieur gauche, sélectionnez la région où le cluster est déployé.
Localisez le cluster cible et cliquez sur son ID.
Dans le volet de navigation de gauche, choisissez Settings and Management > Parameters.
Pour modifier les paramètres du cluster, sélectionnez Cluster dans la liste déroulante située dans le coin supérieur gauche.

Pour modifier les paramètres d'un nœud spécifique, sélectionnez ce nœud dans la liste déroulante.
Dans le coin supérieur gauche de la page, cliquez sur Modify Parameter.
Recherchez le paramètre concerné et saisissez une nouvelle valeur.
Remarque
- La valeur saisie doit respecter la plage indiquée dans la colonne Range to Be Modified. Dans le cas contraire, une erreur survient lors du clic sur Submit Changes.
- Cliquez sur l'icône en regard du nom d'un paramètre pour afficher ses détails.
- Pour des raisons de compatibilité, le préfixe loose_ est appliqué aux paramètres dans la console. Par exemple, loose_rds_audit_log_event_buffer_size et rds_audit_log_event_buffer_size correspondent au même paramètre.
Dans le coin supérieur gauche, cliquez sur Submit Changes.
Sur la page Save Changes, sélectionnez les nœuds à mettre à jour et cliquez sur OK.
Le tableau des modifications de paramètres dans la boîte de dialogue comprend les colonnes Parameter, New Value, Current Value, Default Value et Global Parameter. Vous pouvez ajuster rapidement les paramètres en cliquant sur Set All to Current Value ou Set All to Default Value. Lors de la modification d'un paramètre global, tous les nœuds sont sélectionnés par défaut.
Remarque
- Pour les paramètres dont la valeur Force Restart est définie sur Yes, vous devez redémarrer tous les nœuds du cluster pour appliquer les nouvelles valeurs. Planifiez cette interruption de service avec prudence avant de procéder au redémarrage.
- Si votre cluster PolarDB for MySQL est en version 8,0, activez le paramètre innodb_fast_startup (ON) afin d'accélérer le redémarrage.

Appliquer un modèle de paramètres

Une fois les paramètres configurés, vous pouvez effectuer les actions suivantes :

Exporter les paramètres du cluster sous forme de modèle.

Connectez-vous à la console PolarDB.
Dans le coin supérieur gauche de la console, sélectionnez la région où se trouve le cluster.
Localisez le cluster et cliquez sur son ID.
Dans le volet de navigation de gauche, cliquez sur Settings and Management > Parameters.
Cliquez sur Export as Template.
Remarque
- Pour modifier des paramètres dans la liste actuelle, effectuez d'abord les changements souhaités, puis cliquez sur Export as Template.
- Le modèle exporté contient à la fois les paramètres modifiés manuellement et ceux ajustés automatiquement par le cluster pendant son exécution.

Dans la boîte de dialogue Apply Template, configurez les paramètres suivants.

Parameter

Description

Template Name

Nom du modèle, qui doit respecter les exigences suivantes :

Il doit commencer par une lettre et ne contenir que des lettres, des chiffres et des traits de soulignement (_).
Sa longueur doit être comprise entre 8 et 64 caractères.

Description

Saisissez une description pour le modèle. Celle-ci peut comporter de 0 à 200 caractères.

Cliquez sur OK.

Appliquer un modèle de paramètres à un cluster.
1. Cliquez sur Apply Template.
2. Dans la boîte de dialogue Apply Template, sélectionnez le nom du modèle de paramètres à utiliser et cliquez sur OK.
  Remarque
  - Vous pouvez consulter le nombre de paramètres du modèle, la nécessité éventuelle d'un redémarrage ainsi que l'heure de mise à jour.
  - Si le modèle contient des paramètres exigeant un redémarrage du cluster, effectuez cette opération hors des heures de pointe et assurez-vous que votre application dispose d'un mécanisme de reconnexion.
  - Vous pouvez également appliquer un modèle de paramètres à un cluster depuis la page des modèles de paramètres. Pour plus d'informations, consultez Appliquer un modèle de paramètres.

Comparer les paramètres de nœud

La fonctionnalité Compare permet de comparer les configurations de paramètres entre différents nœuds.

Connectez-vous à la console PolarDB.
Dans le coin supérieur gauche, sélectionnez la région où le cluster est déployé.
Localisez le cluster cible et cliquez sur son ID.
Dans le volet de navigation de gauche, choisissez Settings and Management > Parameters.
Dans le coin supérieur gauche de la page, cliquez sur Compare.

Dans le panneau Compare, sélectionnez les nœuds à comparer (par exemple, primary node et read-only node).
Examinez les résultats de la comparaison, qui indiquent notamment le nombre de paramètres différents et si un redémarrage est requis.

Référence API

API

Description

DescribeDBClusterParameters

Interroge les paramètres d'un cluster.

ModifyDBClusterParameters

Modifie les paramètres d'un cluster.

ModifyDBClusterAndNodesParameters

Modifie les paramètres du cluster et applique les changements aux nœuds spécifiés.

ModifyDBNodesParameters

Modifie les paramètres d'un ou plusieurs nœuds spécifiés.

DescribeParameterTemplates

Interroge une liste de modèles de paramètres par défaut.