MySQL :: MySQL 8.3 Reference Manual :: 5.6.9 Using AUTO

version 8.3

8.0 current
5.7

8.0 Japanese

MySQL 8.3 Reference Manual / ... / Using AUTO_INCREMENT

5.6.9 使用 AUTO_INCREMENT

可以使用 AUTO_INCREMENT 属性生成新行的唯一标识：

CREATE TABLE animals (
     id MEDIUMINT NOT NULL AUTO_INCREMENT,
     name CHAR(30) NOT NULL,
     PRIMARY KEY (id)
);

INSERT INTO animals (name) VALUES
    ('dog'),('cat'),('penguin'),
    ('lax'),('whale'),('ostrich');

SELECT * FROM animals;

+----+---------+
| id | name    |
+----+---------+
|  1 | dog     |
|  2 | cat     |
|  3 | penguin |
|  4 | lax     |
|  5 | whale   |
|  6 | ostrich |
+----+---------+

没有为 AUTO_INCREMENT 列指定值，因此 MySQL 自动分配序列号。您也可以显式地将 0 赋值给该列以生成序列号，除非启用了 NO_AUTO_VALUE_ON_ZERO SQL 模式。例如：

INSERT INTO animals (id,name) VALUES(0,'groundhog');

如果该列声明为 NOT NULL，也可以将 NULL 赋值给该列以生成序列号。例如：

INSERT INTO animals (id,name) VALUES(NULL,'squirrel');

当您将任何其他值插入 AUTO_INCREMENT 列时，该列将被设置为该值，并且序列将被重置，以便下一个自动生成的值从该列的最大值顺序地跟随。例如：

INSERT INTO animals (id,name) VALUES(100,'rabbit');
INSERT INTO animals (id,name) VALUES(NULL,'mouse');
SELECT * FROM animals;
+-----+-----------+
| id  | name      |
+-----+-----------+
|   1 | dog       |
|   2 | cat       |
|   3 | penguin   |
|   4 | lax       |
|   5 | whale     |
|   6 | ostrich   |
|   7 | groundhog |
|   8 | squirrel  |
| 100 | rabbit    |
| 101 | mouse     |
+-----+-----------+

更新现有的 AUTO_INCREMENT 列值也将重置 AUTO_INCREMENT 序列。

您可以使用 LAST_INSERT_ID() SQL 函数或 mysql_insert_id() C API 函数检索最近自动生成的 AUTO_INCREMENT 值。这些函数是连接特定的，因此它们的返回值不会受到其他连接的影响。

使用最小的整数数据类型来存储 AUTO_INCREMENT 列，以便容纳最大序列值。达到该数据类型的上限时，下一个序列号生成将失败。使用 UNSIGNED 属性以允许更大的范围。例如，如果使用 TINYINT，则最大允许的序列号为 127。对于 TINYINT UNSIGNED，最大值为 255。请参阅第 13.1.2 节，「整数类型（精确值）- INTEGER, INT, SMALLINT, TINYINT, MEDIUMINT, BIGINT」以获取所有整数类型的范围。

Note

对于多行插入，LAST_INSERT_ID() 和 mysql_insert_id() 实际上返回插入的第一行的 AUTO_INCREMENT 键。这使得多行插入可以在复制设置中正确地重现。

要从其他值开始 AUTO_INCREMENT，可以使用 CREATE TABLE 或 ALTER TABLE，如下所示：

mysql> ALTER TABLE tbl AUTO_INCREMENT = 100;

InnoDB 注意事项

有关 InnoDB 中 AUTO_INCREMENT 使用的信息，请参阅第 17.6.1.6 节，「InnoDB 中的 AUTO_INCREMENT 处理」。

MyISAM 注意事项

对于 MyISAM 表，可以在多列索引的辅助列上指定 AUTO_INCREMENT。在这种情况下，生成的 AUTO_INCREMENT 值将计算为 MAX(auto_increment_column) + 1 WHERE prefix=given-prefix。这在您想要将数据分组到有序组中时非常有用。

CREATE TABLE animals (
    grp ENUM('fish','mammal','bird') NOT NULL,
    id MEDIUMINT NOT NULL AUTO_INCREMENT,
    name CHAR(30) NOT NULL,
    PRIMARY KEY (grp,id)
) ENGINE=MyISAM;

INSERT INTO animals (grp,name) VALUES
    ('mammal','dog'),('mammal','cat'),
    ('bird','penguin'),('fish','lax'),('mammal','whale'),
    ('bird','ostrich');

SELECT * FROM animals ORDER BY grp,id;

+--------+----+---------+
| grp    | id | name    |
+--------+----+---------+
| fish   |  1 | lax     |
| mammal |  1 | dog     |
| mammal |  2 | cat     |
| mammal |  3 | whale   |
| bird   |  1 | penguin |
| bird   |  2 | ostrich |
+--------+----+---------+

在这种情况下（当 AUTO_INCREMENT 列是多列索引的一部分），如果删除具有最大 AUTO_INCREMENT 值的行中的任何组，则 AUTO_INCREMENT 值将被重用。这甚至适用于 MyISAM 表，其中 AUTO_INCREMENT 值通常不会被重用。

如果 AUTO_INCREMENT 列是多个索引的一部分，MySQL 将使用以 AUTO_INCREMENT 列开头的索引生成序列值，如果有的话。例如，如果 animals 表包含索引 PRIMARY KEY (grp, id) 和 INDEX (id)，MySQL 将忽略 PRIMARY KEY 生成序列值。因此，表将包含一个序列，而不是每个 grp 值的一个序列。

进一步阅读

关于 AUTO_INCREMENT 的更多信息可在这里找到：

如何将 AUTO_INCREMENT 属性分配给列：第 15.1.20 节，“CREATE TABLE 语句”，和第 15.1.9 节，“ALTER TABLE 语句”。
如何 AUTO_INCREMENT 根据 NO_AUTO_VALUE_ON_ZERO SQL 模式行为：第 7.1.11 节，“服务器 SQL 模式”。
如何使用 LAST_INSERT_ID() 函数来找到包含最新 AUTO_INCREMENT 值的行：第 14.15 节，“信息函数”。
设置要使用的 AUTO_INCREMENT 值：第 7.1.8 节，“服务器系统变量”。
第 17.6.1.6 节，“InnoDB 中的 AUTO_INCREMENT 处理”
AUTO_INCREMENT 和复制：第 19.5.1.1 节，“复制和 AUTO_INCREMENT”。
与 AUTO_INCREMENT 相关的服务器系统变量（auto_increment_increment 和 auto_increment_offset），可用于复制：第 7.1.8 节，“服务器系统变量”。

PREV HOME UP NEXT