Documentation Home
MySQL 9.4 Reference Manual
Related Documentation Download this Manual
PDF (US Ltr) - 41.2Mb
PDF (A4) - 41.3Mb
Man Pages (TGZ) - 262.8Kb
Man Pages (Zip) - 368.8Kb
Info (Gzip) - 4.1Mb
Info (Zip) - 4.1Mb


MySQL 9.4 Reference Manual  / ...  / Replication  / Replication Solutions  /  Using Replication with Different Source and Replica Storage Engines

19.4.4 Using Replication with Different Source and Replica Storage Engines

It does not matter for the replication process whether the original table on the source and the replicated table on the replica use different storage engine types. In fact, thedefault_storage_engine system variable is not replicated.

This provides a number of benefits in the replication process in that you can take advantage of different engine types for different replication scenarios. For example, in a typical scale-out scenario (seeSection 19.4.5, “Using Replication for Scale-Out”), you want to useInnoDB tables on the source to take advantage of the transactional functionality, but useMyISAM on the replicas where transaction support is not required because the data is only read. When using replication in a data-logging environment you may want to use theArchive storage engine on the replica.

Configuring different engines on the source and replica depends on how you set up the initial replication process:

  • If you usedmysqldump to create the database snapshot on your source, you could edit the dump file text to change the engine type used on each table.

    Another alternative formysqldump is to disable engine types that you do not want to use on the replica before using the dump to build the data on the replica. For example, you can add the--skip-federated option on your replica to disable theFEDERATED engine. If a specific engine does not exist for a table to be created, MySQL uses the default engine type, usuallyInnoDB. (This requires that theNO_ENGINE_SUBSTITUTION SQL mode is not enabled.) If you want to disable additional engines in this way, you may want to consider building a special binary to be used on the replica that supports only the engines you want.

  • If you use raw data files (a binary backup) to set up the replica, it is not possible to change the initial table format. Instead, useALTER TABLE to change the table types after the replica has been started.

  • For new source/replica replication setups where there are currently no tables on the source, avoid specifying the engine type when creating new tables.

If you are already running a replication solution and want to convert your existing tables to another engine type, follow these steps:

  1. Stop the replica from running replication updates:

    mysql> STOP REPLICA;

    This makes it possible to change engine types without interruption.

  2. Execute anALTER TABLE ... ENGINE='engine_type' for each table to be changed.

  3. Start the replication process again:

    mysql> START REPLICA;

Although thedefault_storage_engine variable is not replicated, be aware thatCREATE TABLE andALTER TABLE statements that include the engine specification are replicated to the replica correctly. If, in the case of aCSV table, you execute this statement:

mysql> ALTER TABLE csvtable ENGINE='MyISAM';

This statement is replicated; the table's engine type on the replica is converted toInnoDB, even if you have previously changed the table type on the replica to an engine other thanCSV. If you want to retain engine differences on the source and replica, you should be careful to use thedefault_storage_engine variable on the source when creating a new table. For example, instead of:

mysql> CREATE TABLE tablea (columna int) Engine=MyISAM;

Use this format:

mysql> SET default_storage_engine=MyISAM;mysql> CREATE TABLE tablea (columna int);

When replicated, thedefault_storage_engine variable is ignored, and theCREATE TABLE statement executes on the replica using the replica's default engine.