PDF (A4) - 40.5Mb
Man Pages (TGZ) - 259.5Kb
Man Pages (Zip) - 366.7Kb
Info (Gzip) - 4.1Mb
Info (Zip) - 4.1Mb
RESET BINARY LOGS AND GTIDS [TObinary_log_file_index_number]Use this statement with caution to ensure you do not lose any wanted binary log file data and GTID execution history.
RESET BINARY LOGS AND GTIDS requires theRELOAD privilege.
For a server where binary logging is enabled (log_bin isON),RESET BINARY LOGS AND GTIDS deletes all existing binary log files and resets the binary log index file, resetting the server to its state before binary logging was started. A new empty binary log file is created so that binary logging can be restarted.
For a server where GTIDs are in use (gtid_mode isON), issuingRESET BINARY LOGS AND GTIDS resets the GTID execution history. The value of thegtid_purged system variable is set to an empty string (''), the global value (but not the session value) of thegtid_executed system variable is set to an empty string, and themysql.gtid_executed table is cleared (seemysql.gtid_executed Table). If the GTID-enabled server has binary logging enabled,RESET BINARY LOGS AND GTIDS also resets the binary log as described above. Note thatRESET BINARY LOGS AND GTIDS is the method to reset the GTID execution history even if the GTID-enabled server is a replica where binary logging is disabled;RESET REPLICA has no effect on the GTID execution history. For more information on resetting the GTID execution history, seeResetting the GTID Execution History.
IssuingRESET BINARY LOGS AND GTIDS without the optionalTO clause deletes all binary log files listed in the index file, resets the binary log index file to be empty, and creates a new binary log file starting at1. Use the optionalTO clause to start the binary log file index from a number other than1 after the reset.
Check that you are using a reasonable value for the index number. If you enter an incorrect value, you can correct this by issuing anotherRESET BINARY LOGS AND GTIDS statement with or without theTO clause. If you do not correct a value that is out of range, the server cannot be restarted.
The following example demonstratesTO clause usage:
RESET BINARY LOGS AND GTIDS TO 1234;SHOW BINARY LOGS;+-------------------+-----------+-----------+| Log_name | File_size | Encrypted |+-------------------+-----------+-----------+| source-bin.001234 | 154 | No |+-------------------+-----------+-----------+ The effects ofRESET BINARY LOGS AND GTIDS without theTO clause differ from those ofPURGE BINARY LOGS in 2 key ways:
RESET BINARY LOGS AND GTIDSremovesall binary log files that are listed in the index file, leaving only a single, empty binary log file with a numeric suffix of.000001, whereas the numbering is not reset byPURGE BINARY LOGS.RESET BINARY LOGS AND GTIDSisnot intended to be used while any replicas are running. The behavior ofRESET BINARY LOGS AND GTIDSwhen used while replicas are running is undefined (and thus unsupported), whereasPURGE BINARY LOGSmay be safely used while replicas are running.
RESET BINARY LOGS AND GTIDS without theTO clause can prove useful when you first set up a source and replica, so that you can verify the setup as follows:
Start the source and replica, and start replication (seeSection 19.1.2, “Setting Up Binary Log File Position Based Replication”).
Execute a few test queries on the source.
Check that the queries were replicated to the replica.
When replication is running correctly, issue
STOP REPLICAfollowed byRESET REPLICA(both on the replica), then verify that no unwanted data from the test queries exists on the replica. Following this, issueRESET BINARY LOGS AND GTIDS(also on the replica) to remove binary logs and and associated transaction IDs.Remove the unwanted data from the source, then issue
RESET BINARY LOGS AND GTIDSto purge any binary log entries and identifiers associated with it.
After verifying the setup, resetting the source and replica and ensuring that no unwanted data or binary log files generated by testing remain on the source or replica, you can start the replica and begin replicating.
PDF (A4) - 40.5Mb
Man Pages (TGZ) - 259.5Kb
Man Pages (Zip) - 366.7Kb
Info (Gzip) - 4.1Mb
Info (Zip) - 4.1Mb