MariaDB server is a community developed fork of MySQL server. Started by core members of the original MySQL team, MariaDB actively works with outside developers to deliver the most featureful, stable, and sanely licensed open SQL server in the industry.
Find a file
Monty c0bd9cdf13 MDEV-36290: Improved support of replication between tables of different structure
One can have data loss in multi-master setups when 1) both masters
update the same table, 2) ALTER TABLE is run on one master which
re-arranges the column ordering, and 3) transactions are binlogged
in ROW binlog_format.

This is because the slave assumes that all columns are in the same
order on the master and slave and all columns on the master also
exists on the slave. This happens even if binlog_row_metadata=FULL is
used.  If this is not the case, this will lead to silent data loss.

A new option for slave_type_conversions bit field,
ERROR_IF_MISSING_FIELD, has been added, along with a new error,
ER_SLAVE_INCOMPATIBLE_TABLE_DEF. This allows the user to define if
the slave should abort replication if it is missing some field that
existed on the master. The option is off by default to keep things
compatible with earlier versions.
If a field is missing on the slave and log_warnings >= 1, a warning
will be logged to the error log.

This patch fixes this, when binlog_row_metadata=FULL is used on the
master, by mapping fields with identical names on the master and slave.
If slave has fields that does not exist in the row event, these will
be set to their default value.

The main idea is that we added two conversion tables:
m_tabledef.master_to_slave_map[master_column_index] -> slave_column_index
and m_tabledef.master_to_slave_error[master_column_index] which contains
an error number if the master_column does not exist on the slave or
it is not possible to convert the master data to the slave column.
master_to_slave_error[#] contains 0 if the column exists and is compatible.

General code changes:
- Instead of looping over row fields in the order of slave table
  we are instead looping over fields in the order of the binary log.
- We are using table->write_set to know which fields should be updated
  on the slave. This is reflected in unpack_row
- We are calling TABLE::mark_columns_per_binlog_row_image() to ensure
  that rpl_write_set is properly set. This is needed if the slave also
  is doing binary logging.
- Before replication aborted if the master and slave tables were too
  different.  Now replication is only aborted if the row actually uses
  columns that does not exists on the slave (and ERROR_IF_MISSING_FIELD
  is used) or uses columns that cannot be converted.
  - Instead of giving errors in compatible_with(), used when table is
    accessed by first the row event, we are instead giving errors
    when we examine a row event and notice that it is accessing
    a not existing or not compatible field.

Other code changes:
- Removed conv_table argument from compatible_with() and store it
  directly in RPL_TABLE_LIST->m_conv_table
- table_def::compatible_with() returns now 1 on error (not 0).
- Remove m_width and skip arguments from prepare_record() as we are
  now using table->write_set() to check which elements need a default
  value.
- Moved DBUG_ENTER() to it's proper place (after variable
  declarations) in a few functions.
- Some changes in unpack_row():
  - Replaced null_mask and null_ptr with an indexed bit check for
    simplicity.
  - Removed check of rgi == null and table_found which never worked.
  - Updated comments to reflect current code.
  - Indentation changes as the code now uses 'continue' instead of
    'if-else' in the main loop.
  - The code to throw away 'extra master fields' is not needed as we
    are now looping over fields in binary log, not over fields in
    slave table.
- Simplified get_table_data(TABLE *table_arg) by returning found
  table_list.
- Errors for row events are now initialized in compatible_with(),
  checked in check_wrong_column_usage() and reported in
  give_compatibility_error().

Note for Review:
 - MDEV-36892 is not addressed, so the clause and associated code from
   the 10.6 patch is removed:

   """
  - Store a table's original write_set in cond_set, so we can later
    cross-reference it when automatically populating fields (i.e. so we
    know not to override a replicated value).
   """

