Tous les produits
Search
Centre de documentation

PolarDB:Utiliser des modèles de paramètres

Dernière mise à jour :Aug 11, 2026

Si vous gérez plusieurs clusters PolarDB partageant les mêmes paramètres, utilisez des modèles de paramètres pour centraliser leur configuration. Cette approche simplifie la gestion des paramètres et accélère le déploiement des clusters.

Créer un modèle de paramètres

  1. Connectez-vous à la console PolarDB. Sélectionnez la région du cluster. Dans le volet de navigation de gauche, choisissez Parameter Templates.

  2. Dans l'onglet Custom Parameter Templates, cliquez sur Create Parameter Template. Configurez les paramètres suivants, puis cliquez sur OK.

    Paramètre

    Description

    Nom du modèle

    Le nom du modèle doit respecter les exigences suivantes :

    • Il ne peut contenir que des lettres, des chiffres et des traits de soulignement (_), et doit commencer par une lettre. Les caractères chinois ne sont pas autorisés.

    • Sa longueur doit être comprise entre 8 et 64 caractères.

    Moteur de base de données

    Sélectionnez un moteur de base de données. Valeurs valides : MySQL, ou .

    Version de la base de données

    Sélectionnez une version du moteur de base de données. Valeurs valides :

    • 8.0

    • 5.7

    • 5.6

    Description

    (Facultatif) Saisissez une description pour le modèle. La description peut comporter jusqu'à 200 caractères et être rédigée dans n'importe quelle langue.

    Ajouter un paramètre

    Cliquez sur Add Parameter pour ajouter une ligne de paramètre. Sélectionnez un Parameter Name, puis définissez la Current Value en vous référant aux colonnes Description et Valid Value. Vous pouvez également consulter d'autres informations, telles que la nécessité de redémarrer le cluster et la valeur par défaut du paramètre.

    Remarque
    • Pour configurer un autre paramètre, cliquez à nouveau sur Add Parameter.

    • Pour supprimer un paramètre, cliquez sur Delete à droite du paramètre concerné.

    Importer un paramètre

    Cliquez sur Import Parameter et saisissez les paramètres ainsi que leurs valeurs. Respectez le format key=value et inscrivez chaque paire clé-valeur sur une nouvelle ligne. Exemple :

    wait_timeout=60
        thread_stack=262144

Appliquer un modèle de paramètres

Une fois le modèle de paramètres créé, vous pouvez l'appliquer aux clusters selon l'une des deux méthodes suivantes :

  • Appliquez le modèle depuis la page de détails du cluster : pour le cluster PolarDB cible, accédez à Settings and Management > Parameters et cliquez sur Apply Template. Pour plus d'informations, consultez Appliquer un modèle.

  • Pour appliquer directement le modèle au cluster, suivez les étapes ci-dessous.

Remarque

Si un modèle contient des paramètres nécessitant le redémarrage du cluster pour prendre effet, appliquez-le pendant les heures creuses et assurez-vous que votre application dispose d'un mécanisme de reconnexion.

  1. Connectez-vous à la console PolarDB. Sélectionnez la région du cluster. Dans le volet de navigation de gauche, choisissez Parameter Templates.

  2. Dans l'onglet Custom Parameter Templates, localisez le modèle souhaité et cliquez sur Apply to Cluster dans la colonne Actions.

  3. Sur la page Apply to Cluster, sélectionnez les clusters cibles. Cliquez sur l'icône 移动 pour les ajouter à la liste sélectionnée. Vérifiez les différences entre les valeurs des paramètres du modèle et celles des clusters dans la section Parameter comparison. Après avoir confirmé les modifications, cliquez sur OK.

    Remarque

    Lorsque vous appliquez un modèle de paramètres à plusieurs clusters, tenez compte des points suivants :

    • Assurez-vous que les paramètres conviennent à tous les clusters sélectionnés. Procédez avec prudence.

    • Un modèle de paramètres peut être appliqué à 10 clusters maximum simultanément. Pour dépasser cette limite, effectuez l'opération par lots.

    • L'application d'un modèle est restreinte aux clusters situés dans la même région. Si vos clusters se trouvent dans une région différente, créez d'abord le modèle dans cette région avant de l'appliquer.

Cloner un modèle de paramètres

  1. Connectez-vous à la console PolarDB. Sélectionnez la région du cluster. Dans le volet de navigation de gauche, choisissez Parameter Templates.

  2. Dans l'onglet Custom Parameter Templates, localisez le modèle souhaité et cliquez sur Clone dans la colonne Actions. Configurez les paramètres suivants, puis cliquez sur OK.

    Paramètre

    Description

    Nom du modèle

    Le nom du modèle doit respecter les exigences suivantes :

    • Il ne peut contenir que des lettres, des chiffres et des traits de soulignement (_), et doit commencer par une lettre. Les caractères chinois ne sont pas autorisés.

    • Sa longueur doit être comprise entre 8 et 64 caractères.

    Moteur de base de données

    Sélectionnez un moteur de base de données. Valeurs valides : MySQL, ou .

    Version de la base de données

    Sélectionnez une version du moteur de base de données. Valeurs valides :

    • 8.0

    • 5.7

    • 5.6

    Description

    (Facultatif) Saisissez une description pour le modèle. La description peut comporter jusqu'à 200 caractères et être rédigée dans n'importe quelle langue.

    Ajouter un paramètre

    Cliquez sur Add Parameter pour ajouter une ligne de paramètre. Sélectionnez un Parameter Name, puis définissez la Current Value en vous référant aux colonnes Description et Valid Value. Vous pouvez également consulter d'autres informations, telles que la nécessité de redémarrer le cluster et la valeur par défaut du paramètre.

    Remarque
    • Pour configurer un autre paramètre, cliquez à nouveau sur Add Parameter.

    • Pour supprimer un paramètre, cliquez sur Delete à droite du paramètre concerné.

    Importer un paramètre

    Cliquez sur Import Parameter et saisissez les paramètres ainsi que leurs valeurs. Respectez le format key=value et inscrivez chaque paire clé-valeur sur une nouvelle ligne. Exemple :

    wait_timeout=60
        thread_stack=262144

Supprimer un modèle de paramètres

  1. Connectez-vous à la console PolarDB. Sélectionnez la région du cluster. Dans le volet de navigation de gauche, choisissez Parameter Templates.

  2. Dans l'onglet Custom Parameter Templates, localisez le modèle souhaité et cliquez sur Delete dans la colonne Actions.

Remarque

Pour supprimer plusieurs modèles de paramètres simultanément, sélectionnez-les et cliquez sur Batch Delete.

Comparer des modèles de paramètres

  1. Connectez-vous à la console PolarDB. Sélectionnez la région du cluster. Dans le volet de navigation de gauche, choisissez Parameter Templates.

  2. Dans l'onglet Custom Parameter Templates, sélectionnez les modèles de paramètres à comparer et cliquez sur Compare sous la liste.

  3. La boîte de dialogue Compare s'ouvre automatiquement sur la page Compare. Elle affiche un tableau des paramètres présentant des valeurs différentes, lesquelles sont mises en évidence en rouge. Par exemple, les valeurs du paramètre wait_timeout peuvent varier selon les modèles (86400, 43200 ou 172800).

Référence API

API

Description

CreateParameterGroup

Crée un groupe de paramètres.

DescribeParameterGroups

Récupère la liste des groupes de paramètres.

DescribeParameterGroup

Récupère les détails d'un groupe de paramètres.

ModifyDBClusterParameters

Modifie les paramètres du cluster ou applique un groupe de paramètres.

DeleteParameterGroup

Supprime un groupe de paramètres.