VAR (Transact-SQL)

[アーティクル]
05/23/2023

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

指定された式のすべての値の統計的分散を返します。続くことがあります、 OVER 句です。

Transact-SQL 構文表記規則

構文

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

Note

SQL Server 2014 (12.x) 以前のバージョンの Transact-SQL 構文を確認するには、以前のバージョンのドキュメントを参照してください。

引数

ALL
すべての値にこの関数を適用します。 ALL が既定値です。

DISTINCT
重複する値は 1 つだけカウントします。

式 (expression)
bit データ型を除く、真数または概数データ型カテゴリの式です。集計関数とサブクエリは使用できません。

OVER ( [ partition_by_clause ] order_by_clause)
partition_by_clause は、FROM 句で生成された結果セットをパーティションに分割します。このパーティションに関数が適用されます。指定しない場合、関数ではクエリ結果セットのすべての行を 1 つのグループとして扱います。 order_by_clause 操作が実行される論理的順序を決定します。 order_by_clause は必須です。詳細については、OVER 句 (Transact-SQL) に関する記事を参照してください。

戻り値の型

float

注釈

SELECT ステートメントのすべてのアイテムで VAR を使用する場合、結果セットの各値は計算に含められます。 VAR は、数値型列に対して使用できます。 NULL 値は無視されます。

VAR は、OVER 句や ORDER BY 句なしで使用される場合は決定的関数です。 OVER 句や ORDER BY 句と共に使用される場合は、非決定的関数です。詳細については、「決定的関数と非決定的関数」を参照してください。

例

A: VAR の使用

この例では、AdventureWorks2022 データベースの SalesPerson テーブル内のすべてのボーナス額に対する偏差が返されます。

SELECT VAR(Bonus)  
FROM Sales.SalesPerson;  
GO

例: Azure Synapse Analytics、Analytics Platform System (PDW)

B: VAR の使用

次の例は、テーブル dbo.FactSalesQuota の販売ノルマの値の統計的分散を返します。最初の列にはすべての個別値の分散が含まれ、2 番目の列には重複値を含むすべての値の分散が含まれます。

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

結果セットは次のようになります。

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

C. OVER での VAR の使用

次の例は、暦年の各四半期に対する販売ノルマの値の統計的分散を返します。 OVER 句の ORDER BY は統計的分散を並べ替え、SELECT ステートメントの ORDER BY は結果セットを並べ替えることに注意してください。

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