VARP (Transact-SQL)

[アーティクル]
10/16/2024

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

指定した式のすべての値について、母集団に対する統計的変位を返します。

Transact-SQL 構文表記規則

構文

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

引数

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 ステートメントのすべてのアイテムで VARP を使用すると、結果セットの各値が計算に含められます。 VARP は、数値型列に対して使用できます。 NULL 値は無視されます。

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

例

A: VARP を使用する

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

SELECT VARP(Bonus)  
FROM Sales.SalesPerson;  
GO

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

B: VARP を使用する

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

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

結果セットは次のとおりです。

Distinct_Values   All_Values
----------------  ----------------
158146830494.18   157788848582.94

C: OVER で VARP を使用する

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

-- Uses AdventureWorks  
  
SELECT CalendarYear AS Year, CalendarQuarter AS Quarter, SalesAmountQuota AS SalesQuota,  
       VARP(SalesAmountQuota) OVER (ORDER BY CalendarYear, CalendarQuarter) AS Variance  
FROM dbo.FactSalesQuota  
WHERE EmployeeKey = 272 AND CalendarYear = 2002  
ORDER BY CalendarQuarter;

結果セットは次のとおりです。

Year  Quarter  SalesQuota              Variance
----  -------  ----------------------  -------------------
2002  1         91000.0000             0.00
2002  2        140000.0000             600250000.00
2002  3         70000.0000             860222222.22
2002  4        154000.0000             1185187500.00

参照

集計関数 (Transact-SQL)
OVER 句 (Transact-SQL)

次の方法で共有