TOP (Transact-SQL)

Sintaxe

[ 
     TOP (expression) [PERCENT]
     [ WITH TIES ]
]

Argumentos

• expression
  É uma expressão numérica que especifica o número de linhas que serão retornadas. expression é implicitamente convertido em um valor float se PERCENT for especificado; caso contrário, será convertido em bigint.

  Parênteses que delimitam expression em TOP são necessários em instruções INSERT, UPDATE, MERGE e DELETE. Para compatibilidade com versões anteriores, o uso de TOP expression sem parênteses em instruções SELECT possui suporte, mas não é recomendável.

  Se a consulta incluir uma cláusula ORDER BY, serão retornadas as primeiras linhas expression, ou porcentagem de linhas expression, solicitadas pela cláusula ORDER BY. Se a consulta não tiver nenhuma cláusula ORDER BY, a ordem das linhas será arbitrária.

• PERCENT
  Indica que a consulta retorna apenas os primeiros percentuais de linhas expression do conjunto de resultados.

• WITH TIES
  Especifica que linhas adicionais são retornadas do conjunto de resultados base com o mesmo valor das colunas que aparecem na última das linhas TOP n (PERCENT). TOP... WITH TIES pode ser especificado somente em instruções SELECT e apenas se uma cláusula ORDER BY estiver especificada.

  Observação
  A ordem de juntar registros retornada é arbitrária. ORDER BY não afeta esta regra.

Comentários

TOP não pode ser usado junto com instruções UPDATE e DELETE em exibições particionadas.

As linhas referidas na expressão TOP usadas com INSERT, UPDATE, MERGE ou DELETE não são organizadas em nenhuma ordem. TOP n retorna n linhas aleatórias. Por exemplo, a instrução INSERT a seguir contém a cláusula ORDER BY, mas essa cláusula não afeta as linhas diretamente referenciadas pela instrução INSERT.

INSERT TOP (2) INTO Table2 (ColumnB) 
    SELECT ColumnA FROM Table1 
    ORDER BY ColumnA;

A cláusula ORDER BY nas referências de consulta anteriores referencia somente as linhas que são retornadas pela instrução SELECT aninhada. A instrução INSERT escolhe duas linhas quaisquer retornadas pela instrução SELECT. Para verificar se as primeiras duas linhas da subconsulta SELECT foram inseridas, reescreva a consulta conforme mostrado a seguir.

INSERT INTO Table2 (ColumnB) 
    SELECT TOP (2) ColumnA FROM Table1 
    ORDER BY ColumnA;

O SQL Server permite atualizar exibições que foram criadas com a cláusula TOP. Como a cláusula TOP foi incluída na definição de exibição, algumas linhas podem desaparecer da exibição por causa de uma atualização se o resultado deixar de atender aos requisitos da expressão TOP. Para obter mais informações, consulte Modificando dados por meio de uma exibição.

A expressão TOP em uma consulta não afeta instruções que podem ser executadas por causa de um gatilho acionado. As tabelas inseridas e atualizadas nos gatilhos mostrarão somente as linhas que realmente foram afetadas pelas instruções INSERT, UPDATE, MERGE ou DELETE.

Usando TOP na instrução MERGE

Exemplos

A. Usando TOP com variáveis

USE AdventureWorks2008R2;
GO
DECLARE @p AS int;
SELECT @p=10
SELECT TOP(@p)*
FROM HumanResources.Employee;
GO

B. Usando TOP com PERCENT e WITH TIES

USE AdventureWorks2008R2;
GO
SELECT TOP(10) PERCENT WITH TIES
pp.FirstName, pp.LastName, e.JobTitle, e.Gender, r.Rate
FROM Person.Person AS pp 
    INNER JOIN HumanResources.Employee AS e
        ON pp.BusinessEntityID = e.BusinessEntityID
    INNER JOIN HumanResources.EmployeePayHistory AS r
        ON r.BusinessEntityID = e.BusinessEntityID
ORDER BY Rate DESC;

Consulte também

Referência