Variables Transact-SQL

Une variable locale Transact-SQL est un objet pouvant posséder une valeur de données unique d'un type donné. Les variables contenues dans les lots et les scripts sont généralement utilisées :

• pour compter ou vérifier le nombre de fois qu'une boucle est réalisée ;
• pour retenir une valeur de données à tester par une instruction de contrôle de flux ;
• pour enregistrer une valeur de données que doit retourner le code de retour d'une procédure stockée ou la valeur de retour d'une fonction.

Remarque :

Le nom de certaines fonctions système Transact-SQL commence par deux symboles arobase (@@). Bien que dans les versions précédentes de Microsoft SQL Server les fonctions de type @@fonction soient considérées comme des variables globales, ce n'en sont pas et elles n'en ont pas le comportement. Les fonctions de type @@fonction sont des fonctions système et leur syntaxe suit les règles habituelles des fonctions.

Le script suivant crée une petite table test et lui attribue 26 lignes. Il utilise une variable pour effectuer trois actions :

• vérifier le nombre de lignes insérées en contrôlant combien de fois la boucle est exécutée ;
• fournir la valeur insérée dans la colonne INT ;
• faire partie de l'expression qui génère les lettres devant être insérées dans la colonne CHAR.

-- 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

Déclaration d'une variable Transact-SQL

L'instruction DECLARE initialise une variable Transact-SQL de la manière suivante :

• Affectation d'un nom. Celui-ci doit avoir comme premier caractère un @ unique.
• Affectation d'un type de données système ou défini par l'utilisateur, ainsi que d'une taille. Pour les variables numériques, la précision et l'échelle doivent également être affectées. Pour les variables de type XML, une collection de schéma facultative peut être affectée.
• Affectation de la valeur NULL à la variable.

Par exemple, l'instruction DECLARE ci-dessous crée une variable locale appelée @mycounter avec pour type de données int.

DECLARE @MyCounter int;

Pour déclarer plusieurs variables locales, utilisez une virgule après la première variable locale définie, puis indiquez le nom et le type de données de la variable locale suivante.

Par exemple, cette instruction DECLARE crée trois variables locales appelées @LastName, @FirstName et @StateProvince, et elle leur attribue à toutes la valeur NULL.

DECLARE @LastName nvarchar(30), @FirstName nvarchar(20), @StateProvince nchar(2);

La portée d'une variable correspond à la plage des instructions Transact-SQL pouvant référencer cette variable. La portée d'une variable commence au point où elle est déclarée et se termine à la fin du lot d'instructions ou de la procédure stockée où elle est déclarée. Ce script, par exemple, génère une erreur de syntaxe car la variable est déclarée dans un lot et référencée dans un autre :

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;

Les variables ont une portée locale et elles ne sont visibles que dans le lot ou la procédure où elles sont définies. Dans l'exemple suivant, la portée imbriquée créée pour l'exécution de sp_executesql n'a pas accès à la variable déclarée dans la portée supérieure et elle retourne une erreur.

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

Affectation d'une valeur à une variable Transact-SQL

Quand une variable est déclarée pour la première fois, elle prend la valeur NULL. Pour affecter une valeur à une variable, utilisez l'instruction SET. C'est la méthode recommandée pour affecter une valeur à une variable. Il est également possible d'affecter une valeur à une variable en y faisant référence dans la liste de sélection d'une instruction SELECT.

Pour affecter une valeur à une variable à l'aide de l'instruction SET, indiquez le nom et la valeur à affecter à la variable. C'est la méthode recommandée pour affecter une valeur à une variable. Ce lot d'instructions, par exemple, déclare deux variables, leur affecte une valeur et les utilise dans la clause WHERE d'une instruction SELECT :

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

Vous pouvez également affecter une valeur à une variable en y faisant référence dans une liste de sélection. Si une variable est référencée dans une liste de sélection, une valeur scalaire doit lui être affectée, sinon l'instruction SELECT ne retournera qu'une seule ligne. Par exemple :

USE AdventureWorks;
GO
DECLARE @EmpIDVariable int;

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

Attention :
S'il y a plusieurs clauses d'affectation dans une seule instruction SELECT, SQL Server ne garantit pas l'ordre d'évaluation des expressions. Notez que les effets ne sont visibles que s'il existe des références parmi les affectations.

Si une instruction SELECT retourne plusieurs lignes et si la variable fait référence à une expression non scalaire, la variable prend la valeur retournée par l'expression figurant à la dernière ligne de l'ensemble de résultats. Dans le lot suivant, par exemple, @EmpIDVariable prend la valeur EmployeeID de la dernière ligne retournée, c'est-à-dire 1 :

USE AdventureWorks;
GO
DECLARE @EmpIDVariable int;

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

SELECT @EmpIDVariable;
GO

Voir aussi

Autres ressources

DECLARE @local\_variable (Transact-SQL)
SET @local\_variable (Transact-SQL)
SELECT (Transact-SQL)

Aide et Informations

Assistance sur SQL Server 2005