ClickHouse/docs/en/sql-reference/table-functions/numbers.md
2023-12-01 19:59:25 +01:00

940 B
Raw Blame History

slug sidebar_position sidebar_label
/en/sql-reference/table-functions/numbers 145 numbers

numbers

numbers(N) Returns a table with the single number column (UInt64) that contains integers from 0 to N-1. numbers(N, M) - Returns a table with the single number column (UInt64) that contains integers from N to (N + M - 1).

Similar to the system.numbers table, it can be used for testing and generating successive values, numbers(N, M) more efficient than system.numbers.

The following queries are equivalent:

SELECT * FROM numbers(10);
SELECT * FROM numbers(0, 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);

Examples:

-- Generate a sequence of dates from 2010-01-01 to 2010-12-31
select toDate('2010-01-01') + number as d FROM numbers(365);