ROW_NUMBER (Transact-SQL)ROW_NUMBER (Transact-SQL)

Este tema se aplica a: SíSQL Server (a partir de 2008)Síbase de datos de SQL AzureSíalmacenamiento de datos de SQL Azure Sí Almacenamiento de datos paralelos THIS TOPIC APPLIES TO: yesSQL Server (starting with 2008)yesAzure SQL DatabaseyesAzure SQL Data Warehouse yesParallel Data Warehouse

Enumera los resultados de un conjunto de resultados.Numbers the output of a result set. Concretamente, devuelve el número secuencial de una fila dentro de una partición de un conjunto de resultados, empezando por 1 para la primera fila de cada partición.More specifically, returns the sequential number of a row within a partition of a result set, starting at 1 for the first row in each partition.

ROW_NUMBER y RANK son similares.ROW_NUMBER and RANK are similar. ROW_NUMBER enumera todas las filas secuencialmente (por ejemplo 1, 2, 3, 4, 5).ROW_NUMBER numbers all rows sequentially (for example 1, 2, 3, 4, 5). RANK proporciona el mismo valor numérico para valores equivalentes (por ejemplo 1, 2, 2, 4, 5).RANK provides the same numeric value for ties (for example 1, 2, 2, 4, 5).

Nota

ROW_NUMBER es un valor temporal que se calcula cuando se ejecuta la consulta.ROW_NUMBER is a temporary value calculated when the query is run. Para conservar los números de una tabla, vea Propiedad IDENTITY y SEQUENCE.To persist numbers in a table, see IDENTITY Property and SEQUENCE.

Icono de vínculo de tema Convenciones de sintaxis de Transact-SQLTopic link icon Transact-SQL Syntax Conventions

SintaxisSyntax

ROW_NUMBER ( )   
    OVER ( [ PARTITION BY value_expression , ... [ n ] ] order_by_clause )  

ArgumentosArguments

