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 для столбца, чтобы сгенерировать последовательные номера, если не включён режим SQL NO_AUTO_VALUE_ON_ZERO. Например:
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.
Вы можете получить последнее автоматически сгенерированное значение AUTO_INCREMENT с помощью функции SQL LAST_INSERT_ID() или функции C API. Эти функции специфичны для соединения, поэтому их возвращаемые значения не затрагиваются другим соединением, которое также выполняет вставки.
Используйте наименьший целочисленный тип данных для столбца AUTO_INCREMENT, который достаточно большой для хранения максимального значения последовательности, которое вам необходимо. Когда столбец достигает верхнего предела типа данных, следующая попытка сгенерировать последовательный номер завершается ошибкой. Если возможно, используйте атрибут UNSIGNED для увеличения диапазона. Например, если вы используете TINYINT, максимальное допустимое значение последовательного номера равно 127. Для TINYINT
UNSIGNED максимальное значение равно 255. См. раздел 13.1.2, «Целочисленные типы (точные значения) - INTEGER, INT, SMALLINT, TINYINT, MEDIUMINT, BIGINT» для диапазонов всех целочисленных типов.
При вставке нескольких строк LAST_INSERT_ID() и, фактически, возвращают ключ AUTO_INCREMENT от первой вставленной строки. Это позволяет правильно воспроизвести вставки нескольких строк на других серверах в настройке репликации.
Чтобы начать с значения AUTO_INCREMENT, отличного от 1, установите это значение с помощью CREATE
TABLE или ALTER TABLE, как показано ниже:
mysql> ALTER TABLE tbl AUTO_INCREMENT = 100;
Примечания для InnoDB
Дополнительную информацию об использовании AUTO_INCREMENT, специфичную для InnoDB, см. в разделе 17.6.1.6, «Обработка AUTO_INCREMENT в InnoDB».
Примечания для MyISAM
-
Для таблиц
MyISAMвы можете указатьAUTO_INCREMENTдля дополнительного столбца в индексе с несколькими столбцами. В этом случае сгенерированное значение для столбцаAUTO_INCREMENTвычисляется какMAX(. Это полезно, когда вы хотите поместить данные в упорядоченные группы.auto_increment_column) + 1 WHERE prefix=given-prefixCREATE 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повторно используются, если вы удаляете строку с наибольшим значением в любой группе. Это происходит даже для таблиц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.21, «Оператор CREATE TABLE» и раздел 15.1.9, «Оператор ALTER TABLE».Как ведет себя
AUTO_INCREMENTв зависимости от режима SQLNO_AUTO_VALUE_ON_ZERO: раздел 7.1.11, «Режимы SQL сервера».Как использовать функцию
LAST_INSERT_ID()для поиска строки, содержащей последнее значениеAUTO_INCREMENT: раздел 14.15, «Функции информации».Установление значения
AUTO_INCREMENTдля использования: раздел 7.1.8, «Системные переменные сервера».AUTO_INCREMENTи репликация: раздел 19.5.1.1, «Репликация и AUTO_INCREMENT».Системные переменные сервера, связанные с
AUTO_INCREMENT(auto_increment_incrementиauto_increment_offset), которые могут использоваться для репликации: раздел 7.1.8, «Системные переменные сервера».
© 2025 Oracle
Licensed under the GPLv2 License.