Modify parameter settings for an RDS for MySQL database - ApsaraDB RDS

Modifiez les paramètres et consultez l'historique des modifications de vos instances ApsaraDB RDS for MySQL via la console ou l'API. Afficher les paramètres de l'instance.

Notes d'utilisation

Pour garantir la stabilité de l'instance, seuls les paramètres disponibles dans la console sont modifiables. La commande set global n'est pas prise en charge.
Lorsque vous modifiez des paramètres, vérifiez la colonne Value Range sur la page Editable Parameters. Vous pouvez également utiliser des expressions pour adapter automatiquement les paramètres aux changements de configuration de l'instance.
Certains paramètres modifiés sur l'instance principale sont automatiquement synchronisés avec les instances en lecture seule. Annexe : Paramètres synchronisés.
Remarques concernant le paramètre lower_case_table_names :
- MySQL 5.7, 8,0 et 8,4 : vous devez spécifier la sensibilité à la casse des noms de table lors de la création de l'instance (valeur par défaut : 1, insensible à la casse). Ce paramètre ne peut pas être modifié après la création de l'instance et sa valeur reste inchangée après une mise à niveau.
- MySQL 5.6 :
  - Ce paramètre est modifiable après la création de l'instance, mais cela entraîne un redémarrage de celle-ci. Nous vous recommandons d'effectuer cette modification pendant les heures creuses.
  - Si vous souhaitez passer la valeur de 0 à 1, vous devez préalablement convertir les noms de table en majuscules de l'instance en minuscules. Sinon, les tables existantes en majuscules deviendront inaccessibles.
  - Les instances en lecture seule ne permettent pas de modifier ce paramètre. Modifiez-le sur l'instance principale ; la modification sera alors synchronisée avec les instances en lecture seule.

Important

La modification des paramètres peut nécessiter un redémarrage de l'instance ou une reconnexion. Effectuez ces opérations pendant les heures creuses et assurez-vous que votre application dispose d'un mécanisme de reconnexion automatique :

Certains paramètres nécessitent un redémarrage de l'instance pour prendre effet. Vérifiez la colonne Force Restart sur la page Editable Parameters. Un redémarrage provoque une interruption de connexion d'environ 15 secondes. Assurez-vous que votre application dispose d'un mécanisme de reconnexion automatique.
Les paramètres ne nécessitant pas de redémarrage prennent effet uniquement sur les nouvelles connexions. Les connexions existantes doivent être reconnectées.

Modifier les paramètres d'instance

Les paramètres modifiables varient selon la version du moteur MySQL. Liste des paramètres modifiables pour ApsaraDB RDS for MySQL.

Modifier les paramètres d'une instance unique

Accédez à la page Instances. Dans la barre de navigation supérieure, sélectionnez la région où réside l'instance RDS. Localisez ensuite l'instance RDS et cliquez sur son ID.
Dans le volet de navigation de gauche, cliquez sur Parameters.

Effectuez l'une des opérations suivantes :

Modifier un paramètre unique

Dans l'onglet Editable Parameters, localisez le paramètre à modifier et ajustez sa valeur selon le scénario :
- Cliquez sur l'icône dans la colonne Running Parameter Value et saisissez une valeur de paramètre en respectant la plage de valeurs suggérée.
- Dans la colonne Running Parameter Value, sélectionnez une valeur de paramètre dans la liste déroulante.
Cliquez sur OK.
Cliquez sur Apply Changes. Dans la boîte de dialogue qui s'affiche, sélectionnez une période d'application. Vous pouvez choisir Take Effect Immediately, Take Effect Within the Maintenance Window ou Take Effect at Specified Time.

Remarque
Dans l'onglet Scheduled Tasks for Parameter Modification, vous pouvez consulter les tâches de modification de paramètres pour lesquelles vous avez sélectionné Take Effect Within the Maintenance Window ou Take Effect at Specified Time.
(Facultatif) Pour annuler les modifications de paramètres avant leur soumission, cliquez sur Cancel Changes.

Appliquer et exporter des modèles

Appliquer un modèle de paramètres

ApsaraDB RDS propose des modèles de paramètres système adaptés à divers scénarios, tels que les hautes performances. Vous pouvez également créer des modèles personnalisés pour appliquer des configurations par lots. Utiliser un modèle de paramètres.

Cliquez sur Apply Template.
Sélectionnez le modèle de paramètres à appliquer, puis cliquez sur OK.
Remarque
- La boîte de dialogue affiche le nombre de paramètres concernés et indique si un redémarrage est nécessaire. Pour consulter les détails des modifications, cliquez sur View Parameter Change.
- Si le modèle de paramètres n'apparaît pas dans la liste, il se trouve peut-être dans une autre région. Copiez le modèle dans la région de l'instance. Utiliser un modèle de paramètres.

Exporter un modèle de paramètres

Cliquez sur Export as Template.

Configurez les paramètres suivants.

Parameter

Description

Template Name

