MySQL 8.0 Reference Manual Including MySQL NDB Cluster 8.0
Statement-based replication of
AUTO_INCREMENT,
LAST_INSERT_ID(), and
TIMESTAMP values is carried out
subject to the following exceptions:
A statement invoking a trigger or function that causes an
update to an AUTO_INCREMENT column is not
replicated correctly using statement-based replication.
These statements are marked as unsafe. (Bug #45677)
An INSERT into a table that
has a composite primary key that includes an
AUTO_INCREMENT column that is not the
first column of this composite key is not safe for
statement-based logging or replication. These statements are
marked as unsafe. (Bug #11754117, Bug #45670)
This issue does not affect tables using the
InnoDB storage engine, since an
InnoDB table with an
AUTO_INCREMENT
column requires at least one key where the auto-increment
column is the only or leftmost column.
Adding an AUTO_INCREMENT column to a
table with ALTER TABLE might
not produce the same ordering of the rows on the replica and
the source. This occurs because the order in which the rows
are numbered depends on the specific storage engine used for
the table and the order in which the rows were inserted. If
it is important to have the same order on the source and
replica, the rows must be ordered before assigning an
AUTO_INCREMENT number. Assuming that you
want to add an AUTO_INCREMENT column to a
table t1 that has columns
col1 and col2, the
following statements produce a new table
t2 identical to t1 but
with an AUTO_INCREMENT column:
CREATE TABLE t2 LIKE t1; ALTER TABLE t2 ADD id INT AUTO_INCREMENT PRIMARY KEY; INSERT INTO t2 SELECT * FROM t1 ORDER BY col1, col2;
To guarantee the same ordering on both source and replica,
the ORDER BY clause must name
all columns of t1.
The instructions just given are subject to the limitations
of CREATE
TABLE ... LIKE: Foreign key definitions are
ignored, as are the DATA DIRECTORY and
INDEX DIRECTORY table options. If a table
definition includes any of those characteristics, create
t2 using a CREATE
TABLE statement that is identical to the one used
to create t1, but with the addition of
the AUTO_INCREMENT column.
Regardless of the method used to create and populate the
copy having the AUTO_INCREMENT column,
the final step is to drop the original table and then rename
the copy:
DROP t1; ALTER TABLE t2 RENAME t1;