ClickHouse/docs/en/sql-reference/table-functions/numbers.md

Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

40 lines
1.2 KiB
Markdown
Raw Normal View History

2020-04-03 13:23:32 +00:00
---
2022-08-28 14:53:34 +00:00
slug: /en/sql-reference/table-functions/numbers
sidebar_position: 145
sidebar_label: numbers
2020-04-03 13:23:32 +00:00
---
2022-06-02 10:55:18 +00:00
# numbers
2020-03-20 10:10:48 +00:00
`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).
2024-03-18 16:17:54 +00:00
`numbers(N, M, S)` - Returns a table with the single number column (UInt64) that contains integers from N to (N + M - 1) with step S.
2018-09-06 18:15:16 +00:00
Similar to the `system.numbers` table, it can be used for testing and generating successive values, `numbers(N, M)` more efficient than `system.numbers`.
2018-04-23 06:20:21 +00:00
The following queries are equivalent:
2020-03-20 10:10:48 +00:00
``` sql
SELECT * FROM numbers(10);
2018-09-06 18:15:16 +00:00
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);
```
2024-03-18 16:17:54 +00:00
And the following queries are equivalent:
``` sql
SELECT number * 2 FROM numbers(10);
SELECT (number - 10) * 2 FROM numbers(10, 10);
SELECT * FROM numbers(0, 20, 2);
```
2018-04-23 06:20:21 +00:00
Examples:
2020-03-20 10:10:48 +00:00
``` sql
2018-09-06 18:15:16 +00:00
-- Generate a sequence of dates from 2010-01-01 to 2010-12-31
select toDate('2010-01-01') + number as d FROM numbers(365);
```