CUME_DIST (Transact-SQL)

適用於：MicrosoftFabric 中 Microsoft Fabric倉儲中的 Azure Azure SQL 資料庫 Azure SQL 受控執行個體 Azure Synapse AnalyticsSQL 分析端點

對於 SQL Server 來說，此函數會計算各個值的群組中，某一項值的累積分布。 換言之，CUME_DIST 會計算值群組中，某一指定值的相對位置。 假設採取遞增排序，則資料列 r 中，某值的 CUME_DIST 是定義為有多少個資料列的值是小於或等於資料列 r 中的值，除以資料分割或查詢結果集中計算得出的資料列數。 CUME_DIST 類似於 PERCENT_RANK 函數。

Transact-SQL 語法慣例

Syntax

CUME_DIST( )  
    OVER ( [ partition_by_clause ] order_by_clause )  

注意

若要檢視 SQL Server 2014 （12.x） 和舊版的 Transact-SQL 語法，請參閱 舊版檔。

引數

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)  

另請參閱

PERCENT_RANK (Transact-SQL)