VAR (Transact-SQL)
S’applique à : SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW) SQL analytics endpoint in Microsoft Fabric Warehouse in Microsoft Fabric
Renvoie la variance statistique de toutes les valeurs de l'expression spécifiée. Cette fonction peut être suivie par la clause OVER.
Conventions de la syntaxe Transact-SQL
Syntaxe
-- Aggregate Function Syntax
VAR ( [ ALL | DISTINCT ] expression )
-- Analytic Function Syntax
VAR ([ ALL ] expression) OVER ( [ partition_by_clause ] order_by_clause)
Arguments
ALL
Applique la fonction à toutes les valeurs. ALL est l'argument par défaut.
DISTINCT
Spécifie que chaque valeur unique est prise en considération.
expression
Expression de la catégorie de type de données numérique exacte ou approximative, à l’exception du type de données bit. Les fonctions d'agrégation et les sous-requêtes ne sont pas autorisées.
OVER ( [ partition_by_clause ] order_by_clause)
partition_by_clause divise le jeu de résultats généré par la clause FROM en partitions auxquelles la fonction est appliquée. S'il n'est pas spécifié, la fonction gère toutes les lignes du jeu de résultats de la requête en un seul groupe. order_by_clause détermine l’ordre logique dans lequel l’opération est effectuée. order_by_clause est requis. Pour plus d’informations, consultez Clause OVER (Transact-SQL).
Types de retour
float
Remarques
Si VAR est utilisé sur tous les éléments d'une instruction SELECT, chaque valeur du jeu de résultats est incluse dans le calcul. VAR ne peut être utilisé qu'avec des colonnes numériques. Les valeurs NULL sont ignorées.
VAR est une fonction déterministe lorsqu'elle est utilisée sans les clauses OVER et ORDER BY. Elle n'est pas déterministe avec les clauses OVER et ORDER BY. Pour plus d’informations, consultez Fonctions déterministes et non déterministes.
Exemples
A : Utilisation de VAR
L’exemple suivant renvoie la variance de toutes les valeurs de bonus dans la table SalesPerson
de la base de données AdventureWorks2022.
SELECT VAR(Bonus)
FROM Sales.SalesPerson;
GO
Exemples : Azure Synapse Analytics et Analytics Platform System (PDW)
B : Utilisation de VAR
L’exemple suivant renvoie la variance statistique des valeurs de quota de ventes dans la table dbo.FactSalesQuota
. La première colonne contient la variance de toutes les valeurs distinctes, alors que la seconde colonne contient la variance de toutes les valeurs, y compris des valeurs en double.
-- Uses AdventureWorks
SELECT VAR(DISTINCT SalesAmountQuota)AS Distinct_Values, VAR(SalesAmountQuota) AS All_Values
FROM dbo.FactSalesQuota;
Voici le jeu de résultats obtenu.
Distinct_Values All_Values
---------------- ----------------
159180469909.18 158762853821.10
C. Utilisation de VAR avec OVER
L’exemple suivant renvoie la variance statistique des valeurs de quota de ventes pour chaque trimestre d’une année civile. Notez que la clause ORDER BY dans la clause OVER trie la variance statistique et que la clause ORDER BY de l’instruction SELECT trie les résultats.
-- Uses AdventureWorks
SELECT CalendarYear AS Year, CalendarQuarter AS Quarter, SalesAmountQuota AS SalesQuota,
VAR(SalesAmountQuota) OVER (ORDER BY CalendarYear, CalendarQuarter) AS Variance
FROM dbo.FactSalesQuota
WHERE EmployeeKey = 272 AND CalendarYear = 2002
ORDER BY CalendarQuarter;
Voici le jeu de résultats obtenu.
Year Quarter SalesQuota Variance
---- ------- ---------------------- -------------------
2002 1 91000.0000 null
2002 2 140000.0000 1200500000.00
2002 3 70000.0000 1290333333.33
2002 4 154000.0000 1580250000.00
Voir aussi
Fonctions d'agrégation (Transact-SQL)
OVER Clause (Transact-SQL)