Nom du modèle. De 8 à 64 caractères ; accepte les lettres, les chiffres, les points (.) et les traits de soulignement (_). Doit commencer par une lettre. Ne doit pas contenir de caractères chinois.

Description

Description du modèle. Jusqu'à 200 caractères.

Cliquez sur OK pour créer un nouveau modèle de paramètres dans la région.

Importer et exporter des paramètres

Pour modifier plusieurs paramètres simultanément ou sauvegarder la configuration actuelle, exportez un fichier TXT contenant toutes les valeurs de paramètres, modifiez-le localement, puis importez-le pour appliquer les changements.

Cliquez sur Export Parameters pour exporter le fichier de paramètres au format TXT.
Après avoir modifié le fichier, cliquez sur Import Parameters et collez le contenu du fichier dans la boîte de dialogue.
Cliquez sur OK.
Cliquez sur Apply Changes. Dans la boîte de dialogue qui s'affiche, sélectionnez le moment d'application des modifications. Vous pouvez choisir Take Effect Immediately, Take Effect Within the Maintenance Window ou Take Effect at Specified Time.

Remarque
Dans l'onglet Scheduled Tasks for Parameter Modification, vous pouvez consulter les tâches de modification de paramètres pour lesquelles vous avez sélectionné Take Effect Within the Maintenance Window ou Take Effect at Specified Time.
(Facultatif) Pour annuler les modifications de paramètres avant leur soumission, cliquez sur Cancel Changes.

Important
Si le message d'erreur Operation failed. The specified parameter format is invalid. s'affiche, vérifiez si la valeur du paramètre saisie respecte les Valid Values.

Modifier les paramètres de plusieurs instances

Connectez-vous à la console ApsaraDB RDS. Dans le volet de navigation de gauche, cliquez sur Instances. Dans la barre de navigation supérieure, sélectionnez la région où réside l'instance RDS.
Cochez les cases situées à gauche des instances cibles, puis cliquez sur Apply Changes en bas de la page.

Remarque
Les instances incluses dans une modification de paramètres par lot doivent partager la même version et la même série. Sinon, le bouton Modify Parameters est grisé et inaccessible.
Sur la page Parameters qui s'affiche, cliquez sur l'icône située à l'extrême droite du nom du paramètre à modifier.
Dans la zone value, sélectionnez ou saisissez une nouvelle valeur, puis cliquez sur OK.
Dans la fenêtre Parameters qui s'affiche, vérifiez l'exactitude des modifications, puis cliquez sur OK.

Consulter l'historique des modifications

Accédez à la page Instances. Dans la barre de navigation supérieure, sélectionnez la région où réside l'instance RDS. Localisez ensuite l'instance RDS et cliquez sur son ID.
Dans le volet de navigation de gauche, cliquez sur Parameters.
Cliquez sur l'onglet Edit History.
Sélectionnez la plage de dates, puis cliquez sur OK.

FAQ

Les modifications de paramètres prennent-elles effet immédiatement ? Un redémarrage de l'instance est-il nécessaire ?

Certaines modifications prennent effet en environ 5 minutes sans redémarrage. D'autres nécessitent un redémarrage. Consultez la page Editable Parameters et la colonne Force Restart pour confirmer avant de soumettre.

Pourquoi mes modifications de paramètres ne sont-elles pas appliquées ?

Les modifications de paramètres ne sont appliquées qu'après avoir cliqué sur Apply Changes.

Si une instance en lecture seule est de type Haute disponibilité et possède une instance principale et une instance secondaire, comment configurer les paramètres pour les deux ?

Configurez les paramètres uniquement sur l'instance principale de la paire en lecture seule. Les paramètres seront alors automatiquement synchronisés avec l'instance secondaire.

Je souhaite modifier le paramètre expire_logs_days ou binlog_expire_logs_seconds, mais je ne le trouve pas dans la console RDS. Que faire ?

Les paramètres expire_logs_days et binlog_expire_logs_seconds sont utilisés dans MySQL open source pour contrôler la durée de conservation du journal binaire local. Cependant, ApsaraDB RDS for MySQL n'utilise pas ces paramètres à cette fin. Pour modifier la durée de conservation du journal binaire d'une instance ApsaraDB RDS for MySQL, vous pouvez définir la politique de conservation du journal binaire dans la console RDS.

Remarque

Pour supprimer ou réduire les sauvegardes de journaux et de données d'une instance ApsaraDB RDS for MySQL, consultez Supprimer ou réduire les sauvegardes.

Comment modifier le paramètre lower_case_table_names ?

Pour plus d'informations, consultez Remarques sur le paramètre lower_case_table_names.

Lorsque j'utilise la commande set global pour modifier un paramètre, j'obtiens l'erreur suivante : Access denied; you need (at least one of) the SUPER or SYSTEM_VARIABLES_ADMIN privilege(s) for this operation. Que dois-je faire ?

ApsaraDB RDS for MySQL ne prend pas en charge la commande set global. Seuls les paramètres disponibles dans la console sont modifiables.

