ALTER SEQUENCE
ALTER SEQUENCE — изменить определение генератора последовательности
Синтаксис
ALTER SEQUENCE [ IF EXISTS ]имя
[ ASтип_данных
] [ INCREMENT [ BY ]шаг
] [ MINVALUEмин_значение
| NO MINVALUE ] [ MAXVALUEмакс_значение
| NO MAXVALUE ] [ START [ WITH ]начало
] [ RESTART [ [ WITH ]перезапуск
] ] [ CACHEкеш
] [ [ NO ] CYCLE ] [ OWNED BY {имя_таблицы
.имя_столбца
| NONE } ] ALTER SEQUENCE [ IF EXISTS ]имя
SET { LOGGED | UNLOGGED } ALTER SEQUENCE [ IF EXISTS ]имя
OWNER TO {новый_владелец
| CURRENT_ROLE | CURRENT_USER | SESSION_USER } ALTER SEQUENCE [ IF EXISTS ]имя
RENAME TOновое_имя
ALTER SEQUENCE [ IF EXISTS ]имя
SET SCHEMAновая_схема
Описание
ALTER SEQUENCE
меняет параметры существующего генератора последовательности. Параметры, не определяемые явно в команде ALTER SEQUENCE
, сохраняют свои предыдущие значения.
Выполнить ALTER SEQUENCE
может только владелец соответствующей последовательности. Чтобы сменить схему последовательности, необходимо также иметь право CREATE
в новой схеме. Чтобы сменить владельца, необходимо иметь право SET ROLE
для новой роли-владельца, а эта роль должна иметь право CREATE
в схеме последовательности. (С такими ограничениями при смене владельца не происходит ничего такого, что нельзя было бы сделать, имея право удалить и вновь создать последовательность. Однако суперпользователь может сменить владельца последовательности в любом случае.)
Параметры
имя
Имя (возможно, дополненное схемой) последовательности, подлежащей изменению.
IF EXISTS
Не считать ошибкой, если последовательность не существует. В этом случае будет выдано замечание.
тип_данных
Необязательное предложение
AS
меняет тип данных для последовательности. Допустимые типы:тип_данных
smallint
,integer
иbigint
.При изменении типа данных автоматически меняются минимальное и максимальное значения последовательности, в том и только в том случае, если это были минимальные и максимальные значения старого типа данных (другими словами, если последовательность была создана со свойствами
NO MINVALUE
илиNO MAXVALUE
, неявно или явно). В противном случае минимальные и максимальные значения сохраняются, если только в этой же команде не указаны новые значения. Если минимальное/максимальное значение не умещается в новом типе данных, выдаётся ошибка.шаг
Предложение
INCREMENT BY
является необязательным. При положительном значении шага генерируется возрастающая последовательность, при отрицательном — убывающая; если шаг не указан, сохраняется предыдущее значение.шаг
мин_значение
NO MINVALUE
Необязательное предложение
MINVALUE
определяет минимальное значение, которое будет генерировать данная последовательность. Если указаномин_значение
NO MINVALUE
, для возрастающей последовательности этим значением будет 1, а для убывающей — минимальное число для её типа данных. В отсутствие этих указаний будет сохранено текущее минимальное значение.макс_значение
NO MAXVALUE
Необязательное предложение
MAXVALUE
определяет максимальное значение, которое будет генерировать данная последовательность. Если указаномакс_значение
NO MAXVALUE
, для возрастающей последовательности этим значением будет максимальное число для её типа данных, а для убывающей — -1. В отсутствие этих указаний будет сохранено текущее максимальное значение.начало
Необязательное предложение
START WITH
меняет записанное начальное значение последовательности. При этом текущее значение последовательности не меняется, а только устанавливается значение, которое будет применено будущими командаминачало
ALTER SEQUENCE RESTART
.перезапуск
Необязательное предложение
RESTART [ WITH
меняет текущее значение последовательности. Оно подобно вызову функцииперезапуск
]setval
с параметромis_called
=false
: указанное значение перезапуска будет возвращено при следующем вызове функцииnextval
. Отсутствие вRESTART
значенияперезапуск
равносильно передаче стартового значения, записанного командойCREATE SEQUENCE
или последнего установленного командойALTER SEQUENCE START WITH
.В отличие от вызова
setval
, операцияRESTART
с последовательностью является транзакционной и не даёт параллельным транзакциям получать числа из той же последовательности. Если это поведение не устраивает, следует воспользоваться функциейsetval
.кеш
Предложение
CACHE
разрешает предварительно выделять и сохранять в памяти числа последовательности для ускорения доступа к ним. Минимальное значение равно 1 (т. е. за один раз генерируется только одно значение, кеширования нет). Если это предложение отсутствует, сохраняется старое значение размера кеша.кеш
CYCLE
Необязательное ключевое слово
CYCLE
позволяет зациклить последовательность при достижениимакс_значения
илимин_значения
для возрастающей и убывающей последовательности, соответственно. Когда этот предел достигается, следующим числом этих последовательностей будет соответственномин_значение
илимакс_значение
.NO CYCLE
Если добавляется необязательное указание
NO CYCLE
, при каждом вызовеnextval
после достижения предельного значения будет возникать ошибка. Если же указанияCYCLE
иNO CYCLE
отсутствуют, сохраняется предыдущее поведение зацикливания.SET { LOGGED | UNLOGGED }
Эта форма меняет характеристику журналирования последовательности, делает последовательность журналируемой/нежурналируемой соответственно (см. CREATE SEQUENCE). К временной последовательности она неприменима.
OWNED BY
имя_таблицы
.имя_столбца
OWNED BY NONE
Указание
OWNED BY
связывает последовательность с определённым столбцом таблицы, с тем чтобы при удалении этого столбца (или всей таблицы) автоматически удалилась и последовательность. Это указание заменяет любую ранее установленную связь данной последовательности. Целевая таблица должна иметь того же владельца и находиться в той же схеме, что и последовательность. УказаниеOWNED BY NONE
убирает все существующие связи, обозначая последовательность «независимой».новый_владелец
Имя пользователя, назначаемого новым владельцем последовательности.
новое_имя
Новое имя последовательности.
новая_схема
Новая схема последовательности.
Примечания
ALTER SEQUENCE
не оказывает немедленного влияния на результаты nextval
в серверных процессах, кроме текущего, которые могли предварительно сгенерировать (кешировать) значения последовательности. Эти процессы заметят изменения только после того, как будут израсходованы все кешированные значения. Текущий серверный процесс реагирует на изменения сразу.
ALTER SEQUENCE
не влияет на значение currval
последовательности. (В PostgreSQL до версии 8.3 это могло происходить.)
ALTER SEQUENCE
блокирует параллельные вызовы nextval
, currval
, lastval
и setval
.
По историческим причинам ALTER TABLE
тоже может работать с последовательностями, но все разновидности ALTER TABLE
, допустимые для управления последовательностями, равнозначны вышеперечисленным формам.
Примеры
Перезапуск последовательности serial
с числа 105:
ALTER SEQUENCE serial RESTART WITH 105;
Совместимость
Оператор ALTER SEQUENCE
соответствует стандарту SQL, за исключением предложений AS
, START WITH
, OWNED BY
, OWNER TO
, RENAME TO
и SET SCHEMA
, являющихся расширениями Postgres Pro.