Pular para o conteúdo principal

VillageSQL is a drop-in replacement for MySQL with extensions.

All examples on this page work on VillageSQL. Install Now →
LIMIT limita quantas linhas uma consulta retorna. É o que você usa para olhar o topo de uma tabela grande, e é o mecanismo por trás da paginação de resultados. Abra o cliente com mysql -u root -p sakila antes de começar.

Como o LIMIT funciona

Substitua ROW_COUNT por quantas linhas você quer e SKIP_COUNT por quantas pular primeiro. LIMIT vai por último, depois do ORDER BY. A parte OFFSET é opcional.

Exemplos

  1. As primeiras linhas

O resultado inteiro são 5 linhas, então a borda de fechamento e a contagem são o fim real dele, e não um corte.

  1. Pular algumas linhas primeiro

Linhas 11 a 15 da lista ordenada.

  1. A forma com 2 números

O MySQL também aceita o deslocamento e a contagem como um par separado por vírgula, deslocamento primeiro. Significa exatamente a mesma coisa.
Os mesmos 5 títulos do exemplo 2. Os 2 números aparecem na ordem oposta entre as 2 formas, o que é uma fonte confiável de confusão de um a mais ou a menos, então este tutorial escreve LIMIT ROW_COUNT OFFSET SKIP_COUNT.

LIMIT sem ORDER BY pede linhas arbitrárias

Tire o ORDER BY e a consulta ainda roda.
Esses são os mesmos 5 títulos que a consulta ordenada retornou, e é isso que torna isto perigoso. Nada na instrução os pediu nessa ordem. Pergunte ao servidor como ele rodou a consulta e ele diz por que eles voltaram desse jeito:
Não é preciso ir atrás desse 1 warning. EXPLAIN e EXPLAIN FORMAT=JSON anexam a Note 1003, que contém a consulta como o otimizador a reescreveu, e SHOW WARNINGS a imprime. A coluna key nomeia idx_title, um índice em title que já mantém a coluna em ordem, então ler o índice é o jeito mais barato de responder. As linhas chegaram ordenadas como efeito colateral dessa escolha. Remova esse índice, adicione outra coluna à lista de seleção, ou dê ao servidor mais dados, e a escolha pode mudar sem nenhuma mudança na sua consulta. LIMIT significa “quaisquer linhas” a menos que o ORDER BY diga quais.

Resumo

  • Use LIMIT para limitar quantas linhas voltam.
  • Adicione OFFSET para pular linhas antes de pegá-las.
  • Prefira LIMIT ROW_COUNT OFFSET SKIP_COUNT à forma com vírgula, que inverte os números.
  • Combine LIMIT com ORDER BY sempre, ou você estará pedindo linhas arbitrárias.

Veja também