序號 - SQL Server | Microsoft Learn

link管理

链接快照平台

输入网页链接，自动生成快照
标签化管理网页链接

相关文章推荐

读研的充电器 · mysql日期只比较年月日 ...· 2 周前 ·

大力的松鼠 · Mysql比较日期和时间 - · 2 周前 ·

帅气的牛肉面 · 【SQL】COUNT()函数 ...· 1 周前 ·

微笑的汉堡包 · Sybase·调用存储过程并返回结果· 1 周前 ·

绅士的水煮肉 · Sequence 使用、原理全面解析 · ...· 1 周前 ·

想出家的乒乓球 · 刘天明-深圳大学艺术学部· 3 月前 ·

严肃的闹钟 · 为生活解压加油“治愈风”综艺提振精神力量· 4 月前 ·

痴情的帽子 · PHP 获取当天以及未来一个月的日期 - ...· 4 月前 ·

阳刚的数据线 · 弗朗西斯亲笔长文回顾与姚明友谊：我的兄弟姚_ ...· 5 月前 ·

考研的松树 · CSS ...· 6 月前 ·

適用於： SQL Server Azure SQL Database Azure SQL 受控執行個體

序列是使用者定義的結構描述繫結物件，該物件會根據建立順序所使用的規格產生數值序列。數值序列是在定義的間隔依照遞增或遞減順序來產生，而且可依照要求循環 (重複)。與識別欄位不同的是，順序不會與資料表產生關聯。應用程式會參考順序物件，以擷取它的下一個值。順序與資料表之間的關聯性是由應用程式所控制。使用者應用程式可以參考順序物件，並協調跨越多個資料列和資料表的值索引鍵。

順序是使用 CREATE SEQUENCE 陳述式所建立，與資料表無關。有一些選項可讓您控制遞增、最大和最小值、起點、自動重新啟動功能與快取以改善效能。如需有關這些選項的詳細資訊，請參閱 CREATE SEQUENCE 。

不同於插入資料列時產生的識別欄位值，應用程式可以藉由呼叫 NEXT VALUE FOR 函數，在插入資料列之前取得下一個序號。此序號是在呼叫 NEXT VALUE FOR 時配置的，即使該編號從未插入資料表也一樣。 NEXT VALUE FOR 函數可當做資料表定義中資料行的預設值使用。您可以使用 sp_sequence_get_range 一次取得多個序號範圍。

順序可以定義為任何整數資料類型。如果沒有指定資料類型，順序就會預設為 bigint 。

在下列案例中，您可以使用順序來取代識別欄位：

進行插入資料表的作業之前，應用程式需要一個編號。

應用程式需要在多個資料表或資料表中多個資料行之間共用單一編號序列。

達到指定的編號時，應用程式必須重新啟動編號序列。例如，指派 1 到 10 的值之後，應用程式就會再次開始指派 1 到 10 的值。

應用程式要求依照另一個欄位排序順序值。 NEXT VALUE FOR 函數可以將 OVER 子句套用至函數呼叫。 OVER 子句會確保傳回的值都按照 OVER 子句之 ORDER BY 子句的順序來產生。

應用程式要求同時指派多個編號。例如，應用程式需要保留五個序號。如果同時針對其他處理序發出編號，要求識別值可能會在序列中產生間距。呼叫 sp_sequence_get_range 可以一次擷取順序中的許多編號。

您必須變更順序的規格，例如遞增值。

不同於無法變更其值的識別欄位，當順序值插入資料表之後，並不會自動受保護。若要防止順序值變更，請在資料表上使用更新觸發程序來回復變更。

系統不會針對順序值自動強制執行唯一性。重複使用順序值的能力是依照設計提供的。如果資料表中的序列值必須是唯一的，請在資料行上建立唯一條件約束。如果資料表中的順序值在整個資料表群組中必須是唯一的，請建立觸發程序來防止更新陳述式或序號循環所導致的重複項目。

雖然順序物件會根據其定義產生編號，不過順序物件不會控制編號的使用方式。當您回復交易時、當多個資料表共用順序物件時，或者當您配置序號而沒有將它們用於資料表時，插入資料表中的序號可能會產生間距。以 CACHE 選項建立時，非預期關閉 (例如停電) 可能會失去快取中的序號。

