numbers

Retorna uma tabela com uma única coluna number que contém uma sequência de inteiros.

• numbers() – Retorna uma tabela infinita com uma única coluna number (UInt64) que contém inteiros em ordem crescente, começando em 0. Use LIMIT (e, opcionalmente, OFFSET) para limitar o número de linhas.

• numbers(N) – Retorna uma tabela com uma única coluna number (UInt64) que contém inteiros de 0 a N - 1.

• numbers(N, M) – Retorna uma tabela com uma única coluna number (UInt64) que contém M inteiros de N a N + M - 1.

• numbers(N, M, S) – Retorna uma tabela com uma única coluna number (UInt64) que contém valores em [N, N + M) com passo S (cerca de M / S linhas, arredondado para cima). S deve ser >= 1.

É semelhante à tabela de sistema system.numbers. Ela pode ser usada para testes e para gerar valores sequenciais.

As consultas a seguir são equivalentes:

SELECT * FROM numbers(10);
SELECT * FROM numbers(0, 10);
SELECT * FROM numbers() LIMIT 10;
SELECT * FROM system.numbers LIMIT 10;
SELECT * FROM system.numbers WHERE number BETWEEN 0 AND 9;
SELECT * FROM system.numbers WHERE number IN (0, 1, 2, 3, 4, 5, 6, 7, 8, 9);

As consultas a seguir também são equivalentes:

SELECT * FROM numbers(10, 10);
SELECT * FROM numbers() LIMIT 10 OFFSET 10;
SELECT * FROM system.numbers LIMIT 10 OFFSET 10;

As consultas a seguir também são equivalentes:

SELECT number * 2 FROM numbers(10);
SELECT (number - 10) * 2 FROM numbers(10, 10);
SELECT * FROM numbers(0, 20, 2);

​

Exemplos

Os 10 primeiros números.

SELECT * FROM numbers(10);

 ┌─number─┐
 │      0 │
 │      1 │
 │      2 │
 │      3 │
 │      4 │
 │      5 │
 │      6 │
 │      7 │
 │      8 │
 │      9 │
 └────────┘

Gere uma sequência de datas de 2010-01-01 até 2010-12-31.

SELECT toDate('2010-01-01') + number AS d FROM numbers(365);

Encontre o primeiro UInt64 >= 10^15 cujo sipHash64(number) tenha 20 bits de zero à direita.

SELECT number
FROM numbers()
WHERE number >= 1e15
  AND bitAnd(sipHash64(number), 0xFFFFF) = 0
LIMIT 1;

 ┌───────────number─┐
 │ 1000000000056095 │ -- 1.00 quadrillion
 └──────────────────┘

​

Observações

• Por motivos de desempenho, se você souber quantas linhas são necessárias, prefira formas limitadas (numbers(N), numbers(N, M[, S])) em vez das formas sem limite numbers() / system.numbers.
• Para geração paralela, use numbers_mt(...) ou a tabela system.numbers_mt. Observe que os resultados podem ser retornados em qualquer ordem.