変数 (Transact-SQL)

[アーティクル]
05/23/2023

適用対象:SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)Microsoft Fabric の SQL 分析エンドポイント Microsoft Fabric のウェアハウス

Transact-SQL ローカル変数は、特定の型の単一データ値を保持できるオブジェクトです。バッチ内の変数とスクリプトは、通常、次の場合に使用されます。

ループの実行回数をカウントしたり、制御するカウンターとして使用する場合。
流れ制御ステートメントによって検査されるデータ値を保持する場合。
ストアドプロシージャのリターンコードや関数の戻り値によって返されるデータ値を保存する場合。

Note

一部の Transact-SQL システム関数の名前には、2 つのアット マーク (@@) で始まるものがあります。初期のバージョンの SQL Server では、@@ 関数がグローバル変数と呼ばれていましたが、@@ 関数は変数ではなく、変数とは違った動作をします。 @@ 関数はシステム関数であり、構文の用法は関数の規則に従います。
ビューで変数を使用することはできません。
変数への変更は、トランザクションのロールバックの影響を受けません。

次のスクリプトは小さなテストテーブルを作成し、そのテーブルに 26 行を設定する例です。このスクリプトでは変数を使用して次の 3 つのことを行います。

ループの実行回数を管理して、挿入する行数を制御します。
整数列に挿入する値を供給します。
文字列に挿入する文字を生成する式の一部として機能させます。

-- 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 変数が初期化されます。

名前を割り当てます。名前は 1 つの @ で始まる必要があります。
システム提供のデータ型またはユーザー定義データ型と長さを割り当てます。数値変数の場合は、有効桁数と小数点以下桁数も割り当てます。 XML 型の変数の場合は、省略可能なスキーマコレクションを割り当てることができます。
値を NULL に設定します。

たとえば、次の DECLARE ステートメントを使用すると、int データ型の @mycounter という名前のローカル変数が作成されます。

DECLARE @MyCounter INT;

複数のローカル変数を宣言するには、最初のローカル変数を定義した後にコンマを付け、次のローカル変数名とデータ型を指定します。

たとえば、次の DECLARE ステートメントを使用すると、@LastName、@FirstName、および @StateProvince という名前の 3 つのローカル変数が作成され、それぞれが NULL に初期化されます。

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

変数のスコープは、その変数を参照できる Transact-SQL ステートメントの範囲になります。変数のスコープは、その変数が宣言された時点で始まり、変数が宣言されたバッチやストアドプロシージャが終了した時点で終了します。たとえば、次のスクリプトでは変数が宣言されたバッチと変数を参照するバッチが異なるため、構文エラーが発生します。

USE AdventureWorks2022;
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 ステートメントを使用して変数に値を代入するには、変数名とその変数に代入する値を含めます。変数に値を代入する場合は、この方法を使用することをお勧めします。次のバッチの例では、2 つの変数を宣言し、それぞれに値を代入し、WHERE ステートメントの SELECT 句でその値を使用しています。

USE AdventureWorks2022;
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 ステートメントからは 1 行しか返されません。次に例を示します。

USE AdventureWorks2022;
GO
DECLARE @EmpIDVariable INT;

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

警告

1 つの SELECT ステートメントに複数の代入句がある場合、SQL Server では式の評価順序が保証されません。複数の代入の間に参照がある場合のみ、その影響を確認できることに注意してください。

SELECT ステートメントが複数の行を返すときに、変数がスカラーではない式を参照している場合は、結果セットの最終行でその式に対して返された値が変数に設定されます。たとえば、次のバッチ @EmpIDVariable は、返された最終行の BusinessEntityID 値、つまり 1 に設定されます。

USE AdventureWorks2022;
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 変数内での値の設定

参照

フィードバック

フィードバック

その他のリソース