如果單一陳述式具有多個指定相同順序產生器的 NEXT VALUE FOR 函式執行個體，所有執行個體都會針對該 Transact-SQL 陳述式所處理的給定資料列傳回相同的值。這種行為與 ANSI 標準一致。

序號是在目前交易範圍之外產生的。無論使用序號的交易被認可或回復交易，都會耗用序號。只有在填完記錄之後才會出現重複驗證。這會導致在某些情況下，同一個數字會在建立期間用於多筆記錄，但會識別為重複項目。如果發生這種情況，而且已將其他自動編號值套用至後續記錄，這會導致自動編號值之間出現間距。

若要建立從 -2,147,483,648 到 2,147,483,647 且遞增量為 1 的整數序號，請使用下列陳述式。

CREATE SEQUENCE Schema.SequenceName  
    AS int  
    INCREMENT BY 1 ;  
若要建立從 1 到 2,147,483,647 且遞增量為 1 的整數序號 (類似於識別欄位)，請使用下列陳述式。
CREATE SEQUENCE Schema.SequenceName  
    AS int  
    START WITH 1  
    INCREMENT BY 1 ;  
如需有關順序的詳細資訊，請查詢 sys.sequences。
CREATE SEQUENCE (Transact-SQL)、NEXT VALUE FOR (Transact-SQL) 和 sp_sequence_get_range 主題中有其他範例。
A. 在單一資料表中使用序號
下列範例會建立名為 Test 的結構描述、名為 Orders 的資料表，以及名為 CountBy1 的順序，然後使用 NEXT VALUE FOR 函數，將資料列插入資料表。
--Create the Test schema  
CREATE SCHEMA Test ;  
-- Create a table  
CREATE TABLE Test.Orders  
    (OrderID int PRIMARY KEY,  
    Name varchar(20) NOT NULL,  
    Qty int NOT NULL);  
-- Create a sequence  
CREATE SEQUENCE Test.CountBy1  
    START WITH 1  
    INCREMENT BY 1 ;  
-- Insert three records  
INSERT Test.Orders (OrderID, Name, Qty)  
    VALUES (NEXT VALUE FOR Test.CountBy1, 'Tire', 2) ;  
INSERT test.Orders (OrderID, Name, Qty)  
    VALUES (NEXT VALUE FOR Test.CountBy1, 'Seat', 1) ;  
INSERT test.Orders (OrderID, Name, Qty)  
    VALUES (NEXT VALUE FOR Test.CountBy1, 'Brake', 1) ;  
-- View the table  
SELECT * FROM Test.Orders ;  
以下為結果集。
OrderID  Name    Qty
1        Tire    2
2        Seat    1
3        Brake   1
B. 在插入資料列之前呼叫 NEXT VALUE FOR
下列範例會使用在範例 A 中建立的 Orders 資料表來宣告名為 @nextID的變數，然後使用 NEXT VALUE FOR 函數，將此變數設定為下一個可用的序號。 應用程式應該會針對訂單進行一些處理，例如為客戶提供其潛在訂單的 OrderID 編號，然後驗證訂單。 不論這項處理可能需要多少時間，或者在處理期間加入其他多少訂單，原始的編號都會保留給這個連接使用。 最後， INSERT 陳述式會將訂單加入至 Orders 資料表。
DECLARE @NextID int ;  
SET @NextID = NEXT VALUE FOR Test.CountBy1;  
-- Some work happens  
INSERT Test.Orders (OrderID, Name, Qty)  
    VALUES (@NextID, 'Rim', 2) ;  
C. 在多個資料表中使用序號
這個範例會假設生產線監視處理序接收整個工廠所發生之事件的通知。 每個事件都會接收唯一且單純遞增的 EventID 編號。 所有事件都會使用相同的 EventID 序號，讓結合所有事件的報表能夠唯一識別每個事件。 不過，事件資料會根據事件的類型儲存在三個不同的資料表中。 此程式碼範例會建立名為 Audit的結構描述、名為 EventCounter的順序，以及三個資料表，而且每個資料表都使用 EventCounter 順序作為預設值。 然後，此範例會將資料列加入至三個資料表並查詢結果。
CREATE SCHEMA Audit ;  
CREATE SEQUENCE Audit.EventCounter  
    AS int  
    START WITH 1  
    INCREMENT BY 1 ;  
