メインコンテンツへスキップ
  • numbers() – 0 から始まる整数を昇順で含む、単一の number カラム (UInt64) を持つ無限テーブルを返します。行数を制限するには LIMIT (必要に応じて OFFSET も) を使用します。
  • numbers(N) – 0 から N - 1 までの整数を含む、単一の number カラム (UInt64) を持つテーブルを返します。
  • numbers(N, M)N から N + M - 1 までの M 個の整数を含む、単一の number カラム (UInt64) を持つテーブルを返します。
  • numbers(N, M, S)[N, N + M) の範囲の値をステップ S で含む、単一の number カラム (UInt64) を持つテーブルを返します (約 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);
>= 10^15 を満たす UInt64 のうち、sipHash64(number) の末尾に 0 ビットが 20 個連続する最初のものを見つけます。
SELECT number
FROM numbers()
WHERE number >= 1e15
  AND bitAnd(sipHash64(number), 0xFFFFF) = 0
LIMIT 1;
 ┌───────────number─┐
 │ 1000000000056095 │ -- 1.00 quadrillion
 └──────────────────┘

注意事項

  • パフォーマンス上の理由から、必要な行数がわかっている場合は、制限付きの形式 (numbers(N)numbers(N, M[, S])) を、制限のない numbers() / system.numbers より優先してください。
  • 並列生成を行う場合は、numbers_mt(...) または system.numbers_mt テーブルを使用してください。なお、結果は任意の順序で返される可能性があります。
最終更新日 2026年6月10日