Описание

CREATE SEQUENCE создает новый генератор последовательных номеров. Это включает в себя создание и инициализацию новой специальной таблицы с одной строкой с именем name. Генератор будет принадлежать пользователю, выполнившему команду.

Если указано имя схемы, то последовательность создается в указанной схеме. В противном случае она создается в текущей схеме. Временные последовательности существуют в специальной схеме, поэтому при создании временной последовательности нельзя указывать имя схемы. Имя последовательности должно отличаться от имени любого другого отношения (таблицы, последовательности, индекса, представления, материализованного представления или внешней таблицы) в той же схеме.

После создания последовательности вы используете функции nextval, currval и setval для работы с последовательностью. Эти функции описаны в Раздел 9.17.

Хотя вы не можете обновить последовательность напрямую, вы можете использовать запрос вроде:

SELECT * FROM name;

для изучения параметров и текущего состояния последовательности. В частности, поле last_value последовательности показывает последнее значение, выделенное любой сессией. (Конечно, это значение может быть устаревшим к моменту его печати, если другие сессии активно вызывают функцию nextval).

Параметры

Примечания

Используйте DROP SEQUENCE для удаления последовательности.

Все последовательности основаны на арифметике bigint, поэтому диапазон не может превышать диапазон восьмибайтового целого числа (-9223372036854775808 до 9223372036854775807).

Поскольку вызовы функций nextval и setval никогда не откатываются, объекты последовательностей не могут быть использованы, если требуется “безразрывное” присвоение последовательных номеров. Возможно создание безразрывного присвоения путем исключающей блокировки таблицы, содержащей счетчик, но такое решение гораздо более затратное, чем использование объектов последовательностей, особенно если множество транзакций одновременно требуют последовательных номеров.

Неожиданные результаты могут быть получены, если для объекта последовательности, который будет использоваться одновременно несколькими сессиями, установлен параметр cache больше единицы. Каждая сессия будет выделять и кешировать последовательные значения последовательности во время доступа к объекту последовательности и соответственно увеличивать значение last_value объекта последовательности. Затем, следующие cache-1 использований функции nextval в этой сессии просто возвращают предварительно выделенные значения, не затрагивая объект последовательности. Таким образом, любые числа, выделенные, но не использованные в рамках сессии, будут потеряны при завершении этой сессии, что приведет к “пропускам” в последовательности.

Кроме того, хотя гарантируется, что в разных сессиях будут выделены разные значения последовательности, значения могут быть сгенерированы не последовательно, если учесть все сессии. Например, при установке параметра cache равным 10, сессия A может зарезервировать значения 1..10 и вернуть nextval=1, затем сессия B может зарезервировать значения 11..20 и вернуть nextval=11 до того, как сессия A сгенерирует nextval=2. Таким образом, при установке параметра cache равным одному можно считать, что значения nextval генерируются последовательно; при установке параметра cache больше единицы следует предполагать только то, что значения nextval все разные, а не что они генерируются строго последовательно. Кроме того, last_value будет отражать последнее зарезервированное значение любой сессией, независимо от того, было ли оно уже возвращено nextval.

Важно также учесть, что выполнение функции setval на такой последовательности не будет замечено другими сессиями до тех пор, пока они не израсходуют все предварительно выделенные значения, которые они кешировали.

Примеры

Создайте возрастающую последовательность с именем serial, начиная с 101:

CREATE SEQUENCE serial START 101;

Выберите следующий номер из этой последовательности:

SELECT nextval('serial');

 nextval
---------
     101

Выберите следующий номер из этой последовательности:

SELECT nextval('serial');

 nextval
---------
     102

Используйте эту последовательность в команде INSERT:

INSERT INTO distributors VALUES (nextval('serial'), 'nothing');

Обновите значение последовательности после команды COPY FROM:

BEGIN;
COPY distributors FROM 'input_file';
SELECT setval('serial', max(id)) FROM distributors;
END;

Совместимость

CREATE SEQUENCE соответствует стандарту SQL, за исключением следующих особенностей:

См. также