MariaDB与MySQL的兼容性问题

MariaDB是一个可替代MySQL的增强产品

对于MariaDB的所有实际用途, 就是为了可替代相同版本下的MYSQL (如 MySQL 5.1 对应 MariaDB 5.1, MariaDB 5.2 & MariaDB 5.3. MySQL 5.5 对应 MariaDB 5.5). 这意味着:

Data及table定义文件(.frm) 是兼容的.

所有的客户端API, 协议及结构是相同的.

所有的文件名，二进制文件，路径，端口，socket等都理应相同.

所有的MySQL连接器 (如PHP, Perl, Python, Java, .NET, MyODBC, Ruby, MySQL C链接器等)在MariaDB环境下保持不变.

mysql-client包同样可运行在MariaDB服务中.

其客户端共享库与MySQL客户端版本库兼容.

这说明在绝大多数情况下, 你可以卸载MySQL然后安装 MariaDB，而这个过程并不困难. (如果使用的是相同主版本MariaDB则不需要转换任何的数据文件, 例如 5.1).

每个月我们会定期合并MySQL的代码，以确保我们保持数据库的兼容性，并获取任何的Oracle新增的MySQL特性与修复的bug.

同时我们在升级版本的细节上也做了大量的工作，使得现在从MySQL 5.0升级到MariaDB 5.1 比MySQL从5.0升级到5.1要容易得多.

也就是说, MariaDB具有很多MySQL所缺少的特性，如新的选项, 拓展特性, 存储引擎及相关bug的修复. 在What is in the different MariaDB Releases页面， 你可以找到所有与MariaDB版本相关的特性.

MariaDB 5.1与MySQL 5.1的不兼容性

在少数情况下，MariaDB不必与MySQL相兼容，从而使得它能提供比MySQL更多更好的信息.

当用MariaDB 5.1 替换MySQL 5.1时，你可能碰到一下列表列出的所有已知的用户级别的不兼容性.

安装包名以MariaDB开头，而非MySQL.

Timings may be different as MariaDB is in many cases faster than MySQL.(未理解)

mysqld在MariaDB相应称为[mariadb]，配置在my.cnf文件中.

对于一个没有被正确的编译为对应版本的二进制存储引擎库，它将不能正常使用. (这是因为MySQL与MariaDB的服务内核结构有所不同，类似与MySQL版本间的不相同). 这应该不算什么问题，因为大多数的人并不会加载新的存储引擎,而MariaDB 配置了比MySQL更多的存储引擎.

CHECKSUM TABLE 可能返回不同的结果，因为MariaDB不会像MySQL 5.1一样忽略含有NULL值的列 (未来MySQL新版将会和MariaDB一样计算校验值). 你可以在MariaDB中使用--old选项来获取'old style'的校对值. 但值得注意的是，MariaDB中的MyISAM和Aria存储引擎使用的是新式校对值, 因此如果使用--old选项的话, CHECKSUM命令将由于按行来计算校对值而显得执行缓慢.

慢查询日志包含更多关于查询的信息, 当你用某个脚本来解析这些慢查询日志时可能会碰到问题.

默认配置下MariaDB会比MySQL占用多一些内存，因为默认下开启了Aria存储引擎 来控制内部临时表. 如果需要MariaDB少占用内存 (牺牲部分性能), 你可以将aria_pagecache_buffer_size 设置为1M (默认为128M).

如果使用了 new command options, new features of MariaDB 或者new storage engines, 你将很难在 MySQL和MariaDB之间切换.

MariaDB 5.2 和MySQL 5.1的不兼容性

不兼容的内容点与上述MariaDB 5.1和MySQL 5.1之间的列表相同, 另外补充一点:

添加了新的SQL_MODE值: IGNORE_BAD_TABLE_OPTIONS. 如果没有设置为此值，使用了当前存储引擎不支持的table,field或index属性(选项)时，将会提示错误. 这种变化会在错误日志中打印关于在mysql数据库中不正确定义表的警告，可使用mysql_upgrade来修复.

总的来说, MariaDB 5.2是可替换MariaDB 5.1 及 MySQL 5.1的增强版本.

因错误的转换导致的少量错误信息会有所不同，因为MariaDB提供了更多关于出错的信息记录.

MariaDB中的特定错误号已改为从1900开始，以避免与MySQL错误有冲突.

毫秒单位现使用在所有上下文中; 而在MySQL中某些上下文中datetime和time类型去掉了毫秒单位.

UNIX_TIMESTAMP(constant-date-string)在MariaDB中返回6位十进制数的时间戳，而MySQL返回非十进制的时间戳. 因此当你使用UNIX_TIMESTAMP()作为分区函数时将会引发问题.通过 FLOOR(UNIX_TIMESTAMP(..)) 或将日期字符串转为日期数字可以解决这个问题,如 20080101000000.

