Neste artigo abordaremos como realizar consultas através de paginações, trabalhando com a linguagem de consulta de objetos  Salesforce (SOQL), utilizando LIMIT e OFFSET clausulas bastante utilizadas em cenários de grande volume de dados. 


LIMIT 

É uma cláusula opcional que pode ser atribuída a um SELECT para especificar o número máximo de linhas a serem retornadas. 


SELECT = " Declaração que retorna um conjunto de resultados de registros de uma ou mais tabelas "

Observe na figura abaixo como a sintaxe é utilizada;

SELECT VIAGENS FROM CORPORATIVO WHERE DESTINO = 'BRASIL' LIMIT 125


Este resultado retorna os primeiros 125 registros de viagens corporativas cujo o destino seja Brasil.

Você também pode utilizar LIMIT com Count() como a fieldList para contar até o máximo especificado.

Clique aqui e saiba mais sobre as clausulas direto da documentação do Salesforce. 

 

OFFSET 

Ao esperar muitos registros nos resultados de uma consulta, você pode exibir os resultados em várias páginas usando o OFFSET . Por exemplo, você pode usar OFFSET para exibir os registros 51–75 e, em seguida, pular ou trazer a partir de determinados registros, é uma maneira eficiente de lidar com grandes conjuntos de resultados.



SELECT NOME,DESTINO FROM CORPORATIVO WHERE ANO > 2019 ORDER BY NOME LIMIT 100 OFFSET 10


Por exemplo, se uma consulta SOQL normalmente retornasse 50 linhas, você poderia usar OFFSET 10 em sua consulta para pular as primeiras 10 linhas.


Aqui estão alguns pontos a serem considerados ao usar OFFSET em suas consultas:

  • O deslocamento máximo é de 2.000 linhas.

  • A cláusula OFFSET é permitida no SOQL usado na API SOAP, API REST e Apex. 

  • Não é permitido em SOQL usado em APIs em massa ou API de streaming.

  • A clausula ser usado em uma consulta de nível superior e não é permitido na maioria das subconsultas.

  • Recomendamos o uso de um ORDER BY cláusula quando você usa OFFSET para garantir que a ordenação do conjunto de resultados seja consistente. 

  • A ordem das linhas de um conjunto de resultados que não tem um ORDER BY cláusula tem uma ordenação estável, no entanto, a chave de ordenação está sujeita a alterações e não deve ser considerada.

Clique aqui para acessar a documentação completa sobre LIMIT/OFFSET e mais informações sobre a linguagem SOQL.


Aqui chegamos ao fim de mais um artigo, caso surja mais dúvidas busque por outros artigos em nosso portal de suporte. Caso haja necessidade, envie um e-mail para 

suporte@ligai.com.br.