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.

Sitaxe

@TOP(N)

Parâmetros

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.