MariaDB对date, datetime and timestamp等类型的值做了更多更严格的检验. 例如UNIX_TIMESTAMP('x')先返回的是NULL而不是0.

旧的--maria-启动选项已经被移除. --aria-可以作为新的选项来替代使用. (MariaDB 5.2 同时支持--maria- 和 --aria-)

SHOW PROCESSLIST 用额外的列 Progress 来显示部分命令的进度. 你可以通过启动mysqld时使用 --old标志来禁用它.

INFORMATION_SCHEMA.PROCESSLIST信息使用了三个新列来报告进度: STAGE,MAX_STAGE, and PROGRESS.

以/*M! 或 /*M!#####开头的长注释(Long comments)会被执行.

启动mysqld时如果设置了max_user_cOnnections=0 (意味着不限制用户连接数), 那么在mysql服务运行过程中这个全局变量将无法修改. 这是因为以max_user_cOnnections=0启动的mysqld服务不会分配计数结构体 (该结构体为每个连接记录了互斥量). 因此稍后修改这个全局变量会导致错误的计数. 如果想在服务运行过程中能修改它，那在启动服务时将该变量设置为一个较大的值.

你可以设置max_user_connections (全局变量及 GRANT 选项中) 的值为-1 来禁止用户连接到服务端. 而全局变量max_user_connections对于拥有 SUPER 权限的用户不起作用.

指令 IGNORE 并不会忽略所有的错误 (例如致命错误), 而只忽略了一些较为安全的信息.

XtraDB

作为XtraDB的提供程序Percona, 5.5版本里并没有提供XtraDB早期版本的完整的特性. 因此 MariaDB 5.5也不提供.

XtraDB5.5中丢弃的选项

XtraDB 5.5版本不支持以下的选项. 如果你在任一my.cnf配置文件中使用了它们, 那么在升级到5.5之前移除它们.

innodb_adaptive_checkpoint ; 替换为innodb_adaptive_flushing_method.

innodb_auto_lru_dump ;替换为innodb_buffer_pool_restore_at_startup.

innodb_blocking_lru_restore ; 替换为innodb_blocking_buffer_pool_restore.

innodb_enable_unsafe_group_commit

innodb_expand_import ; 替换为innodb_import_table_from_xtrabackup.

innodb_extra_rsegments ; 替换为innodb_rollback_segment.

innodb_extra_undoslots

innodb_fast_recovery

innodb_flush_log_at_trx_commit_session

innodb_overwrite_relay_log_info

innodb_pass_corrupt_table ; 替换为innodb_corrupt_table_action.

innodb_use_purge_thread

xtradb_enhancements

被修改默认值的XtraDB选项

选项名	旧值	新值
innodb_adaptive_checkpoint	TRUE	FALSE
innodb_change_buffering	inserts	all
innodb_flush_neighbor_pages	1	area

XtraDB 5.5新添加的选项

以下是XtraDB5.5 / InnoDB5.5 中新添加的选项. (Listed here just to have all XtraDB information in the same place未翻译)

innodb_adaptive_flushing_method

innodb_adaptive_hash_index_partitions

innodb_blocking_buffer_pool_restore

innodb_buffer_pool_instances

innodb_buffer_pool_restore_at_startup

innodb_change_buffering_debug

innodb_corrupt_table_action

innodb_flush_checkpoint_debug

innodb_force_load_corrupted

innodb_import_table_from_xtrabackup

innodb_large_prefix

innodb_purge_batch_size

innodb_purge_threads

innodb_recovery_update_relay_log

innodb_rollback_segments

innodb_sys_columns

innodb_sys_fields

innodb_sys_foreign

innodb_sys_foreign_cols

innodb_sys_tablestats

innodb_use_global_flush_log_at_trx_commit

innodb_use_native_aio

同样可参考 Perconas guide of how to upgrade to 5.5

老而不再被支持的配置选项

如果在/etc/my.cnf或其他位置的 my.cnf种使用到了一下选项，应该移除它们. 在MySQL 5.1或者更新的版本里也是一样的:

替换MySQL RPM安装包

如果你要卸载MySQL RPM包并安装 MariaDB, 注意要在卸载时将/etc/my.cnf重命名为/etc/my.cnf.rpmsave.

在安装MariaDB完成后，你应该按以下步骤恢复原有的配置选项:

mv -vi /etc/my.cnf.rpmsave /etc/my.cnf
IMariaDB和MySQL-Proxy的不兼容性

MySQL客户端API可以通过MySQL-Proxy链接到MariaDB，但MariaDB客户端API会收到关于"MySQL-Proxy does not implement"的进度报告提示. 可以通过禁用client与server之间的进度报告来实现兼容性.