Cláusula LIMIT - ClickHouse Documentation

A cláusula LIMIT controla quantas linhas são retornadas no resultado da sua consulta.

Sintaxe básica

Selecione as primeiras linhas:

LIMIT m

Retorna as primeiras m linhas do resultado, ou todos os registros se houver menos de m. Sintaxe alternativa de TOP (compatível com o MS SQL Server):

-- SELECT TOP número|percentual nome_da(s)_coluna(s) FROM nome_da_tabela
SELECT TOP 10 * FROM numbers(100);
SELECT TOP 0.1 * FROM numbers(100);

Isso equivale a LIMIT m e pode ser usado por compatibilidade com consultas do Microsoft SQL Server. SELECT com OFFSET:

LIMIT m OFFSET n
-- ou de forma equivalente:
LIMIT n, m

Ignora as primeiras n linhas e retorna as próximas m linhas. Em ambas as formas, n e m devem ser inteiros não negativos.

Limites negativos

Selecione linhas do fim do conjunto de resultados usando valores negativos:

Sintaxe	Resultado
`LIMIT -m`	Últimas `m` linhas
`LIMIT -m OFFSET -n`	Últimas `m` linhas após ignorar as últimas `n` linhas
`LIMIT m OFFSET -n`	Primeiras `m` linhas após ignorar as últimas `n` linhas
`LIMIT -m OFFSET n`	Últimas `m` linhas após ignorar as primeiras `n` linhas

A sintaxe LIMIT -n, -m é equivalente a LIMIT -m OFFSET -n.

Limites fracionários

Use valores decimais entre 0 e 1 para selecionar uma porcentagem das linhas:

Sintaxe	Resultado
`LIMIT 0.1`	Primeiros 10% das linhas
`LIMIT 1 OFFSET 0.5`	A linha mediana
`LIMIT 0.25 OFFSET 0.5`	Terceiro quartil (25% das linhas após pular os primeiros 50%)

As frações devem ser valores Float64 maiores que 0 e menores que 1.
Contagens fracionárias de linhas são arredondadas para o número inteiro seguinte.

Combinando tipos de LIMIT

Você pode combinar inteiros padrão com offsets fracionários ou negativos:

LIMIT 10 OFFSET 0.5    -- 10 linhas a partir do ponto médio
LIMIT 10 OFFSET -20    -- 10 linhas após ignorar as últimas 20

LIMIT … WITH TIES

O modificador WITH TIES inclui linhas adicionais com os mesmos valores de ORDER BY da última linha dentro do limite.

SELECT * FROM (
    SELECT number % 50 AS n FROM numbers(100)
) ORDER BY n LIMIT 0, 5

┌─n─┐
│ 0 │
│ 0 │
│ 1 │
│ 1 │
│ 2 │
└───┘

Com WITH TIES, todas as linhas com o mesmo último valor são incluídas:

SELECT * FROM (
    SELECT number % 50 AS n FROM numbers(100)
) ORDER BY n LIMIT 0, 5 WITH TIES

┌─n─┐
│ 0 │
│ 0 │
│ 1 │
│ 1 │
│ 2 │
│ 2 │
└───┘

A linha 6 é incluída porque tem o mesmo valor (2) da linha 5. O mesmo acontece quando o offset é especificado com a palavra-chave OFFSET:

SELECT * FROM (
    SELECT number % 50 AS n FROM numbers(100)
) ORDER BY n LIMIT 3 OFFSET 2 WITH TIES

┌─n─┐
│ 1 │
│ 1 │
│ 2 │
│ 2 │
└───┘

Pular as 2 primeiras linhas e retornar 3 normalmente resultaria em 1, 1, 2, mas o segundo 2 é incluído porque tem o mesmo valor da última linha.

WITH TIES não é compatível com limites negativos.

Esse modificador pode ser combinado com o modificador ORDER BY ... WITH FILL.

Considerações

Resultados não determinísticos: Sem a cláusula ORDER BY, as linhas retornadas podem ser arbitrárias e variar entre execuções da consulta. Limite no servidor: O número de linhas retornadas também pode ser afetado pela configuração limit.

Veja também

LIMIT BY — Limita o número de linhas por grupo de valores, útil para obter os N principais resultados em cada categoria.

​Sintaxe básica

​Limites negativos

​Limites fracionários

​Combinando tipos de LIMIT

​LIMIT … WITH TIES

​Considerações

​Veja também

Sintaxe básica

Limites negativos

Limites fracionários

Combinando tipos de LIMIT

LIMIT … WITH TIES

Considerações

Veja também