La compatibilité entre MariaDB et MySQL

MariaDB est un remplacement de MySQL prêt à exécuter

À toutes fins pratiques, MariaDB est un remplacement de la même Version de MySQL (par exemple, MySQL 5.1 -> MariaDB 5.1, MariaDB 5.2 & MariaDB 5.3 sont compatibles. MySQL 5.5 sera compatible avec MariaDB 5.5). Cela veut dire que:

• Les fichiers de données et de définition des tables (.frm) sont compatibles au niveau binaire.
• Tous les APIs clients, les protocoles et les structures sont identiques.
• Tous les noms de fichiers, fichiers binaires, chemins, ports, sockets et etc.... devraient être les mêmes.
• Tous les connecteurs de MySQL (PHP, Perl, Python, Java.NET, MyODBC, Ruby, connecteur MySQL C etc.) travaillent de la même manière avec MariaDB.
  • Il y a quelques installation issues with PHP5 dont il faut tenir compte (il s'agit d'un bug sur la manière utilisé par l'ancien PHP5 pour contrôler la compatibilité de la librairie client).
• Le paquet mysql-client fonctionne aussi avec le serveur MariaDB.

Cela veut dire que pour la plupart des cas, vous n'avez qu'a désinstaller MySQL et installer MariaDB pour pouvoir l'utiliser. (Il n'y a pas besoin de convertir les fichiers de données si vous utilisez la même version principale, telle que 5.1).

Tous les mois on fait le merge avec le code de MySQL afin de garder la compatibilité et pour avoir accès à toutes les fonctionnalités et les corrections des bugs développés par Oracle. Nous avons également fait beaucoup de travail sur la mise à niveau des scripts ce qui fait que maintenant il est plus facile upgrade depuis MySQL 5.0 à MariaDB 5.1 que depuis MySQL 5.0 à MySQL 5.1.

MariaDB dispose d'une grande quantité de nouvelles options , extensions, moteurs de stockage et correction de bugs qui n'étaient pas présentes dans MySQL. Vous pouvez trouver les caractéristiques des différentes versions de MariaDB dans la page Ce qu'il y a dans les différentes versions de MariaDB.

Voir aussi MariaDB versus MySQL - caractéristiques.

Les cas d'incompatibilité entre MariaDB 5.1 MySQL 5.1

Dans très peu de cas MariaDB doit être incompatible avec MySQL. Cela permet de fournir plus d'information que MySQL, information qui est, d'autre part, de meilleure qualité.

Voici la liste de toutes les incompatibilités connues, de niveau utilisateur, que vous pouvez rencontrer quand vous utilisez MariaDB 5.1 au lieu de MySQL 5.1.

• Le nom des paquets d'installation commencent par MariaDB au lieu de MySQL.
• Les timings peuvent être différents car MariaDB est souvent plus rapide que MySQL.
• mysqld dans MariaDB lit aussi les sections [mariadb] de vos fichiers my.cnf.
• Il n'est pas possible d'utiliser un moteur de stockage binaire s'il n'est pas compilé avec la même et exacte version de MariaDB. (Car la structure THD interne du serveur dans le cas de MariaDB est différente de celle de MySQL. C'est le cas aussi entre les différentes versions de MySQL). Cela ne devrait pas poser de problème car la plupart des gens ne téléchargent pas de nouveaux moteurs de stockage et aussi par le fait que MariaDB dispose de plus de moteurs de stockage que MySQL.
• CHECKSUM TABLE pourrait donner des résultats différents car MariaDB n'ignore pas NULL's dans les colonnes, comme le fait MySQL 5.1 (Les versions futures de MySQL devraient calculer les checksums de la même manière que MariaDB). Il est possible de calculer le checksum à la manière ancienne en faisant démarrer mysqld avec l'option --old. Notez cependant que les moteurs de stockage MyISAM et Aria dans MariaDB utilisent à l'interne le nouveau checksum, donc, si vous utilisez --old, la commande CHECKSUM sera plus lente, car elle devra calculer le checksum ligne par ligne.
• Le log de requêtes lentes dispose de plus d'information sur la requête, ce qui peut poser un problème si vous avez un script qui analyse ce log.
• MariaDB prend par défaut un peu plus de mémoire que MySQL car nous avons activé par défaut le moteur de stockage Aria pour manipuler les tables temporaires internes. S'il est nécessaire pour vous que MariaDB utilise peu de mémoire (au détriment des performances), vous pouvez définir la valeur de aria_pagecache_buffer_size comme 1M (Par défaut cette valeur serait de 128M).
• Si vous utilisez nouvelles options de commande, nouvelles caratéristiques de MariaDB ou nouveaux moteurs de stockage, vous ne pourrez plus basculer facilement entre MySQL and MariaDB.

Les cas 'incompatibilité entre MariaDB 5.2 et MySQL 5.1

La liste d'incompatibilités est la même que pour MariaDB 5.1 et MySQL 5.1, avec,en pus, celle qui suit:

• On a ajouté une nouvelle valeur pour New SQL_MODE: IGNORE_BAD_TABLE_OPTIONS. Si ce n'est pas défini à l'aide d'une table ou d'un attribut (option) qui ne soit pas supporté par le moteur de stockage choisi, celà provoquera une erreur. Ce changement pourrait entraîner des alertes dans le log d'erreurs en ce qui concerne la manière incorrecte de définir les tables dans la base de données mysql pour corriger ce problème, utilisez mysql_upgrade.

For all practical purposes, MariaDB 5.2 is a drop in replacement for MariaDB 5.1 and MySQL 5.1.

Incompatibilities between MariaDB 5.3 and MySQL 5.1 and MariaDB 5.2

• A few error messages related to wrong conversions are different as MariaDB provides more information in the message about what went wrong.
• Error numbers for MariaDB specific errors has been moved to start from 1900 to not conflict with MySQL errors.
• Microseconds now works in all contexts; MySQL did, in some contexts, lose the microsecond part from datetime and time.
• The old --maria- startup options are removed. You should use the --aria- prefix instead. (MariaDB 5.2 supports both --maria- and --aria-)
• SHOW PROCESSLIST has an extra Progress column which shows progress for some commands. You can disable it by starting mysqld with the --old flag.
• INFORMATION_SCHEMA.PROCESSLIST has three new columns for progress reporting: STAGE, MAX_STAGE, and PROGRESS.
• Long comments which start with /*M! or /*M!##### are executed.
• If you use max_user_connections=0 (which means any number of connections) when starting mysqld, you can't change the global variable anymore while mysqld remains running. This is because when mysqld is started with max_user_connections=0 it does not allocate counting structures (which also involve a mutex for each connection). This would lead to wrong counters if you later changed the variable. If you want to be able to change this variable at runtime, set it to a high value at startup.
• You can set max_user_connections (both the global variable and the GRANT option) to -1 to stop users from connecting to the server. The global max_user_connections variable does not affect users with the SUPER privilege.
• The IGNORE directive does not ignore all errors (like fatal errors), only things that are safe to ignore.

Old, unsupported configuration options

If you are using any of the following options in your /etc/my.cnf or other my.cnf file you should remove them. This is also true for MySQL 5.1 or newer:

• skip-bdb

Replacing a MySQL RPM

If you uninstalled a MySQL RPM to install MariaDB, note that the MySQL RPM on uninstall renames /etc/my.cnf to /etc/my.cnf.rpmsave.

After installing MariaDB you should do the following to restore your old configuration options:

mv -vi /etc/my.cnf.rpmsave /etc/my.cnf