CREATE TABLE Audit.ProcessEvents  
    EventID int PRIMARY KEY CLUSTERED   
        DEFAULT (NEXT VALUE FOR Audit.EventCounter),  
    EventTime datetime NOT NULL DEFAULT (getdate()),  
    EventCode nvarchar(5) NOT NULL,  
    Description nvarchar(300) NULL  
CREATE TABLE Audit.ErrorEvents  
    EventID int PRIMARY KEY CLUSTERED  
        DEFAULT (NEXT VALUE FOR Audit.EventCounter),  
    EventTime datetime NOT NULL DEFAULT (getdate()),  
    EquipmentID int NULL,  
    ErrorNumber int NOT NULL,  
    EventDesc nvarchar(256) NULL  
CREATE TABLE Audit.StartStopEvents  
    EventID int PRIMARY KEY CLUSTERED  
        DEFAULT (NEXT VALUE FOR Audit.EventCounter),  
    EventTime datetime NOT NULL DEFAULT (getdate()),  
    EquipmentID int NOT NULL,  
    StartOrStop bit NOT NULL  
INSERT Audit.StartStopEvents (EquipmentID, StartOrStop)   
    VALUES (248, 0) ;  
INSERT Audit.StartStopEvents (EquipmentID, StartOrStop)   
    VALUES (72, 0) ;  
INSERT Audit.ProcessEvents (EventCode, Description)   
    VALUES (2735,   
    'Clean room temperature 18 degrees C.') ;  
INSERT Audit.ProcessEvents (EventCode, Description)   
    VALUES (18, 'Spin rate threashold exceeded.') ;  
INSERT Audit.ErrorEvents (EquipmentID, ErrorNumber, EventDesc)   
    VALUES (248, 82, 'Feeder jam') ;  
INSERT Audit.StartStopEvents (EquipmentID, StartOrStop)   
    VALUES (248, 1) ;  
INSERT Audit.ProcessEvents (EventCode, Description)   
    VALUES (1841, 'Central feed in bypass mode.') ;  
-- The following statement combines all events, though not all fields.  
SELECT EventID, EventTime, Description FROM Audit.ProcessEvents   
UNION SELECT EventID, EventTime, EventDesc FROM Audit.ErrorEvents   
UNION SELECT EventID, EventTime,   
CASE StartOrStop   
    WHEN 0 THEN 'Start'   
    ELSE 'Stop'  
FROM Audit.StartStopEvents  
ORDER BY EventID ;  
以下為結果集。
EventID  EventTime                Description
1        2009-11-02 15:00:51.157  Start
2        2009-11-02 15:00:51.160  Start
3        2009-11-02 15:00:51.167  Clean room temperature 18 degrees C.
4        2009-11-02 15:00:51.167  Spin rate threshold exceeded.
5        2009-11-02 15:00:51.173  Feeder jam
6        2009-11-02 15:00:51.177  Stop
7        2009-11-02 15:00:51.180  Central feed in bypass mode.
D. 在結果集中產生重複的序號
下列範例會示範序號的兩種功能：循環以及在 SELECT 陳述式中使用 NEXT VALUE FOR 。
CREATE SEQUENCE CountBy5  
   AS tinyint  
    START WITH 1  
    INCREMENT BY 1  
    MINVALUE 1  
    MAXVALUE 5  
    CYCLE ;  
SELECT NEXT VALUE FOR CountBy5 AS SurveyGroup, Name FROM sys.objects ;  
E. 使用 OVER 子句來產生結果集的序號
下列範例會使用 OVER 子句並依照 Name 排序結果集，然後再加入序號資料行。
USE AdventureWorks2022;  
CREATE SCHEMA Samples ;  
CREATE SEQUENCE Samples.IDLabel  
    AS tinyint  
    START WITH 1  
    INCREMENT BY 1 ;  
