在关系数据库中，每行记录都有一个唯一的主键值。当我们向表中插入一行新记录时，通常需要获取该记录的主键值，以便进行后续的数据操作。在 SQL Server 中，为了获取新插入记录的主键值，我们可以使用 SCOPE_IDENTITY() 函数。本文将详细介绍该函数的用法和注意事项。

一、什么是 SCOPE_IDENTITY() 函数

SCOPE_IDENTITY() 函数是 SQL Server 中用于获取最近插入记录的主键值的函数。它返回当前会话中所插入表的标识列的最后一个值，该标识列必须是针对某个表所定义的自增长类型。也就是说，SCOPE_IDENTITY() 函数只适用于自增长主键列。

二、如何使用 SCOPE_IDENTITY() 函数

使用 SCOPE_IDENTITY() 函数获取新插入记录的主键值的步骤如下：

1. 在 INSERT 语句中指定需要插入的列和值。

例如，假设我们有一个名为 Employees 的表，其中包含 EmployeeID、FirstName 和 LastName 列，且 EmployeeID 是自增长主键列。我们插入一行新记录时，需要指定 FirstName 和 LastName 列的值，而 EmployeeID 的值将自动生成。

INSERT INTO Employees (FirstName, LastName) VALUES ('John', 'Doe');

2. 在 INSERT 语句后面添加 SELECT SCOPE_IDENTITY(); 语句。

例如，

INSERT INTO Employees (FirstName, LastName) VALUES ('John', 'Doe');

SELECT SCOPE_IDENTITY();

该语句执行后，将返回最近插入的记录的 EmployeeID 值。

三、SCOPE_IDENTITY() 函数的注意事项

1. SCOPE_IDENTITY() 函数只能在一个 INSERT 语句的上下文中使用，不能在另外一个 INSERT 语句或存储过程中使用。如果在其他 INSERT 语句或存储过程中也需要获取主键值，应该使用 OUTPUT 从句或将值存储到一个变量中。

2. SCOPE_IDENTITY() 函数只适用于自增长列，不能用于任何其他类型的主键列。

3. 在使用 SCOPE_IDENTITY() 函数之前，必须插入一行记录。如果没有插入记录，该函数将返回 null 值。

4. 如果有多个 INSERT 语句同时执行，SCOPE_IDENTITY() 函数将返回最后一个 INSERT 语句所插入的记录的主键值。

5. SCOPE_IDENTITY() 函数和 @@IDENTITY 函数类似，但有所不同。而 @@IDENTITY 返回的是当前会话中最后一个标识列（自增长列、GUID 列或整数列）的值，无论该列是在哪个表中定义的。如果要确保返回的值是当前表所定义的自增长列的值，应该使用 SCOPE_IDENTITY() 函数而不是 @@IDENTITY。

四、示例

为了演示 SCOPE_IDENTITY() 函数的使用，我们可以创建一个新表 Employees 并向其中插入一些记录，如下所示：

-- 创建表

CREATE TABLE Employees (

EmployeeID INT IDENTITY PRIMARY KEY,

FirstName VARCHAR(50),

LastName VARCHAR(50)

);

-- 插入记录

INSERT INTO Employees (FirstName, LastName) VALUES ('John', 'Doe');

INSERT INTO Employees (FirstName, LastName) VALUES ('Jane', 'Doe');

INSERT INTO Employees (FirstName, LastName) VALUES ('Bob', 'Smith');

接下来，我们使用 SCOPE_IDENTITY() 函数获取最近插入记录的 EmployeeID 值：

-- 获取最近插入记录的 EmployeeID 值

INSERT INTO Employees (FirstName, LastName) VALUES ('Alice', 'Johnson');

SELECT SCOPE_IDENTITY();

该语句执行后，将返回最新插入记录的 EmployeeID 值。

总结

本文介绍了 SCOPE_IDENTITY() 函数在 SQL Server 中用于获取新插入记录的主键值的用法和注意事项。要注意的是，SCOPE_IDENTITY() 函数只适用于自增长主键列，且只能在同一个 INSERT 语句中使用。如果需要获取多个表的主键值，应该使用 OUTPUT 从句或使用变量存储主键值。在实际应用中，我们应该根据具体需求选择适当的方法，以确保获取到正确的主键值。