簡介

`SCOPE_IDENTITY()` 函數是一個在 sql Server 中用于檢索新插入行的標識值的重要函數。它在需要獲取剛插入的行的唯一標識符時非常有用，例如在插入后立即需要對該行進行引用時。

語法

`SCOPE_IDENTITY()` 函數的語法非常簡單：```sqlSCOPE_IDENTITY()```它不接受任何參數，并且總是返回一個 bigint 值，表示新插入行的標識值。

如何使用 SCOPE_IDENTITY()

要使用 `SCOPE_IDENTITY()` 函數，您需要在插入操作完成后立即調用它。這通常是通過在 INSERT 語句中使用 OUTPUT 子句來完成的。以下是示例：```sql-- 插入一條新記錄INSERT INTO MyTable (Name, Age)VALUES ('John Doe', 30);-- 獲取新插入行的標識值DECLARE @IdentityValue bigint;SET @IdentityValue = SCOPE_IDENTITY();-- 使用新插入行的標識值Select from MyTable WHERE ID = @IdentityValue;```在這個示例中，`SCOPE_IDENTITY()` 函數用于獲取剛插入到 `MyTable` 表中的行的 `ID` 值。我們使用此值來檢索新插入的行的詳細記錄。

與 @@IDENTITY 的區別

`SCOPE_IDENTITY()` 函數與另一個 SQL Server 函數 `@@IDENTITY` 非常相似。但是，這兩個函數之間存在一些關鍵區別：作用域： `SCOPE_IDENTITY()` 只返回當前會話中新插入行的標識值，而 `@@IDENTITY` 返回當前會話中所有會話的新插入行的標識值。并發性： `SCOPE_IDENTITY()` 函數可以在并發環境中安全使用，而 `@@IDENTITY` 在并發環境中可能會導致意外結果。通常情況下，建議在需要獲取當前會話中新插入行的標識值時使用 `SCOPE_IDENTITY()` 函數。

注意事項

在使用 `SCOPE_IDENTITY()` 函數時，需要注意以下幾點：`SCOPE_IDENTITY()` 函數只能在插入操作完成后立即調用。如果在插入操作之后執行其他任何操作，則函數將返回 `NULL`。如果插入操作失敗，則 `SCOPE_IDENTITY()` 函數將返回 `NULL`。如果插入多個行，則 `SCOPE_IDENTITY()` 函數將返回最后一個插入行的標識值。如果使用 `OUTPUT` 子句顯式指定了要返回的列，則必須在 `OUTPUT` 子句中包含標識列，否則 `SCOPE_IDENTITY()` 函數將返回 `NULL`。

示例

以下是一些在實際場景中使用 `SCOPE_IDENTITY()` 函數的示例：獲取剛插入訂單的訂單號：```sql-- 插入一條新訂單INSERT INTO Orders (CustomerName, OrderDate)VALUES ('John Doe', GETDATE());-- 獲取新插入訂單的訂單號DECLARE @OrderID bigint;SET @OrderID = SCOPE_IDENTITY();-- 使用訂單號處理新訂單...```更新剛插入產品的庫存數量：```sql-- 插入一條新產品INSERT INTO Products (Name, Price, StockQuantity)VALUES ('New Product', 100.00, 50);-- 獲取新插入產品的 IDDECLARE @ProductID bigint;SET @ProductID = SCOPE_IDENTITY();-- 更新新插入產品的庫存數量UPDATE ProductsSET StockQuantity = StockQuantity + 10WHERE ID = @ProductID;-- ...```向剛插入的客戶發送歡迎電子郵件：```sql-- 插入一條新客戶INSERT INTO Customers (Name, EmailAddress)VALUES ('John Doe', 'johndoe@example.com');-- 獲取新插入客戶的 IDDECLARE @CustomerID bigint;SET @CustomerID = SCOPE_IDENTITY();-- 發送歡迎電子郵件給新客戶...

結論

`SCOPE_IDENTITY()` 函數是一個非常有用的函數，用于在 SQL Server 中獲取新插入行的標識值。通過了解它的語法、用法和限制，您可以有效地使用它來滿足您的應用程序需求。

---

---

相關標簽： `SCOPE、 `、 掌握、 掌握的近義詞、 獲取新插入行標識值的權威指南、 IDENTITY、

上一篇：SQLServer中獲取標識值的終極指南探索`SCOP

下一篇：在SQLServer中有效使用`SCOPEIDENTITY`避免