Documentation Home
MySQL 8.0 Reference Manual
Related Documentation Download this Manual
PDF (US Ltr) - 43.3Mb
PDF (A4) - 43.4Mb
Man Pages (TGZ) - 297.2Kb
Man Pages (Zip) - 402.4Kb
Info (Gzip) - 4.3Mb
Info (Zip) - 4.3Mb
Excerpts from this Manual

MySQL 8.0 Reference Manual  / ...  / Replication  / Configuring Replication  / MySQL Multi-Source Replication  /  Resetting Multi-Source Replicas

19.1.5.7 Resetting Multi-Source Replicas

TheRESET REPLICA statement can be used to reset a multi-source replica. By default, if you use theRESET REPLICA statement on a multi-source replica all channels are reset. Optionally, use theFOR CHANNELchannel clause to reset only a specific channel.

  • To reset all currently configured replication channels:

    mysql> RESET SLAVE;Or from MySQL 8.0.22:mysql> RESET REPLICA;

  • To reset only a named channel, use aFOR CHANNELchannel clause:

    mysql> RESET SLAVE FOR CHANNEL "source_1";Or from MySQL 8.0.22:mysql> RESET REPLICA FOR CHANNEL "source_1";

For GTID-based replication, note thatRESET REPLICA has no effect on the replica's GTID execution history. If you want to clear this, issueRESET MASTER on the replica.

RESET REPLICA makes the replica forget its replication position, and clears the relay log, but it does not change any replication connection parameters (such as the source host name) or replication filters. If you want to remove these for a channel, issueRESET REPLICA ALL.

For the full syntax of theRESET REPLICA command and other available options, seeSection 15.4.2.4, “RESET REPLICA Statement”.