PERCENT_RANK (Transact-SQL)

Aplica-se a: SQL Server Banco de Dados SQL do Azure Instância Gerenciada de SQL do Azure Azure Synapse Analytics Ponto de extremidade de análises SQL no Microsoft Fabric Warehouse 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 em 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 )

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. A <rows or range clause> sintaxe da OVER sintaxe não pode ser especificada 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 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

Os exemplos de código do Transact-SQL deste artigo usa o banco de dados de exemplo AdventureWorks2022 ou AdventureWorksDW2022, que pode ser baixado da home page Microsoft SQL Server Samples and Community Projects.

O exemplo a seguir usa a CUME_DIST função para calcular o percentil salarial de cada funcionário em um determinado departamento. O valor retornado pela CUME_DIST função representa a porcentagem de funcionários que têm um salário menor ou igual ao do funcionário atual no 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 conjunto de resultados 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;

Veja a seguir 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