rowversion (Transact-SQL)

適用於：SQL ServerAzure SQL DatabaseAzure SQL 受控執行個體

此資料類型會公開在資料庫中自動產生的唯一二進位數字。 rowversion 通常用來作為版本戳記資料表資料列的機制。 儲存區大小為 8 位元組。 rowversion 資料類型只是會遞增的數字，因此不會保留日期或時間。 若要記錄日期或時間，請使用 datetime2 資料類型。

備註

每個資料庫都有一個計數器，會針對在資料庫內包含 rowversion 資料行的資料表所執行的每個插入或更新作業而遞增。 這個計數器是資料庫資料列版本。 這會追蹤資料庫內的相對時間，而不是可關聯於時鐘的實際時間。 資料表只能有一個 rowversion 資料行。 每次修改或插入含 rowversion 資料行的資料列時，都會在 rowversion 資料行中插入遞增的資料庫資料列版本值。 這個屬性會使 rowversion 資料行不適合作為索引鍵 (尤其是主索引鍵) 的候選項。 資料列的任何更新都會變更資料列版本值，因而會變更索引鍵值。 如果資料行在主索引鍵中，舊的索引鍵值便不再有效，參考舊值的外部索引鍵也不再有效。 如果動態資料指標參考資料表，所有更新都會變更資料列在資料指標中的位置。 如果資料行在索引鍵中，資料列的所有更新也會產生索引的更新。 rowversion 值會隨著任何 update 陳述式而遞增，即使沒有變更任何資料列值。 (例如，若資料行值為 5，而 update 陳述式將該值設為 5，即使沒有任何變更，此動作仍然會被視為更新；因此 rowversion 便會遞增。)

timestamp 是 rowversion 資料類型的同義字，遵照資料類型同義字的行為。 在 DDL 陳述式中，請盡可能的使用 rowversion 而非 timestamp。 如需詳細資訊，請參閱資料類型同義字 (Transact-SQL)。

Transact-SQL timestamp 資料類型不同於 ISO 標準中所定義的 timestamp 資料類型。

注意

timestamp 語法已淘汰。 SQL Server 的未來版本將移除此功能。 請避免在新的開發工作中使用這項功能，並規劃修改目前使用這項功能的應用程式。

在 CREATE TABLE 或 ALTER TABLE 陳述式中，您不需要指定 timestamp 資料類型的資料行名稱，例如：

CREATE TABLE ExampleTable (PriKey int PRIMARY KEY, timestamp);  

如果您沒有指定資料行名稱，SQL Server 資料庫引擎會產生 timestamp 資料行名稱；不過，rowversion 同義字不會遵循這個行為。 當您使用 rowversion 時，您必須指定一個資料行名稱，例如：

CREATE TABLE ExampleTable2 (PriKey int PRIMARY KEY, VerCol rowversion) ;  

注意

您可以使用 SELECT INTO 陳述式來產生重複的 rowversion 值，rowversion 資料行在 SELECT 清單中。 我們不建議您以這個方式來使用 rowversion。

不可為 Null 的rowversion 資料行，語意等於 binary(8) 資料行。 可為 Null 的 rowversion 資料行，語意等於 varbinary(8) 資料行。

您可以使用資料列的 rowversion 資料行來輕鬆地判斷自上一次讀取以來，是否已對該資料列執行過 update 陳述式。 若已針對該資料列執行 update 陳述式，則 rowversion 值便會更新。 若沒有針對該資料列執行 update 陳述式，則 rowversion 值便會與先前讀取時相同。 如需傳回資料庫目前的 rowversion 值，請使用 @@DBTS。

您可以將 rowversion 資料行新增至資料表，以確保能在多個使用者同時更新資料列時維護資料庫的完整性。 您可能也想在不必重新查詢資料表的情況下，知道更新了多少資料列以及更新了哪些資料列。

例如，假設您要建立名為 MyTest 的資料表。 您可透過執行下列 Transact-SQL 陳述式，在資料表中填入部分資料。

CREATE TABLE MyTest (myKey int PRIMARY KEY  
    ,myValue int, RV rowversion);  
GO   
INSERT INTO MyTest (myKey, myValue) VALUES (1, 0);  
GO   
INSERT INTO MyTest (myKey, myValue) VALUES (2, 0);  
GO  

然後可以使用下列的範例 Transact-SQL 陳述式，在更新期間將開放式並行存取控制項實作於 MyTest 資料表。 指令碼會使用 <myRv> 代表上次讀取資料列時的 rowversion 值。 請以實際的 rowversion 值取代此值。 0x00000000000007D3 是實際 rowversion 值的範例。

DECLARE @t TABLE (myKey int);  
UPDATE MyTest  
SET myValue = 2  
    OUTPUT inserted.myKey INTO @t(myKey)   
WHERE myKey = 1   
    AND RV = <myRv>;  
IF (SELECT COUNT(*) FROM @t) = 0  
    BEGIN  
        RAISERROR ('error changing row with myKey = %d'  
            ,16 -- Severity.  
            ,1 -- State   
            ,1) -- myKey that was changed   
    END;  

您也可以將範例 Transact-SQL 陳述式放入交易中。 您可以透過在交易的範圍中查詢 @t 變數來擷取資料表已更新的 myKey 資料行，而不必重新查詢 MyTest 資料表。

下列為使用時間戳記語法的相同範例。 以實際的時間戳記取代 <myTS>。

CREATE TABLE MyTest2 (myKey int PRIMARY KEY  
    ,myValue int, TS timestamp);  
GO   
INSERT INTO MyTest2 (myKey, myValue) VALUES (1, 0);  
GO   
INSERT INTO MyTest2 (myKey, myValue) VALUES (2, 0);  
GO  
DECLARE @t TABLE (myKey int);  
UPDATE MyTest2  
SET myValue = 2  
    OUTPUT inserted.myKey INTO @t(myKey)   
WHERE myKey = 1   
    AND TS = <myTS>;  
IF (SELECT COUNT(*) FROM @t) = 0  
    BEGIN  
        RAISERROR ('error changing row with myKey = %d'  
            ,16 -- Severity.  
            ,1 -- State   
            ,1) -- myKey that was changed   
    END;  

另請參閱

ALTER TABLE (Transact-SQL)
CAST 和 CONVERT (Transact-SQL)
CREATE TABLE (Transact-SQL)
資料類型 (Transact-SQL)
DECLARE @local_variable (Transact-SQL)
DELETE (Transact-SQL)
INSERT (Transact-SQL)
MIN_ACTIVE_ROWVERSION (Transact-SQL)
SET @local_variable (Transact-SQL)
UPDATE (Transact-SQL)