MariaDB (Français)
MariaDB est un serveur de base de donnĂ©es fiable, performant et complet qui se veut ĂȘtre un remplacement de MySQL "toujours libre, rĂ©trocompatible et prĂȘt Ă l'emploi". Depuis 2013, MariaDB est l'implĂ©mentation par dĂ©faut de MySQL sur Arch Linux. [1]
Installation
MariaDB est l'implémentation par défaut de MySQL dans Arch Linux, fournie par le paquet mariadb.
Installez mariadb, et exécutez la commande suivante avant de démarrer le mariadb.service :
# mariadb-install-db --user=mysql --basedir=/usr --datadir=/var/lib/mysql
/var/lib/mysql pour votre répertoire de données, vous devez définir datadir=YOUR_DATADIR dans la section [mysqld] de votre /etc/my.cnf.d/server.cnf.Maintenant, démarrez et/ou activez mariadb.service.
Pour simplifier l'administration, vous pouvez installer un front-end.
Configuration
Une fois que vous avez démarré le serveur MySQL et ajouté un compte root, vous pouvez souhaiter modifier la configuration par défaut.
Pour vous connecter en tant que root sur le serveur MySQL, utilisez la commande suivante :
# mysql -u root -p
Enter pour vous connecter.Ajouter un utilisateur
La création d'un nouvel utilisateur se fait en deux étapes : créer l'utilisateur ; accorder des privilÚges. Dans l'exemple ci-dessous, on crée l'utilisateur monty avec some_pass comme mot de passe, puis on lui accorde toutes les permissions sur la base de données mydb :
# mysql -u root -p
MariaDB> CREATE USER 'monty'@'localhost' IDENTIFIED BY 'some_pass'; MariaDB> GRANT ALL PRIVILEGES ON mydb.* TO 'monty'@'localhost'; MariaDB> FLUSH PRIVILEGES; MariaDB> quit
Fichiers de configuration
Les options de configuration de MariaDB sont lues dans les fichiers suivants dans l'ordre donné (selon la sortie mysqld --help --verbose | tail -20) :
/etc/my.cnf /etc/my.cnf.d/ ~/.my.cnf
En fonction de l'étendue des modifications que vous souhaitez effectuer (systÚme, utilisateur seulement...), utilisez le fichier correspondant. Consultez cette partie de la base de connaissances pour plus d'informations.
Activer l'autocomplétion
La fonction de complĂ©tion du client MySQL est dĂ©sactivĂ©e par dĂ©faut. Pour l'activer dans tout le systĂšme, Ă©ditez /etc/my.cnf.d/mysql-clients.cnf, et ajoutez auto-rehash sous mysql. Notez que cela ne doit pas ĂȘtre indiquĂ© dans mysqld. L'autocomplĂ©tion sera activĂ© la prochaine fois que vous exĂ©cuterez le client MySQL.
Utiliser UTF8MB4
- Le paquet mariadb utilise dĂ©jĂ
utf8mb4comme jeu de caractÚres etutf8mb4_unicode_cicomme collation. Les utilisateurs qui utilisent les paramÚtres par défaut (pour les caractÚres) peuvent vouloir sauter cette section. - UTF8MB4 est recommandé par rapport à UTF-8 car il permet une prise en charge Unicode complet [2] [3].
Ajoutez les valeurs suivantes au fichier de configuration principal situé à /etc/my.cnf.d/my.cnf :
[client] default-character-set = utf8mb4 [mysqld] collation_server = utf8mb4_unicode_ci character_set_server = utf8mb4 [mysql] default-character-set = utf8mb4
Redémarrez mariadb.service pour appliquer les changements.
Consultez #Maintenance pour optimiser et vérifier la santé de la base de données.
Augmenter la limite de caractĂšres
Pour InnoDB, exécutez les commandes suivantes pour prendre en charge une limite de caractÚres plus élevée :
mysql> set global innodb_file_format = BARRACUDA; Query OK, 0 rows affected (0.00 sec)
mysql> set global innodb_file_per_table = ON; Query OK, 0 rows affected (0.00 sec)
mysql> set global innodb_large_prefix = ON; Query OK, 0 rows affected (0.00 sec)
Ajoutez les lignes suivantes dans /etc/mysql/my.cnf pour toujours utiliser une limite de caractÚres plus élevée :
[mysqld] innodb_file_format = barracuda innodb_file_per_table = 1 innodb_large_prefix = 1
Redémarrez mariadb.service pour appliquer les changements.
Lors de la création de la table, ajoutez le ROW_FORMAT comme consulté dans l'exemple :
mysql> create table if not exists products ( -> day date not null, -> product_id int not null, -> dimension1 varchar(500) not null, -> dimension2 varchar(500) not null, -> unique index unique_index (day, product_id, dimension1, dimension2) -> ) ENGINE=InnoDB ROW_FORMAT=DYNAMIC; Query OK, 0 rows affected (0.02 sec)
Utiliser un tmpfs pour tmpdir
Le répertoire utilisé par MySQL pour stocker les fichiers temporaires est nommé tmpdir. Il est utilisé, par exemple, pour effectuer des tris importants sur disque, ainsi que pour les tables temporaires internes et explicites.
Créez le répertoire avec les permissions appropriées :
# mkdir -pv /var/lib/mysqltmp # chown mysql:mysql /var/lib/mysqltmp
Ajoutez le montage tmpfs suivant Ă votre fichier /etc/fstab :
tmpfs /var/lib/mysqltmp tmpfs rw,gid=mysql,uid=mysql,size=100M,mode=0750,noatime 0 0
Ajoutez Ă votre fichier /etc/my.cnf.d/server.cnf sous le groupe mysqld :
tmpdir = /var/lib/mysqltmp
Stoppez mariadb.service, montez /var/lib/mysqltmp/ et démarrez mariadb.service.
Tables de fuseaux horaires
Bien que les tables de fuseaux horaires soient créées pendant l'installation, elles ne sont pas automatiquement remplies. Elles doivent ĂȘtre remplies si vous prĂ©voyez d'utiliser CONVERT_TZ() dans des requĂȘtes SQL.
Pour remplir les tables de fuseaux horaires avec tous les fuseaux horaires :
$ mysql_tzinfo_to_sql /usr/share/zoneinfo | mysql -u root -p mysql
En option, vous pouvez remplir la table avec des fichiers de fuseaux horaires spécifiques :
$ mysql_tzinfo_to_sql fichier_de_fuseau_horaire nom_de_fuseau_horaire. | mysql -u root -p mysql
Sécurité
Améliorer la sécurité initiale
La commande mysql_secure_installation vous guidera de maniÚre interactive à travers un certain nombre de mesures de sécurité recommandées, comme la suppression des comptes anonymes et la suppression de la base de données de test :
# mysql_secure_installation
Ăcouter uniquement sur l'adresse de bouclage
Par défaut, MySQL écoutera sur l'adresse 0.0.0.0, qui inclut toutes les interfaces réseau. Afin de limiter l'écoute de MySQL à l'adresse de bouclage («loopback»), ajoutez la ligne suivante dans /etc/my.cnf.d/server.cnf :
[mysqld] bind-address = localhost
Cela permettra le lien Ă la fois vers 127.0.0.1 et ::1, et permettra Ă MariaDB de recevoir des connexions en IPv4 et en IPv6.
Restreindre l'accĂšs local uniquement via les sockets Unix
Par défaut, MySQL est accessible à la fois via les sockets Unix et le réseau. Si MySQL n'est nécessaire que pour l'hÎte local, vous pouvez améliorer la sécurité en n'écoutant pas le port TCP 3306, et en écoutant uniquement les sockets Unix à la place. Pour ce faire, ajoutez la ligne suivante dans /etc/my.cnf.d/server.cnf :
[mysqld] skip-networking
Vous pourrez toujours vous connecter localement comme avant, mais uniquement en utilisant les sockets Unix.
Accorder l'accĂšs Ă distance
Pour autoriser l'accÚs à distance au serveur MySQL, assurez-vous que MySQL a un accÚs réseau activé et est à l'écoute sur l'interface appropriée.
Accordez Ă n'importe quel utilisateur de MySQL un accĂšs distant (exemple pour root) :
# mysql -u root -p
Vérifiez les utilisateurs actuels ayant un accÚs à distance privilégié :
SELECT User, Host FROM mysql.user WHERE Host <> 'localhost';
Maintenant, accordez l'accĂšs Ă distance Ă votre utilisateur (ici root) :
GRANT ALL PRIVILEGES ON *.* TO 'root'@'192.168.1.%' IDENTIFIED BY 'my_optional_remote_password' WITH GRANT OPTION;
Vous pouvez remplacer le caractĂšre gĂ©nĂ©rique '%' par un hĂŽte spĂ©cifique si vous le souhaitez. Le mot de passe peut ĂȘtre diffĂ©rent du mot de passe principal de l'utilisateur.
Configurer l'accÚs aux répertoires personnels
Pour des raisons de sĂ©curitĂ©, le fichier de service systemd contient ProtectHome=true, qui empĂȘche MariaDB d'accĂ©der aux fichiers sous les hiĂ©rarchies /home, /root et /run/user. Le datadir doit ĂȘtre dans un emplacement accessible et appartenir Ă l'utilisateur et au groupe mysql.
Vous pouvez modifier ce comportement en créant un fichier de service supplémentaire comme décrit ici.
Maintenance
Mise à jour des bases de données lors des versions majeures
Lors de la sortie d'une version majeure de mariadb (par exemple mariadb-10.1.10-1 à mariadb-10.1.18-1), il est prudent de mettre à jour les bases de données :
# mysql_upgrade -u root -p
Pour mettre Ă jour de 10.1.x Ă 10.3.x. :
- garder le daemon de base de données 10.1.x en fonctionnement
- mettez Ă jour le paquet
- Exécutez
mysql_upgrade. (à partir de la nouvelle version du paquet) avec l'ancien daemon encore en fonctionnement. Cela produira quelques messages d'erreur ; cependant, la mise à jour réussira. - Redémarrez le daemon, afin que le daemon 10.3.x fonctionne.
Sinon, arrĂȘtez le (vieux) daemon, exĂ©cutez le (nouveau) daemon en mode sans Ă©chec, exĂ©cutez mysql_upgrade par rapport Ă celui-ci, puis dĂ©marrez le (nouveau) daemon comme dĂ©crit dans #Impossible d'exĂ©cuter mysql_upgrade car MySQL ne peut pas dĂ©marrer.
Vérification, optimisation et réparation des bases de données
mariadb est livrĂ© avec mysqlcheck qui peut ĂȘtre utilisĂ© pour vĂ©rifier, rĂ©parer et optimiser les tables des bases de donnĂ©es Ă partir du shell. Consultez la page de manuel mysqlcheck pour en savoir plus. Plusieurs tĂąches de commande sont prĂ©sentĂ©es :
Pour vérifier toutes les tables de toutes les bases de données :
$ mysqlcheck --all-databases -u root -p -c
Pour analyser toutes les tables de toutes les bases de données :
$ mysqlcheck --all-databases -u root -p -a
Pour réparer toutes les tables de toutes les bases de données :
$ mysqlcheck --all-databases -u root -p -r
Pour optimiser toutes les tables de toutes les bases de données :
$ mysqlcheck --all-databases -u root -p -o
Sauvegarde
Il existe plusieurs outils et stratĂ©gies[dead link 2025-08-15âHTTP 404] pour sauvegarder vos bases de donnĂ©es.
Si vous utilisez le moteur de stockage InnoDB par dĂ©faut, une façon suggĂ©rĂ©e[dead link 2025-08-15âHTTP 404] de sauvegarder toutes vos bases en ligne tout en prĂ©voyant une rĂ©cupĂ©ration ponctuelle (Ă©galement connue sous le nom de "roll-forward", lorsque vous devez restaurer une ancienne sauvegarde et rejouer les changements survenus depuis cette sauvegarde) consiste Ă exĂ©cuter la commande suivante :
$ mysqldump --single-transaction --flush-logs --master-data=2 --all-databases -u root -p > all_databases.sql
Cette commande vous demandera le mot de passe de l'utilisateur root de MariaDB, qui a été défini lors de la #Configuration de la base de données.
La spécification du mot de passe en ligne de commande est fortement déconseillée, car elle l'expose à la découverte par d'autres utilisateurs via l'utilisation de ps aux ou d'autres techniques. Au lieu de cela, la commande susmentionnée demandera le mot de passe de l'utilisateur spécifié, le dissimulant ainsi.
Compression
Comme les tables SQL peuvent ĂȘtre assez volumineuses, il est recommandĂ© d'acheminer la sortie de la commande susmentionnĂ©e dans un utilitaire de compression comme gzip :
$ mysqldump --single-transaction --flush-logs --master-data=2 --all-databases -u root -p | gzip > all_databases.sql.gz
Décompresser la sauvegarde ainsi créée et la recharger dans le serveur s'effectue en faisant :
$ zcat all_databases.sql.gz | mysql -u root -p
Ceci recréera et repeuplera toutes les bases de données précédemment sauvegardées (consultez ce lien ou celui-ci).
Non-interactif
Si vous souhaitez configurer un script de sauvegarde non interactif Ă utiliser dans des tĂąches cron ou des timers systemd, consultez option files et cette illustration pour mysqldump.
En gros, vous devez ajouter la section suivante au fichier de configuration concerné :
[mysqldump] user=mysqluser password=secret
Mentionner un utilisateur ici est facultatif, mais cela vous évitera d'avoir à le mentionner sur la ligne de commande. Si vous souhaitez définir cette option pour tous les outils, y compris mysql, utilisez le groupe [client].
Script d'exemple
La base de donnĂ©es peut ĂȘtre vidĂ©e dans un fichier pour faciliter la sauvegarde. Le script shell suivant le fera pour vous, en crĂ©ant un fichier db_backup.gz dans le mĂȘme rĂ©pertoire que le script, contenant votre vidage de base de donnĂ©es :
#!/bin/sh THISDIR=$(dirname $(readlink -f "$0")) mysqldump --single-transaction --flush-logs --master-data=2 --all-databases \ | gzip > $THISDIR/db_backup.gz echo 'purge master logs before date_sub(now(), interval 7 day);' | mysql
Consultez Ă©galement la page officielle mysqldump dans les manuels MySQL et MariaDB[dead link 2025-08-15âHTTP 404].
Holland Backup
Un logiciel basé sur python nommé Holland Backup est disponible dans AUR pour automatiser tout le travail de sauvegarde. Il prend en charge les méthodes suivantes : mysqldump direct, instantanés LVM vers des fichiers tar (mysqllvm), instantanés LVM avec mysqldump (mysqldump-lvm), et xtrabackup pour extraire les données. Le framework Holland prend en charge une multitude d'options et est hautement configurable pour répondre à presque toutes les situations de sauvegarde.
Les paquets principaux hollandAUR et holland-commonAUR fournissent le cadre de base ; l'un des sous-paquets (holland-mysqldumpAUR, holland-mysqllvmAUR et/ou holland-xtrabackupAUR doit ĂȘtre installĂ© pour un fonctionnement complet. Des exemples de configurations pour chaque mĂ©thode se trouvent dans le rĂ©pertoire /usr/share/doc/holland/examples/ et peuvent ĂȘtre copiĂ©s dans /etc/holland/backupsets/, ainsi qu'en utilisant la commande holland mk-config pour gĂ©nĂ©rer une configuration de base pour un fournisseur nommĂ©.
Dépannage
Impossible d'exécuter mysql_upgrade car MySQL ne peut pas démarrer
Essayez d'exécuter MySQL en mode sécurisé :
# mysqld_safe --datadir=/var/lib/mysql/
Et ensuite exécutez :
# mysql_upgrade -u root -p
Réinitialiser le mot de passe root
- ArrĂȘtez
mariadb.service. - Démarrez le serveur mysqld avec les fonctions de sécurité :
# mysqld_safe --skip-grant-tables --skip-networking &
- Connectez-vous au serveur :
# mysql -u root
- Changez le mot de passe root :
MariaDB [(none)]> use mysql MariaDB [mysql]> flush privileges; MariaDB [mysql]> ALTER USER 'root'@'localhost' IDENTIFIED BY 'new_password'; MariaDB [mysql]> exit
- Tuez les processus mysqld* en cours d'exécution :
# kill $(cat /var/lib/mysql/$HOSTNAME.pid)
- Démarrez
mariadb.service.
Vérifier et réparer toutes les tables
Vérifier et réparer automatiquement toutes les tables dans toutes les bases de données, consultez la suite :
# mysqlcheck -A --auto-repair -u root -p
Optimiser toutes les tables
Optimisez de force toutes les tables, en réparant automatiquement les erreurs de table qui peuvent survenir.
# mysqlcheck -A --auto-repair -f -o -u root -p
Erreur OS 22 lors de l'exécution sur ZFS
Si vous utilisez des bases de données MySQL sur ZFS, l'erreur InnoDB : Operating system error number 22 in a file operation peut se produire.
Une solution de contournement consiste à désactiver aio_writes dans /etc/my.cnf.d/my.cnf :
/etc/my.cnf.d/my.cnf
[mysqld] innodb_use_native_aio = 0
Impossible de se connecter via CLI, mais phpmyadmin fonctionne bien
Cela peut se produire si vous utilisez un mot de passe long (>70-75). En ce qui concerne la version 5.5.36, pour une raison quelconque, mysql CLI ne peut pas gérer un tel nombre de caractÚres en mode lecture. Donc, si vous envisagez d'utiliser le mode de saisie de mot de passe recommandé :
$ mysql -u user -p
Mot de passe :
Pensez Ă changer le mot de passe pour un plus petit.
$ mysql -u user -p "some-very-strong-password"
Les journaux binaires de MySQL prennent beaucoup d'espace disque
Par défaut, mysqld crée des fichiers journaux binaires dans /var/lib/mysql. Ceci est utile pour la réplication du serveur maßtre ou la récupération des données. Mais ces journaux binaires peuvent consommer votre espace disque. Si vous ne prévoyez pas d'utiliser les fonctionnalités de réplication ou de récupération de données, vous pouvez désactiver la journalisation binaire en commentant ces lignes dans /etc/mysql/my.cnf :
#log-bin=mysql-bin #binlog_format=mixed
Ou vous pouvez limiter la taille du fichier journal comme ceci :
expire_logs_days = 10 max_binlog_size = 100M
Vous pouvez également purger certains journaux binaires dans /var/lib/mysql pour libérer de l'espace disque avec cette commande :
# mysql -u root -p "PASSWORD" -e "PURGE BINARY LOGS TO 'mysql-bin.0000xx' ;"
OpenRC ne parvient pas Ă lancer MySQL
Pour utiliser MySQL avec OpenRC, vous devez ajouter les lignes suivantes à la section [mysqld] du fichier de configuration MySQL, situé à /etc/my.cnf.d/my.cnf.
user = mysql basedir = /usr datadir = /var/lib/mysql pid-file = /run/mysqld/mysql.pid
Vous devrez maintenant ĂȘtre capable de dĂ©marrer MySQL en utilisant :
# rc-service mysql start
La clé spécifiée était trop longue
Consultez #Augmenter la limite de caractĂšres.
Changement des limites d'avertissement sur max_open_files/table_open_cache
Augmentez le nombre de descripteurs de fichiers en créant un fichiers de substitution de systemd, par ex :
/etc/systemd/system/mysqld.service.d/limit_nofile.conf
[Service] LimitNOFILE=8192
Crash de la mise Ă jour de 10.4 vers 10.5 : "InnoDB: Upgrade after a crash is not supported. The redo log was created with MariaDB 10.4.x"
Avant MariaDB 10.5, le redo log Ă©tait inutilement divisĂ© en plusieurs fichiers. [7][dead link 2025-08-15âHTTP 404]
Déplacez les anciens journaux binaires /var/lib/mysql/ib_logfile* hors du chemin, laissant ainsi MariaDB 10.5 en créer de nouveaux. Puis redémarrez mariadb.service et mettez à jour vos tables avec mysql_upgrade.
La table 'mysql.xxx' n'existe pas dans le moteur
SymptÎme : Lorsque vous exécutez mysql_upgrade ou mysqlcheck, il retourne une ou plusieurs erreurs comme celles-ci :
Table 'mysql.xxx' doesn't exist in engine
OĂč "xxx" est gĂ©nĂ©ralement la table systĂšme de la base de donnĂ©es mysql.
Etapes à suivre pour résoudre ce problÚme,
- Créez un répertoire de sauvegarde en dehors de MariaDB
${DATADIR}</nowiki>, par exemple dans$HOME/mysql_backup. - Copiez les fichiers incriminés de
${DATADIR}/mysql/xxx.{frm,ibd}</nowiki>dans le répertoire de sauvegarde. Le fichierxxx.ibdpeut ne pas exister. - Supprimez les fichiers incriminés (.frm, .ibd) de
${DATADIR}/mysql/. - Exécutez le mysqlcheck. En cas de succÚs, les fichiers
xxx.frmetxxx.ibddevraient ĂȘtre créés Ă nouveau. - RĂ©-exĂ©cutez mysql_upgrade si nĂ©cessaire.