nextval ( regclass ) → bigint

Продвигает объект последовательности к следующему значению и возвращает это значение. Это делается атомарно: даже если несколько сессий одновременно выполняют функцию nextval, каждый из них безопасно получит отдельное значение последовательности. Если объект последовательности был создан с параметрами по умолчанию, последовательные вызовы функции nextval будут возвращать последовательные значения, начиная с 1. Другие варианты поведения могут быть получены с использованием соответствующих параметров в команде CREATE SEQUENCE.

Эта функция требует наличия привилегий USAGE или UPDATE для последовательности.

setval ( regclass, bigint [, boolean ] ) → bigint

Устанавливает текущее значение объекта последовательности и, при необходимости, его флаг is_called. В двухпараметрической форме устанавливается поле last_value последовательности в указанное значение и устанавливается поле is_called в true, что означает, что следующий вызов функции nextval продвинет последовательность перед возвратом значения. Значение, которое будет возвращено функцией currval, также устанавливается в указанное значение. В трехпараметрической форме is_called может быть установлено как true, так и false. true имеет тот же эффект, что и двухпараметрическая форма. Если установлено значение false, следующий вызов функции nextval вернет точно указанное значение, и продвижение последовательности начнется со следующего вызова функции nextval. Кроме того, значение, возвращаемое функцией currval, в этом случае не изменяется. Например,

SELECT setval('myseq', 42);           Следующая функция nextval вернет 43
SELECT setval('myseq', 42, true);     То же самое, что и выше
SELECT setval('myseq', 42, false);    Следующая функция nextval вернет 42

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

Эта функция требует наличия привилегии UPDATE для последовательности.

currval ( regclass ) → bigint

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

Эта функция требует привилегий USAGE или SELECT для последовательности.

lastval () → bigint

Возвращает значение, которое было последним возвращено функцией nextval в текущей сессии. Эта функция идентична функции currval, за исключением того, что вместо принятия имени последовательности в качестве аргумента она ссылается на последовательность, к которой функция nextval была последний раз применена в текущей сессии. Вызов функции lastval является ошибкой, если функция nextval еще не была вызвана в текущей сессии.

Эта функция требует привилегий USAGE или SELECT на последовательности, которая была использована последней.