СОЗДАНИЕ ПОСЛЕДОВАТЕЛЬНОСТИ

Синтаксис

CREATE [OR REPLACE] [TEMPORARY] SEQUENCE [IF NOT EXISTS] sequence_name
[ INCREMENT [ BY | = ] increment ]
[ MINVALUE [=] minvalue | NO MINVALUE | NOMINVALUE ]
[ MAXVALUE [=] maxvalue | NO MAXVALUE | NOMAXVALUE ]
[ START [ WITH | = ] start ] 
[ CACHE [=] cache | NOCACHE ] [ CYCLE | NOCYCLE] 
[table_options]

Параметры для CREATE SEQUENCE могут быть указаны в любом порядке, необязательно после чего следует table_options.

table_options может быть любым из обычных параметров таблицы в СОЗДАТЬ ТАБЛИЦУ, но наиболее полезными являются ENGINE=... и COMMENT=.

NOMAXVALUE и NOMINVALUE предназначены для создания ПОСЛЕДОВАТЕЛЬНОСТЕЙ с использованием синтаксиса Oracle.

Описание

СОЗДАТЬ ПОСЛЕДОВАТЕЛЬНОСТЬ создаст последовательность, генерирующую новые значения при вызове с NEXT VALUE FOR sequence_name. Это альтернатива АВТОИНКРЕМЕНТУ, когда требуется больший контроль над генерированием чисел. Поскольку ПОСЛЕДОВАТЕЛЬНОСТЬ кэширует значения (до CACHE значений), в некоторых случаях она может быть значительно быстрее, чем АВТОИНКРЕМЕНТ. Ещё одним преимуществом является доступ к последнему сгенерированному значению всех используемых последовательностей, что решает одну из ограничений LAST_INSERT_ID().

СОЗДАТЬ ПОСЛЕДОВАТЕЛЬНОСТЬ требует привилегии СОЗДАНИЯ.

УДАЛИТЬ ПОСЛЕДОВАТЕЛЬНОСТЬ может быть использовано для удаления последовательности, а ИЗМЕНИТЬ ПОСЛЕДОВАТЕЛЬНОСТЬ — для её изменения.

Аргументы для создания

Можно использовать следующие параметры:

Если используется CYCLE, то последовательность должна начинаться снова с MINVALUE, после того как значения закончились. Значение по умолчанию — NOCYCLE.

Ограничения на аргументы создания

Для создания корректной последовательности должны выполняться следующие условия:

• MAXVALUE >= start
• MAXVALUE > MINVALUE
• START >= MINVALUE
• MAXVALUE <= 9223372036854775806 (LONGLONG_MAX-1)
• MINVALUE >= -9223372036854775807 (LONGLONG_MIN+1)

Обратите внимание, что последовательности не могут генерировать максимальное/минимальное 64-битное число из-за ограничения MINVALUE и MAXVALUE.

Атомарные DDL

Примеры

CREATE SEQUENCE s START WITH 100 INCREMENT BY 10;

CREATE SEQUENCE s2 START WITH -100 INCREMENT BY -10;

Следующее утверждение завершается ошибкой, так как приращение конфликтует с параметрами по умолчанию

CREATE SEQUENCE s3 START WITH -100 INCREMENT BY 10;
ERROR 4082 (HY000): Sequence 'test.s3' values are conflicting

Последовательность может быть создана, указав допустимые минимальные и максимальные значения:

CREATE SEQUENCE s3 START WITH -100 INCREMENT BY 10 MINVALUE=-100 MAXVALUE=1000;

См. также

• Обзор последовательностей
• ИЗМЕНИТЬ ПОСЛЕДОВАТЕЛЬНОСТЬ
• УДАЛИТЬ ПОСЛЕДОВАТЕЛЬНОСТЬ
• Следующее значение для
• Предыдущее значение для
• SETVAL(). Установить следующее значение для последовательности.
• АВТОИНКРЕМЕНТ
• ПОКАЗАТЬ СОЗДАТЬ ПОСЛЕДОВАТЕЛЬНОСТЬ