Jump to content

MariaDB (Français)

From ArchWiki
État de la traduction: Cet article est la version francophone de MariaDB. Date de la derniùre traduction: 2022-10-03. Vous pouvez aider à synchroniser la traduction s'il y a eu des changements dans la version anglaise.

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.

Astuce

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
Astuce Si vous utilisez autre chose que /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.

Note Avant de continuer, il est recommandé d'améliorer la sécurité initiale de l'installation de MySQL.

Pour simplifier l'administration, vous pouvez installer un front-end.

Configuration

This article or section is out of date.

Reason: Le fichier de configuration principal /etc/my.cnf est maintenant divisé en plusieurs fichiers dans /etc/my.cnf.d/ (Discuss in Talk:MariaDB)

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
Note Le mot de passe par défaut est vide. Appuyez sur 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

Note L'activation de cette fonctionnalité peut rendre l'initialisation du client plus longue.

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

Attention Avant de modifier le jeu de caractÚres, assurez-vous de créer d'abord une sauvegarde.
Note
  • Le paquet mariadb utilise dĂ©jĂ  utf8mb4 comme jeu de caractĂšres et utf8mb4_unicode_ci comme 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

This article or section is out of date.

Reason: A compter de la version 10.3.1, cette section n'est plus applicable. Les 3 options sont maintenant activĂ©es par dĂ©faut. innodb_file_format et innodb_large_prefix sont obsolĂštes et ne peuvent plus ĂȘtre utilisĂ©es. Le service mariadb ne dĂ©marrera pas si l'une ou l'autre de ces options est incluse dans my.cnf. (source) (Discuss in Talk:MariaDB)
Note La limite de caractÚres dépend du jeu de caractÚres utilisé [4] [5] [6].

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
Attention AprĂšs avoir exĂ©cutĂ© cette commande, veuillez noter que le port TCP 3306 sera toujours ouvert, mais refusera les connexions avec un message d'erreur. Pour empĂȘcher MySQL d'Ă©couter sur une interface externe, consultez les sections #Écouter uniquement sur l'adresse de bouclage et #Restreindre l'accĂšs local uniquement via les sockets Unix.

É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

Attention Ce n'est pas considéré comme une bonne pratique et peut causer des problÚmes de sécurité. Envisagez d'utiliser Secure Shell, VNC ou VPN, si vous voulez maintenir le serveur MySQL à partir d'un autre hÎte à l'intérieur ou à l'extérieur de votre réseau.

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

  1. ArrĂȘtez mariadb.service.
  2. DĂ©marrez le serveur mysqld avec les fonctions de sĂ©curitĂ© :
    # mysqld_safe --skip-grant-tables --skip-networking &
  3. Connectez-vous au serveur :
    # mysql -u root
  4. 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
    
  5. Tuez les processus mysqld* en cours d'exĂ©cution :
    # kill $(cat /var/lib/mysql/$HOSTNAME.pid)
  6. 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.

Note Vous pouvez toujours vous connecter en spécifiant le mot de passe comme argument de la commande mysql.
Attention Ce comportement est considéré comme dangereux, car votre mot de passe pourrait fuir, par exemple, dans les journaux. N'utilisez cette méthode qu'en cas d'urgence et n'oubliez pas de changer le mot de passe juste aprÚs.
$ mysql -u user -p "some-very-strong-password"

Les journaux binaires de MySQL prennent beaucoup d'espace disque

This article or section is out of date.

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' ;"
Attention Cela peut diminuer les chances de réussite de la récupération des données lors de la réparation des tables de la base de données (c'est-à-dire en cas de corruption de la base de données).

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,

  1. Créez un répertoire de sauvegarde en dehors de MariaDB ${DATADIR}</nowiki>, par exemple dans $HOME/mysql_backup.
  2. Copiez les fichiers incriminés de ${DATADIR}/mysql/xxx.{frm,ibd}</nowiki> dans le répertoire de sauvegarde. Le fichier xxx.ibd peut ne pas exister.
  3. Supprimez les fichiers incriminés (.frm, .ibd) de ${DATADIR}/mysql/.
  4. ExĂ©cutez le mysqlcheck. En cas de succĂšs, les fichiers xxx.frm et xxx.ibd devraient ĂȘtre créés Ă  nouveau.
  5. Ré-exécutez mysql_upgrade si nécessaire.


Voir aussi