SELECT NEXT VALUE FOR Samples.IDLabel OVER (ORDER BY Name) AS NutID, ProductID, Name, ProductNumber FROM Production.Product  
WHERE Name LIKE '%nut%' ;  
F. 重設序號
範例 E 取用了前 79 個 Samples.IDLabel 序號 (您的 AdventureWorks2022 版本可能會傳回不同的結果數目)。請執行下列陳述式來取用後續 79 個序號 (80 到 158)。
SELECT NEXT VALUE FOR Samples.IDLabel OVER (ORDER BY Name) AS NutID, ProductID, Name, ProductNumber FROM Production.Product  
WHERE Name LIKE '%nut%' ;  
請執行下列陳述式來重新啟動 Samples.IDLabel 順序。
ALTER SEQUENCE Samples.IDLabel  
RESTART WITH 1 ;  
請再次執行 SELECT 陳述式，以便確認 Samples.IDLabel 順序從編號 1 重新啟動。
SELECT NEXT VALUE FOR Samples.IDLabel OVER (ORDER BY Name) AS NutID, ProductID, Name, ProductNumber FROM Production.Product  
WHERE Name LIKE '%nut%' ;  
G. 將資料表從識別變更為順序
下列範例會建立結構描述以及包含範例中三個資料列的資料表。 然後，此範例會加入新的資料行並卸除舊的資料行。
-- Create a schema  
CREATE SCHEMA Test ;  
-- Create a table  
CREATE TABLE Test.Department  
        DepartmentID smallint IDENTITY(1,1) NOT NULL,  
        Name nvarchar(100) NOT NULL,  
        GroupName nvarchar(100) NOT NULL  
    CONSTRAINT PK_Department_DepartmentID PRIMARY KEY CLUSTERED   
         (DepartmentID ASC)   
-- Insert three rows into the table  
INSERT Test.Department(Name, GroupName)  
    VALUES ('Engineering', 'Research and Development');  
INSERT Test.Department(Name, GroupName)  
    VALUES ('Tool Design', 'Research and Development');  
INSERT Test.Department(Name, GroupName)  
    VALUES ('Sales', 'Sales and Marketing');  
-- View the table that will be changed  
SELECT * FROM Test.Department ;  
-- End of portion creating a sample table  
--------------------------------------------------------  
-- Add the new column that does not have the IDENTITY property  
ALTER TABLE Test.Department   
    ADD DepartmentIDNew smallint NULL  
-- Copy values from the old column to the new column  
UPDATE Test.Department  
    SET DepartmentIDNew = DepartmentID ;  
-- Drop the primary key constraint on the old column  
ALTER TABLE Test.Department  
    DROP CONSTRAINT [PK_Department_DepartmentID];  
-- Drop the old column  
ALTER TABLE Test.Department  
    DROP COLUMN DepartmentID ;  
-- Rename the new column to the old columns name  
EXEC sp_rename 'Test.Department.DepartmentIDNew',   
    'DepartmentID', 'COLUMN';  
-- Change the new column to NOT NULL  
ALTER TABLE Test.Department  
    ALTER COLUMN DepartmentID smallint NOT NULL ;  
-- Add the unique primary key constraint  
ALTER TABLE Test.Department  
    ADD CONSTRAINT PK_Department_DepartmentID PRIMARY KEY CLUSTERED   
         (DepartmentID ASC) ;  
-- Get the highest current value from the DepartmentID column   
-- and create a sequence to use with the column. (Returns 3.)  
SELECT MAX(DepartmentID) FROM Test.Department ;  
-- Use the next desired value (4) as the START WITH VALUE;  
CREATE SEQUENCE Test.DeptSeq  
    AS smallint  
    START WITH 4  
    INCREMENT BY 1 ;  
-- Add a default value for the DepartmentID column  
ALTER TABLE Test.Department  
    ADD CONSTRAINT DefSequence DEFAULT (NEXT VALUE FOR Test.DeptSeq)   
        FOR DepartmentID;  
-- View the result  
SELECT DepartmentID, Name, GroupName  
FROM Test.Department ;   
-- Test insert  
INSERT Test.Department (Name, GroupName)  
    VALUES ('Audit', 'Quality Assurance') ;  
-- View the result  
SELECT DepartmentID, Name, GroupName  
FROM Test.Department ;  
使用 SELECT * 的 Transact-SQL 陳述式將收到新的資料行做為最後一個資料行，而非第一個資料行。 如果這是無法接受的資料行，您就必須建立全新的資料表、將資料移入其中，然後重新建立新資料表的權限。
CREATE SEQUENCE (Transact-SQL)
ALTER SEQUENCE (Transact-SQL)
DROP SEQUENCE (Transact-SQL)
IDENTITY (屬性) (Transact-SQL)