变量 (Transact-SQL)

项目
05/23/2023

适用于：SQL Server Azure SQL 数据库 Azure SQL 托管实例 Azure Synapse Analytics Analytics Platform System (PDW)Microsoft Fabric 中的 SQL 终结点 Microsoft Fabric 中的仓库

Transact-SQL 局部变量是可以保存单个特定类型数据值的对象。批处理和脚本中的变量通常用于：

作为计数器计算循环执行的次数或控制循环执行的次数。
保存数据值以供控制流语句测试。
保存存储过程返回代码要返回的数据值或函数返回值。

注意

某些 Transact-SQL 系统函数的名称以两个 at 符号 (@@) 开头。尽管在旧版 SQL Server 中，@@functions 称为全局变量，但 @@functions 不是变量，不具有等同于变量的行为。 @@function 是系统函数，并且其语法的使用遵循函数的规则。
不能在视图中使用变量。
事务回滚不影响对变量所做的更改。

以下脚本创建一个小的测试表并向其填充 26 行。脚本使用变量来执行下列三个操作：

通过控制循环执行的次数来控制插入的行数。
提供插入整数列的值。
作为表达式一部分生成插入字符列的字母的函数。

-- Create the table.
CREATE TABLE TestTable (cola INT, colb CHAR(3));
GO
SET NOCOUNT ON;
GO
-- Declare the variable to be used.
DECLARE @MyCounter INT;

-- Initialize the variable.
SET @MyCounter = 0;

-- Test the variable to see if the loop is finished.
WHILE (@MyCounter < 26)
BEGIN;
   -- Insert a row into the table.
   INSERT INTO TestTable VALUES
       -- Use the variable to provide the integer value
       -- for cola. Also use it to generate a unique letter
       -- for each row. Use the ASCII function to get the
       -- integer value of 'a'. Add @MyCounter. Use CHAR to
       -- convert the sum back to the character @MyCounter
       -- characters after 'a'.
       (@MyCounter,
        CHAR( ( @MyCounter + ASCII('a') ) )
       );
   -- Increment the variable to count this iteration
   -- of the loop.
   SET @MyCounter = @MyCounter + 1;
END;
GO
SET NOCOUNT OFF;
GO
-- View the data.
SELECT cola, colb
FROM TestTable;
GO
DROP TABLE TestTable;
GO

声明 Transact-SQL 变量

DECLARE 语句通过以下操作初始化 Transact-SQL 变量：

指定一个名称。名称的第一个字符必须为一个 @。
指定系统提供的或用户定义的数据类型和长度。对于数值变量还指定精度和小数位数。对于 XML 类型的变量，可以指定一个可选的架构集合。
将值设置为 NULL。

例如，下面的 DECLARE 语句创建名为 @mycounter 且数据类型为 int 的局部变量。

DECLARE @MyCounter INT;

若要声明多个局部变量，请在定义的第一个局部变量后使用一个逗号，然后指定下一个局部变量名称和数据类型。

例如，下面的 DECLARE 语句创建了三个局部变量，分别名为 @LastName、@FirstName 和 @StateProvince，并将每个变量都初始化为 NULL：

DECLARE @LastName NVARCHAR(30), @FirstName NVARCHAR(20), @StateProvince NCHAR(2);

变量的作用域就是可以引用该变量的 Transact-SQL 语句的范围。变量的作用域从声明变量的地方开始到声明变量的批处理或存储过程的结尾。例如，下面的脚本存在语法错误，因为在一个批处理中引用了在另一个批处理中声明的变量：

USE AdventureWorks2014;
GO
DECLARE @MyVariable INT;
SET @MyVariable = 1;
-- Terminate the batch by using the GO keyword.
GO 
-- @MyVariable has gone out of scope and no longer exists.

-- This SELECT statement generates a syntax error because it is
-- no longer legal to reference @MyVariable.
SELECT BusinessEntityID, NationalIDNumber, JobTitle
FROM HumanResources.Employee
WHERE BusinessEntityID = @MyVariable;

变量具有局部作用域，只在定义它们的批处理或过程中可见。在下面的示例中，为执行 sp_executesql 创建的嵌套作用域不能访问在更高作用域中声明的变量，从而返回错误。

DECLARE @MyVariable INT;
SET @MyVariable = 1;
EXECUTE sp_executesql N'SELECT @MyVariable'; -- this produces an error

为 Transact-SQL 变量设置值

第一次声明变量时，其值设置为 NULL。若要为变量赋值，请使用 SET 语句。这是为变量赋值的首选方法。也可以通过 SELECT 语句的选择列表中当前所引用值为变量赋值。

若要通过使用 SET 语句为变量赋值，请包含变量名和需要赋给变量的值。这是为变量赋值的首选方法。例如，下面的批处理声明两个变量、为它们赋值并在 WHERE 语句的 SELECT 子句中予以使用：

USE AdventureWorks2014;
GO
-- Declare two variables.
DECLARE @FirstNameVariable NVARCHAR(50),
   @PostalCodeVariable NVARCHAR(15);

-- Set their values.
SET @FirstNameVariable = N'Amy';
SET @PostalCodeVariable = N'BA5 3HX';

-- Use them in the WHERE clause of a SELECT statement.
SELECT LastName, FirstName, JobTitle, City, StateProvinceName, CountryRegionName
FROM HumanResources.vEmployee
WHERE FirstName = @FirstNameVariable
   OR PostalCode = @PostalCodeVariable;
GO

变量也可以通过选择列表中当前所引用的值赋值。如果在选择列表中引用变量，则它应当被赋以标量值或者 SELECT 语句应仅返回一行。例如：

USE AdventureWorks2014;
GO
DECLARE @EmpIDVariable INT;

SELECT @EmpIDVariable = MAX(EmployeeID)
FROM HumanResources.Employee;
GO

警告

如果在单个 SELECT 语句中有多个赋值子句，则 SQL Server 不保证表达式求值的顺序。请注意，只有当赋值之间有引用时才能看到影响。

如果 SELECT 语句返回多行而且变量引用一个非标量表达式，则会将变量设置为结果集最后一行中表达式的返回值。例如，在下面的批处理中，@EmpIDVariable 设置为返回的最后一行的 BusinessEntityID 值，即为 1：

USE AdventureWorks2014;
GO
DECLARE @EmpIDVariable INT;

SELECT @EmpIDVariable = BusinessEntityID
FROM HumanResources.Employee
ORDER BY BusinessEntityID DESC;

SELECT @EmpIDVariable;
GO

另请参阅

Declare @local_variable
SET @local_variable
SELECT @local_variable
表达式（Transact-SQL)
复合运算符 (Transact-SQL)

变量 (Transact-SQL)

声明 Transact-SQL 变量

为 Transact-SQL 变量设置值

另请参阅

其他资源

其他资源