Função @TOP

Revisão de 13h56min de 25 de fevereiro de 2025 por Kelvin.nunes (discussão | contribs) (Criou página com '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 úti...')
(dif) ← Edição anterior | Revisão atual (dif) | Versão posterior → (dif)

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

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.