CUME_DIST (Transact-SQL)

Aplica-se a:SQL ServerBanco de Dados SQL do AzureInstância Gerenciada de SQL do AzureAzure Synapse AnalyticsPonto de extremidade de análises SQL no Microsoft FabricWarehouse no Microsoft Fabric

Para SQL Server, essa função calcula a distribuição cumulativa com um valor em um grupo de valores. Em outras palavras, CUME_DIST computa a posição relativa de um valor especificado em um grupo de valores. Supondo a ordenação ascendente, o CUME_DIST de um valor na linha r é definido como o número de linhas com valores menores ou iguais ao valor de r, dividido pelo número de linhas avaliadas no conjunto de resultados da consulta ou partição. CUME_DIST é semelhante à função PERCENT_RANK.

Convenções de sintaxe de Transact-SQL

Sintaxe

CUME_DIST( )  
    OVER ( [ partition_by_clause ] order_by_clause )  

Observação

Para exibir a sintaxe do Transact-SQL para o SQL Server 2014 (12.x) e versões anteriores, confira a Documentação das versões anteriores.

Argumentos

OVER ( [ partition_by_clause ] order_by_clause)

A partition_by_clause divide o conjunto de resultados produzido pela cláusula FROM em partições às quais a função é aplicada. Se o argumento partition_by_clause não tiver sido especificado, CUME_DIST tratará todas as linhas do conjunto de resultados da consulta como um único grupo. A order_by_clause determina a ordem lógica na qual a operação ocorre. O CUME_DIST exige a order_by_clause. O CUME_DIST não aceitará a <cláusula rows or range> da sintaxe OVER. Para obter mais informações, confira Cláusula OVER (Transact-SQL).

Tipos de retorno

float(53)

Comentários

O CUME_DIST retorna um intervalo de valores maior que 0 e menor que ou igual a 1. Valores vinculados são sempre avaliados com o mesmo valor de distribuição cumulativo. O CUME_DIST inclui valores NULL por padrão e trata esses valores como os menores valores possíveis.

CUME_DIST é não determinístico. Para obter mais informações, veja Funções determinísticas e não determinísticas.

Exemplos

O exemplo a seguir usa a função CUME_DIST para calcular o percentil do salário de cada funcionário dentro de um determinado departamento. O CUME_DIST retorna um valor que representa a porcentagem de funcionários que tem um salário menor que ou igual ao funcionário atual no mesmo departamento. A função PERCENT_RANK calcula a classificação da porcentagem do salário do funcionário dentro de um departamento. Para particionar as linhas do conjunto de resultados por departamento, o exemplo especifica o valor partition_by_clause. A cláusula ORDER BY da cláusula OVER ordena logicamente as linhas em cada partição. A cláusula ORDER BY da instrução SELECT determina a ordem de exibição do conjunto de resultados.

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;  

Este é o conjunto de resultados.

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)  

Confira também

PERCENT_RANK (Transact-SQL)