VAR (Transact-SQL)

Article
10/16/2024

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;