Paramètres avancés des Public Cloud Databases pour MySQL
Ce guide liste tous les paramètres avancés pris en charge qui vous permettent de configurer votre service Public Cloud Databases pour MySQL selon vos cas d'usage
Objectif
Ce guide liste tous les paramètres avancés pris en charge qui vous permettent de configurer votre service Public Cloud Databases pour MySQL selon vos cas d'usage.
Prérequis
- Un projet Public Cloud dans votre compte OVHcloud.
- Une base de données fonctionnant sur votre service Public Cloud Databases OVHcloud (ce guide peut vous aider à répondre à ce prérequis).
En pratique
Les paramètres avancés peuvent également être gérés avec Terraform, via l'argument advanced_configuration (paires clé/valeur) de la ressource ovh_cloud_project_database.
Depuis la console OVHcloud
Veuillez consulter ce guide pour savoir comment modifier vos paramètres avancés depuis la console OVHcloud.
Depuis l'API
Veuillez consulter ce guide pour savoir comment modifier vos paramètres avancés depuis l'API OVHcloud.
Paramètres avancés pour MySQL
Voici les paramètres avancés disponibles pour un service MySQL :
Le tableau ci-dessous liste les paramètres avancés disponibles pour un service MySQL. Votre service affiche la liste exacte, avec les valeurs autorisées, dans l'onglet Configuration de la console OVHcloud et via l'API.
mysql.lower_case_table_names ne peut être défini qu'à la création du service.
| Parameters |
|---|
binlog_retention_period longmin: 600 max: 9007199254740991Attention : réduire cette valeur peut rendre un grand nombre de journaux binaires éligibles à la purge en une seule fois. Selon le volume, cela peut parfois bloquer le processus de commit de MySQL et empêcher les écritures jusqu'à la fin de la purge. Par précaution, privilégiez une diminution progressive de la valeur, par petits paliers et pendant une période de faible trafic, plutôt qu'une baisse brutale en une seule étape. |
mysql.automatic_sp_privileges booleanLorsque cette option est activée, le serveur accorde automatiquement les privilèges EXECUTE et ALTER ROUTINE au créateur d'une routine stockée, et les révoque lorsque la routine est supprimée. |
mysql.connect_timeout longmin: 2 max: 3600Le nombre de secondes pendant lesquelles le serveur mysqld attend un paquet de connexion avant de répondre par Bad handshake. |
mysql.default_time_zone stringFuseau horaire par défaut du serveur, exprimé sous forme de décalage par rapport à UTC (de -12:00 à +12:00), d'un nom de fuseau horaire, ou de 'SYSTEM' pour utiliser le fuseau horaire par défaut du serveur MySQL. |
mysql.div_precision_increment longmin: 0 max: 30Nombre de chiffres ajoutés à l'échelle du résultat des divisions effectuées avec l'opérateur /. La valeur par défaut est 4. |
mysql.end_markers_in_json booleanIndique si la sortie JSON de l'optimiseur, comme EXPLAIN FORMAT=JSON, ajoute des marqueurs de fin qui répètent la clé d'une structure près de son accolade fermante, ce qui facilite la lecture des structures JSON volumineuses. |
mysql.eq_range_index_dive_limit longmin: 0 max: 4294967295Le nombre de plages d'égalité dans une requête à partir duquel l'optimiseur passe des index dives aux statistiques d'index pour estimer le nombre de lignes concernées. 0 signifie que les index dives sont toujours utilisés. La valeur par défaut est 200. |
mysql.group_concat_max_len longmin: 4 max: 18446744073709552000La longueur maximale autorisée, en octets, pour le résultat de la fonction GROUP_CONCAT(). |
mysql.information_schema_stats_expiry longmin: 900 max: 31536000Le délai, en secondes, avant l'expiration des statistiques mises en cache. |
mysql.innodb_adaptive_hash_index booleanIndique si l'indexation par hachage adaptatif d'InnoDB est activée. Le réglage optimal dépend de la charge de travail : l'indexation par hachage adaptatif accélère les recherches pour certaines charges, mais son verrou interne peut devenir un point de contention en cas de forte concurrence ; la désactiver peut alors améliorer le débit. |
mysql.innodb_change_buffer_max_size longmin: 0 max: 50Taille maximale du buffer de modification InnoDB, exprimée en pourcentage de la taille totale du pool de buffers. La valeur par défaut est 25. |
mysql.innodb_flush_neighbors longmin: 0 max: 2Indique si le vidage d'une page du pool de buffers InnoDB entraîne également le vidage d'autres pages modifiées dans le même extent (la valeur par défaut est 1) : 0 - les pages modifiées du même extent ne sont pas vidées, 1 - vide les pages modifiées contiguës du même extent, 2 - vide les pages modifiées du même extent. |
mysql.innodb_ft_enable_stopword booleanIndique si le traitement des mots vides (stopwords) est appliqué lors de la création ou de la reconstruction d'un index FULLTEXT InnoDB. Activé par défaut. |
mysql.innodb_ft_max_token_size longmin: 10 max: 84Longueur maximale des mots stockés dans un index FULLTEXT InnoDB. |
mysql.innodb_ft_min_token_size longmin: 0 max: 16Longueur minimale des mots stockés dans un index FULLTEXT InnoDB. La modification de ce paramètre entraînera un redémarrage du service MySQL. |
mysql.innodb_ft_num_word_optimize longmin: 1000 max: 10000Nombre de mots traités lors de chaque opération OPTIMIZE TABLE sur un index FULLTEXT InnoDB. La valeur par défaut est 2000. |
mysql.innodb_ft_result_cache_limit longmin: 1000000 max: 4294967295Mémoire maximale, en octets, utilisée par requête pour le cache de résultats des recherches FULLTEXT InnoDB. Cette limite est fixée automatiquement en fonction de la mémoire de votre offre ; définir une valeur remplace la valeur par défaut calculée. |
mysql.innodb_ft_server_stopword_table stringCette option permet de spécifier votre propre liste de mots vides (stopwords) pour l'index FULLTEXT InnoDB, pour toutes les tables InnoDB. |
mysql.innodb_ft_user_stopword_table stringCette option permet de spécifier votre propre liste de mots vides (stopwords) pour l'index FULLTEXT InnoDB, pour des tables InnoDB spécifiques. |
mysql.innodb_io_capacity longmin: 100 max: 4294967295Le nombre d'opérations d'E/S par seconde (IOPS) disponibles pour les tâches d'arrière-plan d'InnoDB, comme le vidage des pages du pool de buffers et la fusion des données du buffer de modification. Définissez une valeur adaptée au stockage sous-jacent ; elle ne doit pas dépasser innodb_io_capacity_max. |
mysql.innodb_io_capacity_max longmin: 100 max: 4294967295Le nombre maximal d'opérations d'E/S par seconde (IOPS) que les tâches d'arrière-plan d'InnoDB peuvent effectuer lorsque le vidage prend du retard. La valeur par défaut est le double de innodb_io_capacity (2000 au minimum). Cette valeur doit être supérieure ou égale à innodb_io_capacity. |
mysql.innodb_lock_wait_timeout longmin: 1 max: 3600La durée, en secondes, pendant laquelle une transaction InnoDB attend un verrou de ligne avant d'abandonner. La valeur par défaut est 120. |
mysql.innodb_log_buffer_size longmin: 1048576 max: 4294967296La taille en octets du buffer qu'InnoDB utilise pour écrire dans les fichiers de log sur le disque. Les valeurs supérieures à 15 % de la RAM fournie par votre offre sont refusées, car un buffer plus grand laisse moins de mémoire pour le pool de buffers et les connexions clientes. |
mysql.innodb_max_dirty_pages_pct doublemin: 5 max: 99Pourcentage de pages modifiées dans le pool de buffers InnoDB à partir duquel InnoDB commence un vidage intensif. Réduire cette valeur répartit plus uniformément les E/S d'écriture et raccourcit la reprise après incident, au prix du vidage de pages qui auraient pu être modifiées à nouveau. Doit rester supérieur ou égal à innodb_max_dirty_pages_pct_lwm. La valeur par défaut est 90. |
mysql.innodb_max_dirty_pages_pct_lwm doublemin: 0 max: 99Pourcentage de pages modifiées dans le pool de buffers InnoDB à partir duquel InnoDB commence un pré-vidage, afin d'éviter que le taux de pages modifiées n'atteigne innodb_max_dirty_pages_pct. 0 désactive le pré-vidage. Ne peut pas être supérieur à innodb_max_dirty_pages_pct. La valeur par défaut est 10. |
mysql.innodb_max_purge_lag longmin: 0 max: 4294967295Retard maximal, en nombre de transactions en attente, que l'opération de purge InnoDB peut accumuler avant que les INSERT, UPDATE et DELETE ne soient ralentis pour lui permettre de rattraper ce retard. Le délai s'applique par ligne et augmente avec le retard ; il est plafonné par innodb_max_purge_lag_delay, qui doit également être défini pour que cette option ait un effet. La valeur par défaut est 0, ce qui n'entraîne jamais aucun délai. |
mysql.innodb_max_purge_lag_delay longmin: 0 max: 10000000Plafond, en microsecondes, du délai par ligne que innodb_max_purge_lag applique aux INSERT, UPDATE et DELETE. MySQL limite systématiquement le délai à cette valeur : tant qu'elle vaut 0, aucun délai n'est appliqué et innodb_max_purge_lag seul n'a aucun effet. Les deux options doivent être différentes de zéro pour que l'une ou l'autre prenne effet. La valeur par défaut est 0. |
mysql.innodb_online_alter_log_max_size longmin: 65536 max: 1099511627776La limite supérieure, en octets, de la taille des fichiers de log temporaires utilisés lors des opérations DDL en ligne sur les tables InnoDB. |
mysql.innodb_optimize_fulltext_only booleanLorsque cette option est activée, OPTIMIZE TABLE sur les tables InnoDB met uniquement à jour l'index FULLTEXT au lieu de reconstruire la table. Elle est destinée à être activée temporairement pendant la maintenance des index FULLTEXT, puis désactivée ; tant qu'elle est activée, OPTIMIZE TABLE ne récupère pas l'espace de la table. |
mysql.innodb_print_all_deadlocks booleanLorsque cette option est activée, les informations relatives à tous les interblocages (deadlocks) dans les transactions utilisateur InnoDB sont enregistrées dans le journal d'erreurs. Désactivé par défaut. |
mysql.innodb_read_io_threads longmin: 1 max: 64Le nombre de threads d'E/S pour les opérations de lecture dans InnoDB. La valeur par défaut est 4. La modification de ce paramètre entraînera un redémarrage du service MySQL. |
mysql.innodb_rollback_on_timeout booleanLorsque cette option est activée, un dépassement de délai de transaction entraîne l'abandon et l'annulation complète de la transaction par InnoDB. La modification de ce paramètre entraînera un redémarrage du service MySQL. |
mysql.innodb_thread_concurrency longmin: 0 max: 1000Définit le nombre maximal de threads autorisés dans InnoDB. La valeur par défaut est 0 (concurrence infinie - aucune limite). |
mysql.innodb_write_io_threads longmin: 1 max: 64Le nombre de threads d'E/S pour les opérations d'écriture dans InnoDB. La valeur par défaut est 4. La modification de ce paramètre entraînera un redémarrage du service MySQL. |
mysql.interactive_timeout longmin: 30 max: 604800Le nombre de secondes pendant lesquelles le serveur attend une activité sur une connexion interactive avant de la fermer. |
mysql.internal_tmp_mem_storage_engine stringvalues: MEMORY, TempTableLe moteur de stockage pour les tables temporaires internes en mémoire. |
mysql.log_output stringvalues: NONE, TABLELa destination de sortie du journal des requêtes lentes lorsque slow_query_log est activé (ON). Pour stocker les requêtes lentes dans la table mysql.slow_log, choisissez TABLE. Pour désactiver les journaux de requêtes lentes, choisissez NONE. |
mysql.long_query_time doublemin: 0 max: 3600Les slow_query_logs fonctionnent pour les instructions SQL dont l'exécution prend plus de long_query_time secondes. |
mysql.lower_case_table_names longvalues: 0, 1Définit la manière dont les noms de tables et de bases de données sont stockés et comparés. 0 = sensible à la casse (par défaut), 1 = noms stockés en minuscules, comparaisons insensibles à la casse. Cette option ne peut être définie qu'à la création du service et ne peut pas être modifiée par la suite. Consultez la documentation MySQL sur la sensibilité à la casse des identifiants pour plus de détails. |
mysql.max_allowed_packet longmin: 102400 max: 1073741824Taille, en octets, du plus grand message pouvant être reçu par le serveur. La valeur par défaut est 67108864 (64M). Les instructions et les lignes dépassant cette taille sont rejetées avec une erreur de paquet trop volumineux (packet too large). |
mysql.max_connections longmin: 30 max: 100000Le nombre maximal de connexions clientes simultanées autorisées. Réduisez cette valeur pour réserver de la mémoire à d'autres usages. La valeur ne peut pas dépasser la limite fixée par votre offre. Passer à une offre supérieure n'augmente pas une valeur que vous avez définie explicitement : augmentez-la vous-même après le changement d'offre. |
mysql.max_execution_time longmin: 0 max: 4294967295Délai d'exécution maximal, en millisecondes, pour les instructions SELECT de premier niveau en lecture seule. 0 (la valeur par défaut) signifie qu'aucun délai n'est appliqué. |
mysql.max_heap_table_size longmin: 1048576 max: 1073741824Limite la taille des tables internes en mémoire. Définissez également tmp_table_size. La valeur par défaut est 16777216 (16M). |
mysql.max_seeks_for_key longmin: 1 max: 18446744073709552000Limite du nombre maximal supposé de recherches d'index pour trouver des lignes à partir d'une clé. Réduire cette valeur amène l'optimiseur à privilégier les recherches par index plutôt que les parcours de table complets. |
mysql.max_user_connections longmin: 0 max: 99990Le nombre maximal de connexions simultanées autorisées pour un même compte utilisateur. 0, la valeur par défaut, signifie qu'aucune limite n'est appliquée par compte. Toute autre valeur doit être inférieure d'au moins 10 à max_connections, afin que la supervision et vos propres sessions d'administration puissent toujours se connecter lorsqu'une application atteint sa propre limite. Les connexions de réplication et de gestion du service ne sont pas concernées, quelle que soit la valeur définie. |
mysql.net_buffer_length longmin: 1024 max: 1048576Tailles initiales du buffer de connexion et du buffer de résultat. La valeur par défaut est 16384 (16K). La modification de ce paramètre entraînera un redémarrage du service MySQL. |
mysql.net_read_timeout longmin: 1 max: 3600Le nombre de secondes à attendre pour recevoir davantage de données d'une connexion avant d'interrompre la lecture. |
mysql.net_write_timeout longmin: 1 max: 3600Le nombre de secondes à attendre pour qu'un bloc soit écrit sur une connexion avant d'interrompre l'écriture. |
mysql.optimizer_prune_level longmin: 0 max: 1Contrôle les heuristiques appliquées lors de l'optimisation des requêtes pour écarter de l'espace de recherche de l'optimiseur les plans partiels les moins prometteurs. 0 désactive les heuristiques (recherche exhaustive) ; 1 écarte les plans en fonction du nombre de lignes récupérées. |
mysql.optimizer_search_depth longmin: 0 max: 62Profondeur maximale de la recherche effectuée par l'optimiseur de requêtes lors du choix de l'ordre des jointures. Des valeurs élevées produisent de meilleurs plans pour les jointures portant sur de nombreuses tables, mais allongent la compilation ; 0 laisse l'optimiseur choisir la profondeur automatiquement. |
mysql.optimizer_switch stringListe, séparée par des virgules, d'affectations d'indicateurs de l'optimiseur sous la forme flag=on|off|default, ou la valeur unique default pour réinitialiser tous les indicateurs. Les indicateurs non listés conservent leur valeur actuelle. Contrôle des comportements de l'optimiseur de requêtes comme la fusion d'index (index merge), la jointure par hachage (hash join) et les stratégies de semi-jointure. |
mysql.performance_schema_events_statements_history_size longmin: 0 max: 1024Le nombre de lignes par thread dans la table events_statements_history. |
mysql.relay_log_space_limit longmin: 134217728 max: 18446744073709552000L'espace maximal, en octets, utilisé par l'ensemble des journaux de relais (relay logs) lors de la réplication depuis une source de migration externe. Lorsque cette limite est atteinte, le thread d'E/S de réplication cesse de récupérer les événements du relay log jusqu'à ce que le thread SQL ait rattrapé son retard. Augmentez cette valeur pour accorder davantage d'espace de relay log à une migration volumineuse, en vous assurant que le disque du service est dimensionné en conséquence. Ce paramètre s'applique uniquement au nœud qui réplique depuis la source externe ; les nœuds de secours utilisent toujours la valeur par défaut (la plus petite valeur entre 5 Gio et 30 % du disque du service), qui est également utilisée lorsque cette option n'est pas définie. |
mysql.slow_query_log booleanLe journal des requêtes lentes permet de capturer les requêtes lentes. Définir slow_query_log sur false vide également la table mysql.slow_log. |
mysql.sort_buffer_size longmin: 32768 max: 1073741824Taille du buffer de tri en octets pour l'optimisation ORDER BY. La valeur par défaut est 262144 (256K). Les valeurs supérieures à 2 % de la RAM fournie par votre offre sont refusées, car le buffer est alloué par session et son coût est multiplié par le nombre de connexions. |
mysql.sql_mode stringMode SQL global. Définissez une valeur vide pour utiliser les valeurs par défaut du serveur MySQL. Si ce champ n'est pas défini à la création d'un nouveau service, un mode SQL par défaut (strict, conforme au standard SQL) est attribué. |
mysql.sql_require_primary_key booleanExige la définition d'une clé primaire pour les nouvelles tables ou pour les anciennes tables modifiées avec ALTER TABLE, et échoue si elle est absente. Il est recommandé de toujours définir des clés primaires, car diverses fonctionnalités peuvent être compromises si une table volumineuse en est dépourvue. |
mysql.tmp_table_size longmin: 1048576 max: 1073741824Limite la taille des tables internes en mémoire. Définissez également max_heap_table_size. La valeur par défaut est 16777216 (16M). |
mysql.wait_timeout longmin: 1 max: 2147483Le nombre de secondes pendant lesquelles le serveur attend une activité sur une connexion non interactive avant de la fermer. Les valeurs inférieures à 30 sont refusées, car un délai plus court fermerait vos propres connexions inactives entre deux instructions. |
mysql.windowing_use_high_precision booleanIndique si les fonctions de fenêtrage sont calculées avec une haute précision. Désactiver cette option privilégie la vitesse au détriment de l'exactitude lors de l'évaluation des fonctions de fenêtrage. |
Aller plus loin
Rejoignez notre chaîne Discord dédiée : https://discord.gg/ovhcloud. Posez vos questions, faites-nous part de vos commentaires et interagissez directement avec l'équipe qui développe nos services de bases de données.
Pour une formation ou une assistance technique sur la mise en œuvre de nos solutions, contactez votre commercial ou consultez la page Professional Services pour obtenir un devis et faire analyser votre projet par nos experts.
Rejoignez notre communauté d'utilisateurs.