numbers

Возвращает таблицу с единственным столбцом number, содержащим последовательность целых чисел.

• numbers() – Возвращает бесконечную таблицу с единственным столбцом number (UInt64), содержащим целые числа в возрастающем порядке, начиная с 0. Используйте LIMIT (и при необходимости OFFSET), чтобы ограничить количество строк.

• numbers(N) – Возвращает таблицу с единственным столбцом number (UInt64), содержащим целые числа от 0 до N - 1.

• numbers(N, M) – Возвращает таблицу с единственным столбцом number (UInt64), содержащим M целых чисел от N до N + M - 1.

• numbers(N, M, S) – Возвращает таблицу с единственным столбцом number (UInt64), содержащим значения в диапазоне [N, N + M) с шагом S (примерно M / S строк с округлением вверх). S должно быть >= 1.

Это похоже на системную таблицу system.numbers. Ее можно использовать для тестирования и генерации последовательных значений.

Следующие запросы эквивалентны:

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);

Следующие запросы также эквивалентны:

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

Следующие запросы также эквивалентны:

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

​

Примеры

Первые 10 чисел.

SELECT * FROM numbers(10);

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

Сгенерируйте последовательность дат с 2010-01-01 по 2010-12-31.

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

Найдите первое значение UInt64 >= 10^15, для которого sipHash64(number) имеет 20 завершающих нулевых битов.

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

 ┌───────────number─┐
 │ 1000000000056095 │ -- 1,00 квадриллиона
 └──────────────────┘

​

Примечания

• Из соображений производительности, если вы знаете, сколько строк вам нужно, отдавайте предпочтение ограниченным формам (numbers(N), numbers(N, M[, S])) вместо неограниченных numbers() / system.numbers.
• Для параллельной генерации используйте numbers_mt(...) или таблицу system.numbers_mt. Обратите внимание, что результаты могут возвращаться в произвольном порядке.