PARTITION BY value_expressionPARTITION BY value_expression
Divide el conjunto de resultados generado por la cláusula FROM en particiones a las que se aplica la función ROW_NUMBER.Divides the result set produced by the FROM clause into partitions to which the ROW_NUMBER function is applied. value_expression especifica la columna a partir de la cual se particiona el conjunto de resultados.value_expression specifies the column by which the result set is partitioned. Si no se especifica PARTITION BY, la función trata todas las filas del conjunto de resultados de la consulta como un único grupo.If PARTITION BY is not specified, the function treats all rows of the query result set as a single group. Para más información, vea OVER Clause (Transact-SQL) (OVER (cláusula de Transact-SQL).For more information, see OVER Clause (Transact-SQL).

order_by_clauseorder_by_clause
La cláusula ORDER BY determina la secuencia en la que se asigna a las filas el ROW_NUMBER único correspondiente en una partición especificada.The ORDER BY clause determines the sequence in which the rows are assigned their unique ROW_NUMBER within a specified partition. Es obligatorio.It is required. Para más información, vea Cláusula OVER (Transact-SQL).For more information, see OVER Clause (Transact-SQL).

Tipos devueltosReturn Types

bigintbigint

Notas generalesGeneral Remarks

No hay ninguna garantía de que las filas devueltas por una consulta con al usar ROW_NUMBER() se ordenen exactamente igual con cada ejecución a menos que se cumplan estas condiciones:There is no guarantee that the rows returned by a query using ROW_NUMBER() will be ordered exactly the same with each execution unless the following conditions are true.

  1. Los valores de la columna de la partición sean únicos.Values of the partitioned column are unique.

  2. Los valores de las columnas ORDER BY sean únicos.Values of the ORDER BY columns are unique.

  3. Las combinaciones de los valores de la columna de la partición y las columnas ORDER BY sean únicas.Combinations of values of the partition column and ORDER BY columns are unique.

    ROW_NUMBER() sea no determinista.ROW_NUMBER() is nondeterministic. Para obtener más información, consulte Deterministic and Nondeterministic Functions.For more information, see Deterministic and Nondeterministic Functions.

EjemplosExamples

A.A. Ejemplos sencillosSimple examples

La siguiente consulta devuelve las cuatro tablas del sistema en orden alfabético.The following query returns the four system tables in alphabetic order.

SELECT 
  name, recovery_model_desc
FROM sys.databases 
WHERE database_id < 5
ORDER BY name ASC;

El conjunto de resultados es el siguiente.Here is the result set.

NAMEname recovery_model_descrecovery_model_desc
maestramaster SIMPLESIMPLE
modelmodel FULLFULL
msdbmsdb SIMPLESIMPLE
tempdbtempdb SIMPLESIMPLE

Para agregar una columna de número de fila delante de cada fila, agregue una columna con la función ROW_NUMBER, en este caso denominada Row#.To add a row number column in front of each row, add a column with the ROW_NUMBER function, in this case named Row#. Debe mover la cláusula ORDER BY hasta la cláusula OVER.You must move the ORDER BY clause up to the OVER clause.

SELECT 
  ROW_NUMBER() OVER(ORDER BY name ASC) AS Row#,
  name, recovery_model_desc
FROM sys.databases 
WHERE database_id < 5;

El conjunto de resultados es el siguiente.Here is the result set.

Row#Row# NAMEname recovery_model_descrecovery_model_desc
11 maestramaster SIMPLESIMPLE
22 modelmodel FULLFULL
33 msdbmsdb SIMPLESIMPLE
44 tempdbtempdb SIMPLESIMPLE

Al agregar una cláusula PARTITION BY en la columna recovery_model_desc, se reiniciará la numeración cuando cambie el valor recovery_model_desc.Adding a PARTITION BY clause on the recovery_model_desc column, will restart the numbering when the recovery_model_desc value changes.

SELECT 
  ROW_NUMBER() OVER(PARTITION BY recovery_model_desc ORDER BY name ASC) 
    AS Row#,
  name, recovery_model_desc
FROM sys.databases WHERE database_id < 5;

El conjunto de resultados es el siguiente.Here is the result set.

Row#Row# NAMEname recovery_model_descrecovery_model_desc
11 modelmodel FULLFULL
11 maestramaster SIMPLESIMPLE
22 msdbmsdb SIMPLESIMPLE
33 tempdbtempdb SIMPLESIMPLE

B.B. Devolver el número de fila de vendedorReturning the row number for salespeople

En el ejemplo siguiente se calcula un número de fila para los vendedores de Adventure Works CyclesAdventure Works Cycles según la categoría de ventas anuales hasta la fecha.The following example calculates a row number for the salespeople in Adventure Works CyclesAdventure Works Cycles based on their year-to-date sales ranking.

USE AdventureWorks2012;   
GO  
SELECT ROW_NUMBER() OVER(ORDER BY SalesYTD DESC) AS Row,   
    FirstName, LastName, ROUND(SalesYTD,2,1) AS "Sales YTD"   
FROM Sales.vSalesPerson  
WHERE TerritoryName IS NOT NULL AND SalesYTD <> 0;  

El conjunto de resultados es el siguiente.Here is the result set.


Row FirstName    LastName               SalesYTD  
--- -----------  ---------------------- -----------------  
1   Linda        Mitchell               4251368.54  
2   Jae          Pak                    4116871.22  
3   Michael      Blythe                 3763178.17  
4   Jillian      Carson                 3189418.36  
5   Ranjit       Varkey Chudukatil      3121616.32  
6   José         Saraiva                2604540.71  
7   Shu          Ito                    2458535.61  
8   Tsvi         Reiter                 2315185.61  
9   Rachel       Valdez                 1827066.71  
10  Tete         Mensa-Annan            1576562.19  
11  David        Campbell               1573012.93  
12  Garrett      Vargas                 1453719.46  
13  Lynn         Tsoflias               1421810.92  
14  Pamela       Ansman-Wolfe           1352577.13  

C.C. Devolver un subconjunto de filasReturning a subset of rows

En el ejemplo siguiente se calculan los números de fila para todas las filas de la tabla SalesOrderHeader en el orden de OrderDate y solo se devuelven las filas 50 a 60 inclusive.The following example calculates row numbers for all rows in the SalesOrderHeader table in the order of the OrderDate and returns only rows 50 to 60 inclusive.

USE AdventureWorks2012;  
GO  
WITH OrderedOrders AS  
(  
    SELECT SalesOrderID, OrderDate,  
    ROW_NUMBER() OVER (ORDER BY OrderDate) AS RowNumber  
    FROM Sales.SalesOrderHeader   
)   
SELECT SalesOrderID, OrderDate, RowNumber    
FROM OrderedOrders   
WHERE RowNumber BETWEEN 50 AND 60;  

D.D. Usar ROW_NUMBER() con PARTITIONUsing ROW_NUMBER() with PARTITION

En el ejemplo siguiente se usa el argumento PARTITION BY para crear particiones del conjunto de resultados de la consulta por la columna TerritoryName.The following example uses the PARTITION BY argument to partition the query result set by the column TerritoryName. La cláusula ORDER BY especificada en la cláusula OVER ordena las filas de cada partición por la columna SalesYTD.The ORDER BY clause specified in the OVER clause orders the rows in each partition by the column SalesYTD. La cláusula ORDER BY de la instrucción SELECT ordena todo el conjunto de resultados de la consulta por TerritoryName.The ORDER BY clause in the SELECT statement orders the entire query result set by TerritoryName.

USE AdventureWorks2012;  
GO  
SELECT FirstName, LastName, TerritoryName, ROUND(SalesYTD,2,1) AS SalesYTD,  
ROW_NUMBER() OVER(PARTITION BY TerritoryName ORDER BY SalesYTD DESC) 
  AS Row  
FROM Sales.vSalesPerson  
WHERE TerritoryName IS NOT NULL AND SalesYTD <> 0  
ORDER BY TerritoryName;  

El conjunto de resultados es el siguiente.Here is the result set.


FirstName  LastName             TerritoryName        SalesYTD      Row  
---------  -------------------- ------------------   ------------  ---  
Lynn       Tsoflias             Australia            1421810.92    1  
José       Saraiva              Canada               2604540.71    1  
Garrett    Vargas               Canada               1453719.46    2  
Jillian    Carson               Central              3189418.36    1  
Ranjit     Varkey Chudukatil    France               3121616.32    1  
Rachel     Valdez               Germany              1827066.71    1  
Michael    Blythe               Northeast            3763178.17    1  
Tete       Mensa-Annan          Northwest            1576562.19    1  
David      Campbell             Northwest            1573012.93    2  
Pamela     Ansman-Wolfe         Northwest            1352577.13    3  
Tsvi       Reiter               Southeast            2315185.61    1  
Linda      Mitchell             Southwest            4251368.54    1  
Shu        Ito                  Southwest            2458535.61    2  
Jae        Pak                  United Kingdom       4116871.22    1  

Ejemplos: Almacenamiento de datos SQL de AzureAzure SQL Data Warehouse y Almacenamiento de datos paralelosParallel Data WarehouseExamples: Almacenamiento de datos SQL de AzureAzure SQL Data Warehouse and Almacenamiento de datos paralelosParallel Data Warehouse

E.E. Devolver el número de fila de vendedorReturning the row number for salespeople

En este ejemplo se devuelve ROW_NUMBER para los representantes de ventas en función de su cuota de ventas asignada.The following example returns the ROW_NUMBER for sales representatives based on their assigned sales quota.

-- Uses AdventureWorks  

SELECT ROW_NUMBER() OVER(ORDER BY SUM(SalesAmountQuota) DESC) 
    AS RowNumber,  
    FirstName, LastName,   
    CONVERT(varchar(13), SUM(SalesAmountQuota),1) AS SalesQuota   
FROM dbo.DimEmployee AS e  
INNER JOIN dbo.FactSalesQuota AS sq  
    ON e.EmployeeKey = sq.EmployeeKey  
WHERE e.SalesPersonFlag = 1  
GROUP BY LastName, FirstName;  

A continuación se muestra un conjunto parcial de resultados.Here is a partial result set.


RowNumber  FirstName  LastName            SalesQuota  
---------  ---------  ------------------  -------------  
1          Jillian    Carson              12,198,000.00  
2          Linda      Mitchell            11,786,000.00  
3          Michael    Blythe              11,162,000.00  
4          Jae        Pak                 10,514,000.00  

F.F. Usar ROW_NUMBER() con PARTITIONUsing ROW_NUMBER() with PARTITION

El ejemplo siguiente muestra cómo utilizar la función ROW_NUMBER con el argumento PARTITION BY.The following example shows using the ROW_NUMBER function with the PARTITION BY argument. Esto provoca que la función ROW_NUMBER enumere las filas de cada partición.This causes the ROW_NUMBER function to number the rows in each partition.

-- Uses AdventureWorks  

SELECT ROW_NUMBER() OVER(PARTITION BY SalesTerritoryKey 
        ORDER BY SUM(SalesAmountQuota) DESC) AS RowNumber,  
    LastName, SalesTerritoryKey AS Territory,  
    CONVERT(varchar(13), SUM(SalesAmountQuota),1) AS SalesQuota   
FROM dbo.DimEmployee AS e  
INNER JOIN dbo.FactSalesQuota AS sq  
    ON e.EmployeeKey = sq.EmployeeKey  
WHERE e.SalesPersonFlag = 1  
GROUP BY LastName, FirstName, SalesTerritoryKey;  

A continuación se muestra un conjunto parcial de resultados.Here is a partial result set.


RowNumber  LastName            Territory  SalesQuota  
---------  ------------------  ---------  -------------  
1          Campbell            1           4,025,000.00  
2          Ansman-Wolfe        1           3,551,000.00  
3          Mensa-Annan         1           2,275,000.00  
1          Blythe              2          11,162,000.00  
1          Carson              3          12,198,000.00  
1          Mitchell            4          11,786,000.00  
2          Ito                 4           7,804,000.00  

Ver tambiénSee Also

RANK (Transact-SQL) RANK (Transact-SQL)
DENSE_RANK (Transact-SQL) DENSE_RANK (Transact-SQL)
NTILE (Transact-SQL)NTILE (Transact-SQL)