CUME_DIST (Transact-SQL)
適用於：
SQL Server Azure SQL 資料庫 Azure SQL 受控執行個體 Azure Synapse Analytics Microsoft Fabric 中的 SQL 分析端點 Microsoft Fabric 中的倉儲
對於 SQL Server 來說，此函數會計算各個值的群組中，某一項值的累積分布。 換言之，CUME_DIST 會計算值群組中，某一指定值的相對位置。 假設採取遞增排序，則資料列 r 中，某值的 CUME_DIST 是定義為有多少個資料列的值是小於或等於資料列 r 中的值，除以資料分割或查詢結果集中計算得出的資料列數。 CUME_DIST 類似於 PERCENT_RANK 函數。
語法
CUME_DIST( )
OVER ( [ partition_by_clause ] order_by_clause )
引數
OVER ( [ partition_by_clause ] order_by_clause)
partition_by_clause 會將 FROM 子句的結果集分割成函數所要套用的資料分割。 如未指定 partition_by_clause 引數，則 CUME_DIST 會將所有查詢結果集資料列視為單一群組。 order_by_clause 會決定作業的執行邏輯順序。 CUME_DIST 需要 order_by_clause。 CUME_DIST 將不會接受 OVER 語法的<資料列或範圍子句>。 如需詳細資訊，請參閱 OVER 子句 (Transact-SQL)。
傳回類型
float(53)
備註
CUME_DIST 傳回某一範圍的值，且這些值大於 0 且小於或等於 1。 繫結值的計算所得一律會是相同的累計分佈值。 CUME_DIST 預設會包含 NULL 值，並將其視為最低值。
CUME_DIST 不具決定性。 如需詳細資訊，請參閱 決定性與非決定性函數。
範例
此範例使用 CUME_DIST 函數來計算指定部門各員工的薪資百分位數。 CUME_DIST 會傳回一個值，它代表有多少百分比的員工，其薪資要比同部門當前的員工要來得低或持平。 PERCENT_RANK 函數會計算該員工薪資在部門中的排名百分比。 為了按部門分割結果集資料列，此範例會指定 partition_by_clause 值。 OVER 子句中的 ORDER BY 子句會將每個資料分割中的資料列，以邏輯方式排序。 SELECT 陳述式的 ORDER BY 子句會決定結果集的顯示排序。
USE AdventureWorks2022;
GO
SELECT Department, LastName, Rate,
CUME_DIST () OVER (PARTITION BY Department ORDER BY Rate) AS CumeDist,
PERCENT_RANK() OVER (PARTITION BY Department ORDER BY Rate ) AS PctRank
FROM HumanResources.vEmployeeDepartmentHistory AS edh
INNER JOIN HumanResources.EmployeePayHistory AS e
ON e.BusinessEntityID = edh.BusinessEntityID
WHERE Department IN (N'Information Services',N'Document Control')
ORDER BY Department, Rate DESC;
結果集如下所示。
Department LastName Rate CumeDist PctRank
---------------------- ---------------------- --------------------- ---------------------- ----------------------
Document Control Arifin 17.7885 1 1
Document Control Norred 16.8269 0.8 0.5
Document Control Kharatishvili 16.8269 0.8 0.5
Document Control Chai 10.25 0.4 0
Document Control Berge 10.25 0.4 0
Information Services Trenary 50.4808 1 1
Information Services Conroy 39.6635 0.9 0.888888888888889
Information Services Ajenstat 38.4615 0.8 0.666666666666667
Information Services Wilson 38.4615 0.8 0.666666666666667
Information Services Sharma 32.4519 0.6 0.444444444444444
Information Services Connelly 32.4519 0.6 0.444444444444444
Information Services Berg 27.4038 0.4 0
Information Services Meyyappan 27.4038 0.4 0
Information Services Bacon 27.4038 0.4 0
Information Services Bueno 27.4038 0.4 0
(15 row(s) affected)