ALTER SEQUENCE
ALTER SEQUENCE
ALTER SEQUENCE — изменить определение генератора последовательности
Синтаксис
ALTER SEQUENCE [ IF EXISTS ] имя [ 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 Не считать ошибкой, если последовательность не существует. В этом случае будет выдано замечание.
- шаг Предложение
INCREMENT BYшаг'''' является необязательным. При положительном значении шага генерируется возрастающая последовательность, при отрицательном — убывающая; если шаг не указан, сохраняется предыдущее значение. - мин_значениеNO MINVALUE Необязательное предложение
MINVALUEмин_значение'' определяет минимальное значение, которое будет генерировать данная последовательность. Если указаноNO MINVALUE'', для возрастающей последовательности этим значением будет 1, а для убывающей — -263-1. В отсутствие этих указаний будет сохранено текущее минимальное значение. - макс_значениеNO MAXVALUE Необязательное предложение
MAXVALUEмакс_значение'' определяет максимальное значение, которое будет генерировать данная последовательность. Если указаноNO MAXVALUE'', для возрастающей последовательности этим значением будет 263-1, а для убывающей — -1. В отсутствие этих указаний будет сохранено текущее максимальное значение. - начало Необязательное предложение
START WITHначало'' меняет записанное начальное значение последовательности. При этом текущее значение последовательности не меняется, а только устанавливается значение, которое будет применено будущими командамиALTER SEQUENCE RESTART''. - перезапуск Необязательное предложение
RESTART [ WITHперезапуск]меняет текущее значение последовательности. Оно равнозначно вызову функцииsetvalс параметромis_called=false: указанное значение перезапуска будет возвращено при следующем вызове функцииnextval. Отсутствие вRESTARTзначенияперезапускравносильно передаче стартового значения, записанного командойCREATE SEQUENCEили последнего установленного командойALTER SEQUENCE START WITH. - кеш Предложение
CACHEкеш'''' разрешает предварительно выделять и сохранять в памяти числа последовательности для ускорения доступа к ним. Минимальное значение равно 1 (т. е. за один раз генерируется только одно значение, кеширования нет). Если это предложение отсутствует, сохраняется старое значение размера кеша. - CYCLE Необязательное ключевое слово
CYCLEпозволяет зациклить последовательность при достижениимакс_значенияилимин_значениядля возрастающей и убывающей последовательности, соответственно. Когда этот предел достигается, следующим числом этих последовательностей будет соответственномин_значениеилимакс_значение. - NO CYCLE Если добавляется необязательное указание
NO CYCLE, при каждом вызовеnextvalпосле достижения предельного значения будет возникать ошибка. Если же указанияCYCLEиNO CYCLEотсутствуют, сохраняется предыдущее поведение зацикливания. - OWNED BY имя_таблицы.имя_столбцаOWNED BY NONE Указание
OWNED BYсвязывает последовательность с определённым столбцом таблицы, с тем чтобы при удалении этого столбца (или всей таблицы) автоматически удалилась и последовательность. Это указание заменяет любую ранее установленную связь данной последовательности. Целевая таблица должна иметь того же владельца и находиться в той же схеме, что и последовательность. УказаниеOWNED BY NONEубирает все существующие связи, обозначая последовательность «независимой». - новый_владелец Имя пользователя, назначаемого новым владельцем последовательности.
- новое_имя Новое имя последовательности.
- новая_схема Новая схема последовательности.
Замечания
Во избежание блокировки параллельных транзакций, получающих числа из одной последовательности, воздействие ALTER SEQUENCE на параметры генерирования последовательности никогда не отменяется, эти изменения необратимы и вступают в силу немедленно. Однако предложения OWNED BY, OWNER TO, RENAME TO и SET SCHEMA приводят к обычным изменениям каталога и могут быть отменены как часть транзакции.
ALTER SEQUENCE не оказывает немедленного влияния на результаты nextval в серверных процессах, кроме текущего, которые могли предварительно сгенерировать (кешировать) значения последовательности. Эти процессы заметят изменения только после того, как будут израсходованы все кешированные значения. Текущий серверный процесс реагирует на изменения сразу.
ALTER SEQUENCE не влияет на значение currval последовательности. (В PostgreSQL до версии 8.3 это могло происходить.)
По историческим причинам ALTER TABLE тоже может работать с последовательностями, но все разновидности ALTER TABLE, допустимые для управления последовательностями, равнозначны вышеперечисленным формам.
Примеры
Перезапуск последовательности serial с числа 1:
ALTER SEQUENCE serial RESTART WITH 1;
Совместимость
Оператор ALTER SEQUENCE соответствует стандарту SQL, за исключением предложений START WITH, OWNED BY, OWNER TO, RENAME TO и SET SCHEMA, являющихся расширениями Postgres Pro.