ALTER SEQUENCE (Transact-SQL)

 

修改现有序列对象的参数。如果该序列是使用 CACHE 选项创建的,则改变序列将重新创建缓存。

序列对象是通过使用 CREATE SEQUENCE 语句创建的。序列是整数值,可以是返回整数的任何数据类型。使用 ALTER SEQUENCE 语句无法更改数据类型。若要更改数据类型,请删除或创建序列对象。

序列对象是用户定义的绑定到架构的对象,用于可根据规范生成数值序列。通过调用 NEXT VALUE FOR 函数,从序列中生成新值。使用 sp_sequence_get_range 同时获取多个序列号。有关同时使用 CREATE SEQUENCE、sp_sequence_get_range 和 NEXT VALUE FOR 函数的信息和方案,请参阅序列号

适用范围:SQL Server(SQL Server 2012 到当前版本) SQL 数据库 V12。

主题链接图标Transact-SQL 语法约定

语法

ALTER SEQUENCE [schema_name. ] sequence_name
    [ RESTART [ WITH <constant> ] ]
    [ INCREMENT BY <constant> ]
    [ { MINVALUE <constant> } | { NO MINVALUE } ]
    [ { MAXVALUE <constant> } | { NO MAXVALUE } ]
    [ CYCLE | { NO CYCLE } ]
    [ { CACHE [ <constant> ] } | { NO CACHE } ]
    [ ; ]

参数

  • sequence_name
    指定数据库中标识序列的唯一名称。类型为 sysname

  • RESTART [ WITH <constant> ]
    将由序列对象返回的下一个值。如果提供,则 RESTART WITH 值必须是小于或等于序列对象的最大值并大于或等于其最小值的整数。如果忽略 WITH 值,则序列编号将根据原始 CREATE SEQUENCE 选项重新开始。

  • INCREMENT BY <constant>
    用于在每次调用 NEXT VALUE FOR 函数时递增(如果为负数,则为递减)序列对象的基值的值。如果增量是负值,则序列对象为降序,否则为升序。增量不能为 0。

  • [ MINVALUE <constant> | NO MINVALUE ]
    指定序列对象的边界。如果指定 NO MINVALUE,则使用序列数据类型的最小可能值。

  • [ MAXVALUE <constant> | NO MAXVALUE
    指定序列对象的边界。如果指定 NO MAXVALUE,则使用序列数据类型的最大可能值。

  • [ CYCLE | NO CYCLE ]
    此属性指定当超过序列对象的最小值或最大值时,序列对象是应从最小值(对于降序对象,则为最大值)重新开始,还是应引发异常。

    备注

    在循环后,下一个值为最小值或最大值,而不是序列的 START VALUE(起始值)。

  • [ CACHE [<constant> ] | NO CACHE ]
    通过最大限度地减少将生成的值持久保存到系统表中所需的 IO 数,可以提高使用序列对象的应用程序的性能。

    有关缓存的行为的详细信息,请参阅 CREATE SEQUENCE (Transact-SQL)

备注

有关如何创建序列以及如何管理序列缓存的信息,请参阅 CREATE SEQUENCE (Transact-SQL)

不能将表示升序的 MINVALUE 和表示降序的 MAXVALUE 更改为不允许序列的 START WITH 值的值。如果要将升序的 MINVALUE 更改为一个大于 START WITH 值的数字,或者将降序的 MAXVALUE 更改为小于 START WITH 值的数字,请加入 RESTART WITH 参数,以便在最小值和最大值范围内的所需点重新开始序列。

元数据

有关序列的信息,请查询 sys.sequences

安全性

权限

要求对序列拥有 ALTER 权限或对架构拥有 ALTER 权限。若要授予针对序列的 ALTER 权限,请按以下格式使用 ALTER ON OBJECT 对象:

GRANT ALTER ON OBJECT::Test.TinySeq TO [AdventureWorks\Larry]

可以通过使用 ALTER AUTHORIZATION 语句转让序列对象的所有权。

审核

若要审核 ALTER SEQUENCE,请监视 SCHEMA_OBJECT_CHANGE_GROUP

示例

有关创建序列和使用 NEXT VALUE FOR 函数生成序列号的示例,请参阅序列号

A.更改序列

Test下面的示例使用 TestSeq 数据类型(范围为 0 到 255 之间)创建一个名为 TestSeq 的架构和一个名为 int 的序列。序列以 125 开始,每次生成数字时递增 25。因为该序列配置为可循环,所以,当值超过最大值 200 时,序列将从最小值 100 重新开始。

CREATE SCHEMA Test ;
GO

CREATE SEQUENCE Test.TestSeq
    AS int 
    START WITH 125
    INCREMENT BY 25
    MINVALUE 100
    MAXVALUE 200
    CYCLE
    CACHE 3
;
GO

TestSeq下面的示例更改 序列,使范围介于 0 到 255 之间。序列以 100 重新开始编号系列,每次生成数字时递增 50。

ALTER SEQUENCE Test. TestSeq
    RESTART WITH 100
    INCREMENT BY 50
    MINVALUE 50
    MAXVALUE 200
    NO CYCLE
    NO CACHE
;
GO

因为此序列不循环,所以,当序列超过 200 时,NEXT VALUE FOR 函数将导致错误。

B.重新开始序列

CountBy1以下示例将创建一个名为 的序列。该序列使用默认值。

CREATE SEQUENCE Test.CountBy1 ;

若要生成序列值,所有者随后应执行下列语句:

SELECT NEXT VALUE FOR Test.CountBy1

返回的值 -9,223,372,036,854,775,808 是 bigint 数据类型的最小值。所有者认识到他原来希望序列从 1 开始,但创建序列时没有指定 START WITH 子句。若要更正此错误,所有者应执行下面的语句。

ALTER SEQUENCE Test.CountBy1 RESTART WITH 1 ;

然后,所有者再次执行下列语句以生成序列号。

SELECT NEXT VALUE FOR Test.CountBy1;

数字现在是 1,与预期相符。

CountBy1 序列是使用默认值 NO CYCLE 创建的,因此,在生成数字 9,223,372,036,854,775,807 后,它将停止运行。对序列对象的后续调用将返回错误 11728。下面的语句将序列对象更改为循环,并将缓存设置为 20。

ALTER SEQUENCE Test.CountBy1
    CYCLE
    CACHE 20 ;

现在,当序列对象达到 9,223,372,036,854,775,807 时,它将循环,循环后的下一个编号将为此数据类型的最小值,即 -9,223,372,036,854,775,808。

所有者意识到每次使用 bigint 数据类型时都将占用 8 个字节。使用 4 个字节的 int 数据类型就足够了。但是,不能更改序列对象的数据类型。若要更改为 int 数据类型,所有者必须删除序列对象,并使用正确的数据类型重新创建对象。

请参阅

CREATE SEQUENCE (Transact-SQL)
DROP SEQUENCE (Transact-SQL)
NEXT VALUE FOR (Transact-SQL)
序列号
sp_sequence_get_range (Transact-SQL)