LAST_INSERT_ID()

若 INSERT 为用户可见的 AUTO_INCREMENT 列生成了值,可调用 LAST_INSERT_ID() 获取该生成值。

语法说明

若 INSERT 为用户可见的 AUTO_INCREMENT 列生成了值,可调用 LAST_INSERT_ID() 获取该生成值。显式指定自增值的插入不会更新其结果。

无参数的 LAST_INSERT_ID() 返回一个 BIGINT UNSIGNED(64 位)值,表示当前会话最近一次由 INSERT 成功生成的用户可见 AUTO_INCREMENT 值。生成值取决于该列的起始值、步长和已使用的值;默认起始值为 1。

如果 INSERT 没有成功生成用户可见的 AUTO_INCREMENT 值,LAST_INSERT_ID() 的值保持不变。

LAST_INSERT_ID() 只反映用户可见的 AUTO_INCREMENT 列生成的值。对于没有用户定义主键的普通表,MatrixOne 会追加内部隐藏主键(列名 __mo_fake_pk_col,FULLTEXT 索引表同样使用该隐藏主键);隐藏主键的值由独立的分配器维护,不会出现在 LAST_INSERT_ID() 中。因此,在这样的表中为用户 AUTO_INCREMENT 列显式指定值、且没有其他用户可见自增值生成时,INSERT 只会生成隐藏主键,LAST_INSERT_ID() 保持为上一次生成用户可见值语句的结果。若用户可见的 AUTO_INCREMENT 列恰好命名为 __mo_fake_pk_col,则该列并非隐藏列,其值仍会正常返回。

在 MySQL 中,如果使用单个 INSERT 语句插入多行,则 LAST_INSERT_ID() 仅返回为第一个插入行生成的值。例如:

mysql> CREATE TABLE t (id INT AUTO_INCREMENT NOT NULL PRIMARY KEY, name VARCHAR(10) NOT NULL);
mysql> INSERT INTO t VALUES (NULL, 'Bob');
mysql> SELECT * FROM t;
+----+------+
| id | name |
+----+------+
|  1 | Bob  |
+----+------+
mysql> SELECT LAST_INSERT_ID();
+------------------+
| LAST_INSERT_ID() |
+------------------+
|                1 |
+------------------+
mysql> INSERT INTO t VALUES (NULL, 'Mary'), (NULL, 'Jane'), (NULL, 'Lisa');
mysql> SELECT * FROM t;
+----+------+
| id | name |
+----+------+
|  1 | Bob  |
|  2 | Mary |
|  3 | Jane |
|  4 | Lisa |
+----+------+
mysql> SELECT LAST_INSERT_ID();
+------------------+
| LAST_INSERT_ID() |
+------------------+
|                2 |
+------------------+

在 MatrixOne 中,对于上面每行都自动生成自增值的多行 INSERT,LAST_INSERT_ID() 返回最后生成的值。执行 INSERT INTO t VALUES (NULL, 'Mary'), (NULL, 'Jane'), (NULL, 'Lisa'); 后,LAST_INSERT_ID() 返回 4。

语法结构

LAST_INSERT_ID()

示例

create table t1(a int auto_increment primary key);
insert into t1 values();
mysql> select last_insert_id();
+------------------+
| last_insert_id() |
+------------------+
|                1 |
+------------------+
1 row in set (0.02 sec)

insert into t1 values(11);
insert into t1 values();
mysql> select last_insert_id();
+------------------+
| last_insert_id() |
+------------------+
|               12 |
+------------------+
1 row in set (0.02 sec)

insert into t1 values(null);
mysql> select last_insert_id();
+------------------+
| last_insert_id() |
+------------------+
|               13 |
+------------------+
1 row in set (0.02 sec)

create table t2(a int auto_increment primary key);
insert into t2 values();
mysql> select last_insert_id();
+------------------+
| last_insert_id() |
+------------------+
|                1 |
+------------------+
1 row in set (0.02 sec)

insert into t2 values(100);
insert into t2 values();
mysql> select last_insert_id();
+------------------+
| last_insert_id() |
+------------------+
|              101 |
+------------------+
1 row in set (0.02 sec)

下面的示例演示隐藏主键规则。li_p1 将用户可见的 AUTO_INCREMENT 列命名为 __mo_fake_pk_col,其生成的值会正常返回;li_p2 没有用户定义的主键,会被追加隐藏主键,为 id 显式指定值的插入只生成隐藏主键,因此 LAST_INSERT_ID() 保持为 1。DELETE 被优化为 truncate 重建 li_p3 之后,隐藏主键同样不会出现在返回值中。

CREATE DATABASE IF NOT EXISTS last_insert_id_doc;
USE last_insert_id_doc;

CREATE TABLE li_p1(pk int primary key, `__mo_fake_pk_col` bigint unsigned auto_increment unique key);
INSERT INTO li_p1(pk) VALUES(10);
SELECT last_insert_id();
SELECT pk, `__mo_fake_pk_col` FROM li_p1 ORDER BY pk;

CREATE TABLE li_p2(id bigint auto_increment, v int, unique key uk(id));
INSERT INTO li_p2(v) VALUES(1);
SELECT last_insert_id();
INSERT INTO li_p2(id,v) VALUES(100,2);
SELECT last_insert_id();
SELECT id, v FROM li_p2 ORDER BY id;

SET delete_opt_to_truncate = 1;
CREATE TABLE li_p3(id bigint auto_increment, v int, unique key(id));
INSERT INTO li_p3(v) VALUES(1);
SELECT last_insert_id();
DELETE FROM li_p3;
INSERT INTO li_p3(id,v) VALUES(100,2);
SELECT last_insert_id();
SELECT id, v FROM li_p3 ORDER BY id;

DROP TABLE IF EXISTS li_p1;
DROP TABLE IF EXISTS li_p2;
DROP TABLE IF EXISTS li_p3;
DROP DATABASE IF EXISTS last_insert_id_doc;