PHSYS - Wiki

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.

==='''Sitaxe'''===

@TOP(N)

==='''Parâmetros'''===

{| class="wikitable" style="width: 100%"
! Nome 
!Banco
!Descrição
|-
|@TOP
|PostgreSQL
|LIMIT N
|-
|-
|@TOP
|Oracle
|ROWNUM <= N ou FETCH FIRST N ROWS ONLY (a partir da versão 12c)
|-
|@TOP
|FireBird
|FIRST N
|-
|@TOP
|SQLServer
|TOP N
|-
|}

==='''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.