Função @TOP

A função @TOP é utilizada para limitar a quantidade de registros retornados por uma consulta SQL. Ela permite selecionar apenas as primeiras linhas do resultado, sendo útil para paginação ou para melhorar a performance de consultas que retornam grandes volumes de dados. Essa função será considerada somente para SQL Server, para os demais bancos de dados, a mesma será removida da expressão SQL.

Sitaxe

@TOP(N)

Parâmetros

Nome Banco Descrição
@TOP SQL Server TOP(10)

Exemplos

Nesse exemplo a consulta vai retornar somente os primeiros 10 registros.

procedure SelecionarTopRegistros;
var
  Q: TPHQuery;
begin
  try
    Q := NewPHQuery;
    Q.Add('SELECT @TOP(10) * ' +
          'FROM CLIENTES ' +
          'ORDER BY DATA_CADASTRO DESC');
  finally
    Q.Free;
  end;
end;
begin
  SelecionarTopRegistros;
end.