VAR (Transact-SQL)

Artikel
05/23/2023

Gilt für:SQL Server Azure SQL-Datenbank Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)SQL Analytics-Endpunkt in Microsoft Fabric Warehouse in Microsoft Fabric

Gibt die statistische Varianz aller Werte im angegebenen Ausdruck zurück. Darauf folgt möglicherweise die OVER-Klausel.

Transact-SQL-Syntaxkonventionen

Syntax

-- Aggregate Function Syntax   
VAR ( [ ALL | DISTINCT ] expression )  
  
-- Analytic Function Syntax  
VAR ([ ALL ] expression) OVER ( [ partition_by_clause ] order_by_clause)

Hinweis

Informationen zum Anzeigen der Transact-SQL-Syntax für SQL Server 2014 (12.x) und früher finden Sie unter Dokumentation zu früheren Versionen.

Argumente

ALL
Wendet die Funktion auf alle Werte an. ALL ist die Standardeinstellung.

DISTINCT
Gibt an, dass jeder eindeutige Wert berücksichtigt wird.

expression
Ein Ausdruck der genauen numerischen oder ungefähren numerischen Datentypkategorie, mit Ausnahme des bit-Datentyps. Aggregatfunktionen und Unterabfragen sind nicht zulässig.

OVER ( [ partition_by_clause ] order_by_clause)
partition_by_clause unterteilt das von der FROM-Klausel erzeugte Resultset in Partitionen, auf die die Funktion angewendet wird. Wird dies nicht angegeben, verarbeitet die Funktion alle Zeilen des Abfrageresultsets als einzelne Gruppe. order_by_clause bestimmt die logische Reihenfolge, in der der Vorgang ausgeführt wird. order_by_clause ist erforderlich. Weitere Informationen finden Sie unter OVER-Klausel (Transact-SQL).

Rückgabetypen

float

Hinweise

Falls VAR für alle Elemente einer SELECT-Anweisung verwendet wird, werden alle Werte im Resultset in die Berechnung eingeschlossen. VAR kann nur bei numerischen Spalten verwendet werden. NULL-Werte werden ignoriert.

VAR ist eine deterministische Funktion, wenn sie ohne die OVER- und ORDER BY-Klauseln angegeben wird. Sie ist nicht deterministisch, wenn sie mit den OVER- und ORDER BY-Klauseln angegeben wird. Weitere Informationen finden Sie unter Deterministic and Nondeterministic Functions.

Beispiele

A: Verwenden von VAR

Im folgenden Beispiel wird die Varianz für alle Bonuswerte in der SalesPerson-Tabelle der AdventureWorks2022-Datenbank zurückgegeben.

SELECT VAR(Bonus)  
FROM Sales.SalesPerson;  
GO

Beispiele: Azure Synapse Analytics und Analytics-Plattformsystem (PDW)

B: Verwenden von VAR

Das folgende Beispiel gibt in der Tabelle dbo.FactSalesQuota die statistische Varianz der Sollvorgabenwerte für den Verkauf zurück. Die erste Spalte enthält die Varianz aller eindeutigen Werte. Die zweite Spalte enthält die Varianz aller Werte, einschließlich aller doppelten Werte.

-- Uses AdventureWorks  
  
SELECT VAR(DISTINCT SalesAmountQuota)AS Distinct_Values, VAR(SalesAmountQuota) AS All_Values  
FROM dbo.FactSalesQuota;

Hier ist das Resultset.

Distinct_Values   All_Values
----------------  ----------------
159180469909.18   158762853821.10

C. Verwenden von VAR mit OVER

Das folgende Beispiel gibt für jedes Quartal eines Kalenderjahrs die statistische Varianz der Sollvorgabenwerte zurück. Beachten Sie, dass über die Anweisung ORDER BY in der OVER-Klausel die statistische Varianz und über die Anweisung SELECT ein Resultset angefordert wird.

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