Comment modifier les paramètres collation_connection et collation_database ?

Vous ne pouvez pas modifier directement collation_connection ni collation_database. Configurez plutôt le paramètre init_connect dans la console RDS. Les valeurs prises en charge incluent 'set names utf8mb4', 'set names utf8', 'set default_collation_for_utf8mb4=utf8mb4_general_ci', 'set default_collation_for_utf8mb4=utf8mb4_general_ci;set names utf8mb4', 'set names utf8mb4 collate utf8mb4_general_ci' et 'set names utf8mb4 COLLATE utf8mb4_bin'.

Le système exécute cette commande à chaque nouvelle connexion, définissant ainsi le jeu de caractères et l'interclassement. Assurez-vous que votre application ne remplace pas l'interclassement de session, car les paramètres au niveau de la session ont la priorité.

Puis-je modifier le paramètre sql_log_bin ?

Non. ApsaraDB RDS for MySQL impose sql_log_bin pour toutes les sessions afin de garantir la persistance des journaux binaires, maintenant ainsi la cohérence des données pour la réplication.

Pourquoi la modification du paramètre **wait_timeout** ne prend-elle pas effet ?

Les modifications du paramètre wait_timeout s'appliquent uniquement aux nouvelles connexions. Les connexions existantes doivent être déconnectées puis reconnectées pour que la nouvelle valeur prenne effet.

Pourquoi la valeur de **wait_timeout** renvoyée par le client diffère-t-elle de celle définie dans la console ?

Par défaut, SHOW VARIABLES renvoie la valeur SESSION d'un paramètre, qui peut différer de la valeur GLOBAL. Dans les connexions interactives (comme le client en ligne de commande mysql), la valeur SESSION de wait_timeout est remplacée par la valeur d'initialisation de interactive_timeout. Par exemple, si vous définissez wait_timeout sur 86400 et que interactive_timeout reste à la valeur par défaut de 7200 dans la console, SHOW VARIABLES LIKE 'wait_timeout' dans une connexion interactive renverra 7200 au lieu de 86400. Exécutez SHOW GLOBAL VARIABLES LIKE 'wait_timeout' pour vérifier la valeur globale du paramètre et confirmer que le paramètre a pris effet.

Dans une instance RDS, pourquoi le paramètre **performance_schema est-il activé, mais aucun enregistrement n'est trouvé lors de l'interrogation de la table performance_schema.session_connect_attrs** ?

Définissez le paramètre loose_performance_schema_session_connect_attrs_size sur une valeur supérieure à 0 dans la console RDS.

Que faire si je reçois l'erreur **InvalidParameters.Prohibited lorsque je définis le paramètre performance_schema sur ON** ?

Le paramètre performance_schema n'accepte que les valeurs 0 et 1. Les valeurs telles que ON ou OFF ne sont pas prises en charge. Définissez le paramètre sur 1 pour l'activer, ou sur 0 pour le désactiver. Si vous recevez l'erreur InvalidParameters.Prohibited après avoir défini le paramètre sur ON, changez la valeur en 1 et soumettez à nouveau la modification.

Comment activer le paramètre show_ipk_info pour afficher les informations sur la clé primaire implicite ?

Certains paramètres ne peuvent pas être modifiés dans la console et ne prennent effet qu'au niveau de la session. show_ipk_info est l'un de ces paramètres. Il ne figure pas dans l'onglet Editable Parameters de la console et ne peut pas être défini au niveau global. Pour afficher la clé primaire implicite créée automatiquement par RDS pour une table, exécutez l'instruction suivante dans une session de base de données :

SET show_ipk_info=on;

Après avoir exécuté cette instruction, vous pouvez utiliser SHOW CREATE TABLE ou interroger la table information_schema.columns pour afficher la colonne de clé primaire implicite (__#alibaba_rds_row_id#__) créée automatiquement par RDS. Ce paramètre ne prend effet que pour la session actuelle. Vous devez exécuter à nouveau l'instruction dans chaque nouvelle session.

Annexe : Paramètres synchronisés

Les paramètres suivants sont automatiquement synchronisés de l'instance principale vers toutes les instances en lecture seule lors de leur modification.

lower_case_table_names

Remarque
Pour ApsaraDB RDS for MySQL 5.7, 8,0 et 8,4, la sensibilité à la casse des noms de table ne peut être spécifiée qu'à la création de l'instance, et le paramètre lower_case_table_names ne peut pas être modifié par la suite. Seul MySQL 5.6 permet de modifier ce paramètre sur l'instance principale, la modification étant alors synchronisée avec les instances en lecture seule.
innodb_large_prefix
loose_validate_password_length
default_time_zone
rpl_semi_sync_slave_enabled
character_set_server
collation_server

Référence API

API

Description

ModifyParameter

Modifie les paramètres d'une instance RDS.

DescribeParameterTemplates

Interroge les modèles de paramètres de base de données.

DescribeParameters

Interroge la configuration des paramètres d'une instance.