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 права доступа на последнюю использованную последовательность.