変数 (Transact-SQL)

[アーティクル]
05/11/2024

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

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

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

解説

一部の Transact-SQL システム関数の名前には、2 つの "アット" マーク (@@) で始まるものがあります。以前のバージョンの SQL Server では、 @@ 関数はグローバル変数と呼ばれ、 @@ 関数は変数ではなく、変数と同じ動作を持っていません。関数はシステム関数であり、構文の使用法は @@ 関数の規則に従います。

ビューで変数を使用することはできません。

変数への変更は、トランザクションのロールバックの影響を受けません。

Transact-SQL 変数を宣言する

このステートメントは DECLARE 、次の方法で Transact-SQL 変数を初期化します。

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

たとえば、次DECLAREのステートメントでは、int データ型で名前が付けられた@mycounterローカル変数が作成されます。既定では、この変数の値は NULL.

DECLARE @MyCounter INT;

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

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

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

変数のスコープは、その変数を参照できる Transact-SQL ステートメントの範囲になります。変数のスコープは、宣言された時点から、宣言されたバッチまたはストアドプロシージャの末尾まで続きます。たとえば、次のスクリプトでは、変数が 1 つのバッチ (キーワード (keyword)でGO区切られた) で宣言され、別のバッチで参照されるため、構文エラーが発生します。

USE AdventureWorks2022;
GO

DECLARE @MyVariable INT;

SET @MyVariable = 1;
GO

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

例

次のスクリプトは小さなテストテーブルを作成し、そのテーブルに 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

Share via

変数 (Transact-SQL)

解説

Transact-SQL 変数を宣言する

Transact-SQL 変数に値を設定する

例

フィードバック

フィードバック

その他のリソース

Share via

変数 (Transact-SQL)

解説

Transact-SQL 変数を宣言する

Transact-SQL 変数に値を設定する

例

関連するコンテンツ

フィードバック

フィードバック

その他のリソース