Co-authored-by: Brandon Nesterenko <brandon.nesterenko@mariadb.com>
2025-08-11 16:12:07 -06:00
.github Merge branch '11.8' into 12.0 2025-06-18 07:50:39 +02:00
BUILD Fix remaining typos 2025-04-29 11:18:00 +10:00
client Merge branch '12.0' into 12.1 2025-08-03 15:01:09 +02:00
cmake Merge branch '12.0' into 12.1 2025-08-03 15:01:09 +02:00
dbug Reënable ATTRIBUTE_FORMAT on DBUG_PRINT & t/eprint 2025-02-12 10:17:44 +01:00
debian 12.2 branch 2025-08-04 21:28:16 +02:00
Docs Fix remaining typos 2025-04-29 11:18:00 +10:00
extra Merge branch '12.0' into 12.1 2025-08-03 15:01:09 +02:00
include MDEV-36554 addendum: Assertion `is_wsrep() == wsrep_on(mysql_thd)' failed in void trx_t::commit_in_memory(const mtr_t*) 2025-08-04 14:58:18 +02:00
libmariadb@b790c6c149 Connector/C 3.4.7 2025-07-27 15:44:07 +02:00
libmysqld MDEV-13817 add support for oracle left join syntax - the ( + ) 2025-08-04 12:05:53 +02:00
libservices Merge 10.6 into 10.11 2024-02-08 15:04:46 +02:00
man Merge branch '11.8' into 12.0 2025-06-18 07:50:39 +02:00
mysql-test MDEV-36290: Improved support of replication between tables of different structure 2025-08-11 16:12:07 -06:00
mysys Merge branch '12.0' into 12.1 2025-08-03 15:01:09 +02:00
mysys_ssl MDEV-34712 Add support to sha2 and pbkdf2 key derivation in file_key_management 2025-04-28 13:43:32 +10:00
plugin Add Flags to Item::walk. 2025-08-04 12:05:53 +02:00
randgen/conf Group commit for maria engine. 2010-02-12 15:12:28 +02:00
scripts Merge branch '12.0' into 12.1 2025-08-03 15:01:09 +02:00
sql MDEV-36290: Improved support of replication between tables of different structure 2025-08-11 16:12:07 -06:00
sql-bench Fix remaining typos 2025-04-29 11:18:00 +10:00
sql-common Merge branch '12.0' into 12.1 2025-08-03 15:01:09 +02:00
storage MDEV-36554 addendum: Assertion `is_wsrep() == wsrep_on(mysql_thd)' failed in void trx_t::commit_in_memory(const mtr_t*) 2025-08-04 14:58:18 +02:00
strings Merge branch '11.8' into 12.0 2025-07-31 20:55:47 +02:00
support-files Merge branch '11.8' into 12.0 2025-07-31 20:55:47 +02:00
tests Merge branch '11.8' into 12.0 2025-05-22 09:22:55 +02:00
tpool Merge branch '11.8' into 12.0 2025-07-31 20:55:47 +02:00
unittest Merge branch '11.8' into 12.0 2025-07-31 20:55:47 +02:00
vio Merge branch '11.8' into 12.0 2025-06-18 07:50:39 +02:00
win Merge branch '11.8' into 12.0 2025-07-31 20:55:47 +02:00
wsrep-lib@e55f01ce1e MDEV-36422 Build fails with cmake 4.0.0 due to wsrep 2025-04-10 13:05:19 +02:00
zlib Merge branch 'merge-zlib' (1.3.1) into 10.4 2024-04-26 13:50:03 +02:00
.clang-format Remove duplicate key "Language" from .clang-format 2024-04-17 16:52:37 +02:00
.gitattributes Merge branch '10.5' into 10.6 2022-02-03 17:01:31 +01:00
.gitignore Merge branch '11.4' into 11.8 2025-06-18 07:43:24 +02:00
.gitlab-ci.yml Fix remaining typos 2025-04-29 11:18:00 +10:00
.gitmodules Merge remote-tracking branch '10.4' into 10.5 2023-03-31 21:32:41 +02:00
appveyor.yml Merge remote-tracking branch 'github/bb-11.4-release' into bb-11.8-serg 2025-04-27 19:40:00 +02:00
BUILD-CMAKE Fix remaining typos 2025-04-29 11:18:00 +10:00
CMakeLists.txt Merge branch '12.0' into 12.1 2025-08-03 15:01:09 +02:00
CODING_STANDARDS.md Merge branch '11.8' into 12.0 2025-06-18 07:50:39 +02:00
config.h.cmake Merge branch '11.4' into 11.8 2025-07-28 21:29:29 +02:00
configure.cmake Merge branch '11.6' into 11.7 2024-11-10 19:22:21 +01:00
CONTRIBUTING.md Add CODING_STANDARDS.md file 2023-02-03 15:47:17 +11:00
COPYING Update FSF Address 2019-05-11 21:29:06 +03:00
CREDITS Update sponsors 2024-08-12 09:32:30 +01:00
INSTALL-SOURCE Update AskMonty and Atlassian references to MariaDB 2016-03-08 15:24:01 +02:00
INSTALL-WIN-SOURCE Update AskMonty and Atlassian references to MariaDB 2016-03-08 15:24:01 +02:00
KNOWN_BUGS.txt Changed some MySQL names in messages to MariaDB 2018-12-09 20:49:05 +02:00
README.md Merge branch '10.11' into 11.1 2024-05-31 10:54:31 +10:00
SECURITY.md Create SECURITY.md 2023-06-05 08:28:06 +10:00
THIRDPARTY Update THIRDPARTY license file to reflect reality 2025-04-18 23:16:46 +02:00
VERSION 12.2 branch 2025-08-04 21:28:16 +02:00

Code status:

  • Appveyor CI status ci.appveyor.com

MariaDB: The innovative open source database

MariaDB was designed as a drop-in replacement of MySQL(R) with more features, new storage engines, fewer bugs, and better performance.

MariaDB is brought to you by the MariaDB Foundation and the MariaDB Corporation. Please read the CREDITS file for details about the MariaDB Foundation, and who is developing MariaDB.

MariaDB is developed by many of the original developers of MySQL who now work for the MariaDB Corporation, the MariaDB Foundation and by many people in the community.

MySQL, which is the base of MariaDB, is a product and trademark of Oracle Corporation, Inc. For a list of developers and other contributors, see the Credits appendix. You can also run 'SHOW authors' to get a list of active contributors.

A description of the MariaDB project and a manual can be found at:

https://mariadb.org

https://mariadb.com/kb/en/

https://mariadb.com/kb/en/mariadb-vs-mysql-features/

https://mariadb.com/kb/en/mariadb-versus-mysql-compatibility/

https://mariadb.com/kb/en/new-and-old-releases/

Getting the code, building it and testing it

Refer to the following guide: https://mariadb.org/get-involved/getting-started-for-developers/get-code-build-test/ which outlines how to build the source code correctly and run the MariaDB testing framework, as well as which branch to target for your contributions.

Help

More help is available from the Maria Discuss mailing list https://lists.mariadb.org/postorius/lists/discuss.lists.mariadb.org/ and MariaDB's Zulip instance, https://mariadb.zulipchat.com/

Licensing


MariaDB is specifically available only under version 2 of the GNU General Public License (GPLv2). (I.e. Without the "any later version" clause.) This is inherited from MySQL. Please see the README file in the MySQL distribution for more information.

License information can be found in the COPYING file. Third party license information can be found in the THIRDPARTY file.


Bug Reports

Bug and/or error reports regarding MariaDB should be submitted at: https://jira.mariadb.org

For reporting security vulnerabilities, see our security-policy.

The code for MariaDB, including all revision history, can be found at: https://github.com/MariaDB/server