@@IDENTITY (Transact-SQL)

適用于:yesSQL Server (所有支援的版本) Azure SQL Database YesYes Azure SQL 受控執行個體

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

Topic link iconTransact-SQL 語法慣例

Syntax

@@IDENTITY  

注意

若要檢視 SQL Server 2014 與更早版本的 Transact-SQL 語法,請參閱舊版文件

傳回型別

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)

注意

呼叫預存程式或 Transact-SQL 語句必須重寫為使用 SCOPE_IDENTITY() 函式,這會傳回該使用者語句範圍內所使用的最新身分識別,而不是複寫所使用巢狀觸發程式範圍內的身分識別。

範例

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

USE AdventureWorks2012;  
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)