PERCENT_RANK (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

Calcula a classificação relativa de uma linha dentro de um grupo de linhas no SQL Server. Use PERCENT_RANK para avaliar a posição relativa de um valor dentro de um conjunto de resultados de consulta ou partição. PERCENT_RANK é semelhante à função CUME_DIST .

Sintaxe

PERCENT_RANK( )
    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 )

O primeiro parâmetro, partition_by_clause, divide o conjunto de resultados produzido pela FROM cláusula em partições às quais a função é aplicada. Se não for especificado, a função tratará todas as linhas do conjunto de resultados da consulta como um único grupo. O segundo parâmetro, order_by_clause, determina a ordem lógica na qual a operação é executada. order_by_clause é obrigatório. O <rows or range clause> da OVER sintaxe não pode ser especificado em uma PERCENT_RANK função. Para obter mais informações, consulte Cláusula SELECT - OVER.

Tipos de retorno

float(53)

Comentários

O intervalo de valores retornado por PERCENT_RANK é maior que 0 e menor ou igual a 1. A primeira linha em qualquer conjunto tem um PERCENT_RANK de 0. NULL Os valores são incluídos por padrão e são tratados como os valores mais baixos possíveis.

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

Exemplos

Este artigo requer o banco de dados de exemplo AdventureWorks2022, que pode ser baixado na home page Microsoft SQL Server Samples and Community Projects.

O exemplo a seguir usa a CUME_DIST função para calcular o percentil salarial para cada funcionário dentro de um determinado departamento. O valor devolvido pela CUME_DIST função representa o percentual de funcionários que possuem salário menor ou igual ao atual funcionário do mesmo departamento. A PERCENT_RANK função calcula a classificação do salário do funcionário dentro de um departamento como uma porcentagem. A PARTITION BY cláusula é especificada para particionar as linhas no resultado definido por departamento. A ORDER BY cláusula na OVER cláusula ordena as linhas em cada partição. A ORDER BY cláusula na SELECT instrução classifica as linhas em todo o 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