發行項
09/24/2010

Transact-SQL 變數

Transact-SQL 本機變數是一種物件，可保存特定類型的單一資料值。批次和指令碼中的變數通常的用途為：

作為計數器 (Counter)，計算迴圈 (Loop) 執行的次數，或控制迴圈執行的次數。
容納由流程控制陳述式測試的資料值。
若要儲存預存程序傳回碼或函數傳回值所傳回的資料值。

[!附註]

有些 Transact-SQL 系統函數的名稱開頭是兩個 @ 符號 (@@)。雖然在舊版的 MicrosoftSQL Server 中，@@ 函數是當作全域變數，但他們並不是變數，行為也和變數不一樣。@@ 函數是系統函數，他們的語法是遵照函數的規則。

以下指令碼建立一個小型測試資料表，並於其中填入 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 AdventureWorks;
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 EmployeeID, NationalIDNumber, Title
FROM HumanResources.Employee
WHERE EmployeeID = @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 陳述式指派值給變數，請加入變數名稱和值以指派給變數。這是將值指派給變數所慣用的方法。例如，這個批次會宣告兩個變數、指派值給變數，然後在 SELECT 陳述式的 WHERE 子句中使用這些變數：

USE AdventureWorks;
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

您也可以建立參考變數的選取清單，將值指派給變數。如果變數參考至選取清單，應該指派變數的純量值 (Scalar)，不然 SELECT 陳述式僅傳回一個資料列。例如：

USE AdventureWorks;
GO
DECLARE @EmpIDVariable int;

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

警告
如果在單一 SELECT 陳述式中有多個指派子句，SQL Server 則無法保證運算式評估的次序。請注意，只有當指派中有一些參考時，才能看到產生的效果。

如果 SELECT 陳述式傳回一個以上的資料列，且變數參考非純量運算式，則變數設定為替運算式傳回結果集中最後一筆資料列的傳回值。例如，批次中的 @EmpIDVariable 設定為最後一筆資料列傳回的 EmployeeID 值，也就是 1：

USE AdventureWorks;
GO
DECLARE @EmpIDVariable int;

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

SELECT @EmpIDVariable;
GO

請參閱

參考

DECLARE @local\_variable (Transact-SQL)

SET @local\_variable (Transact-SQL)

SELECT (Transact-SQL)

共用方式為

Transact-SQL 變數

宣告 Transact-SQL 變數

設定 Transact-SQL 變數的值

請參閱

參考

其他資源