@@IDENTITY (Transact-SQL)

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

這是傳回最後插入的識別值之系統函數。

Transact-SQL 語法慣例 (部分機器翻譯)

Syntax

@@IDENTITY  

傳回型別

numeric(38,0)

備註

在 INSERT、SELECT INTO 或大量複製陳述式完成之後，@@IDENTITY 會包含陳述式所產生的最後一個識別值。 如果陳述式並未影響任何含有識別欄位的資料表，@@IDENTITY 會傳回 NULL。 如果插入多個資料列，產生多個識別值，@@IDENTITY 會傳回最後一個產生的識別值。 如果陳述式引發一或多個執行插入來產生識別值的觸發程序，在陳述式之後緊接著呼叫 @@IDENTITY，會傳回觸發程序所產生的最後一個識別值。 如果在含有識別欄位之資料表的插入動作之後引發觸發程序，且觸發程序插入另一份沒有識別欄位的資料表，@@IDENTITY 會傳回第一次插入的識別值。 如果 INSERT 或 SELECT INTO 陳述式或大量複製失敗，或回復交易，@@IDENTITY 值不會還原成先前的設定。

失敗的陳述式和交易可能會變更資料表的目前識別，以及建立識別欄位值中的間距。 識別值永遠不會回復，即使試圖將值插入資料表的交易未獲認可，也是如此。 例如，如果 INSERT 陳述式因 IGNORE_DUP_KEY 違規而失敗，資料表的目前識別值仍會遞增。

@@IDENTITY、SCOPE_IDENTITY 和 IDENT_CURRENT 是類似的函數，因為它們都會傳回最後插入資料表之 IDENTITY 資料行的值。

@@IDENTITY 和 SCOPE_IDENTITY 會傳回目前工作階段任何資料表中所產生的最後一個識別值。 不過，SCOPE_IDENTITY 只會傳回目前範圍內的值；@@IDENTITY 不限於特定範圍。

IDENT_CURRENT 不受範圍和工作階段的限制；它只限於指定的資料表。 IDENT_CURRENT 會傳回在任何工作階段和任何範圍中，產生給特定資料表的識別值。 如需詳細資訊，請參閱 IDENT_CURRENT (Transact-SQL)。

@@IDENTITY 函數的範圍是執行它的本機伺服器的目前工作階段。 這個函數不適用於遠端或連結伺服器。 若要取得不同伺服器的識別值，請在該遠端或連結伺服器上執行預存程序，讓這個預存程序 (在遠端或連結伺服器的內容中執行) 收集識別值，並將它傳回本機伺服器發出呼叫的連接。

複寫可能會影響 @@IDENTITY 值，因為此值會用於複寫觸發程序和預存程序中。 如果資料行屬於複寫發行項的一部分，@@IDENTITY 就不是最近使用者建立之識別的可靠指標。 您可以使用 SCOPE_IDENTITY() 函數語法來取代 @@IDENTITY。 如需詳細資訊，請參閱 SCOPE_IDENTITY (Transact-SQL)

範例

下列範例會將資料列插入含有識別欄位 (LocationID) 的資料表，並利用 @@IDENTITY 來顯示新資料列所用的識別值。

USE AdventureWorks2022;  
GO  
--Display the value of LocationID in the last row in the table.  
SELECT MAX(LocationID) FROM Production.Location;  
GO  
INSERT INTO Production.Location (Name, CostRate, Availability, ModifiedDate)  
VALUES ('Damaged Goods', 5, 2.5, GETDATE());  
GO  
SELECT @@IDENTITY AS 'Identity';  
GO  
--Display the value of LocationID of the newly inserted row.  
SELECT MAX(LocationID) FROM Production.Location;  
GO  

另請參閱

系統函數 (Transact-SQL)
CREATE TABLE (Transact-SQL)
IDENT_CURRENT (Transact-SQL)
INSERT (Transact-SQL)
SCOPE_IDENTITY (Transact-SQL)
SELECT (Transact-SQL)