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 ]имяOWNER TO {новый_владелец| CURRENT_USER | SESSION_USER } ALTER SEQUENCE [ IF EXISTS ]имяRENAME TOновое_имяALTER SEQUENCE [ IF EXISTS ]имяSET SCHEMAновая_схема
ALTER SEQUENCE меняет параметры существующего генератора последовательности. Параметры, не определяемые явно в команде ALTER SEQUENCE, сохраняют свои предыдущие значения.
Выполнить ALTER SEQUENCE может только владелец соответствующей последовательности. Чтобы сменить схему последовательности, необходимо также иметь право CREATE в новой схеме. Чтобы сменить владельца, необходимо быть непосредственным или опосредованным членом новой роли-владельца, а эта роль должна иметь право 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 отсутствуют, сохраняется предыдущее поведение зацикливания.
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, являющихся расширениями PostgreSQL.