numbers

numbers

연속된 정수 시퀀스를 담은 단일 number 컬럼을 가진 테이블을 반환하는 테이블 함수예요. 테스트와 연속 값 생성에 유용해요.

출처: 문서

본문

정수 시퀀스를 포함하는 단일 number 컬럼을 가진 테이블을 반환해요.

  • 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 간격으로 담은(약 M / S 행, 올림) 단일 number 컬럼(UInt64)을 가진 테이블을 반환해요. 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);

예시 (Examples)

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

sipHash64(number)가 20개의 후행 0 비트를 가지는 첫 번째 UInt64 >= 10^15를 찾아요.

SELECT number
FROM numbers()
WHERE number >= 1e15
 AND bitAnd(sipHash64(number), 0xFFFFF) = 0
LIMIT 1;
 ┌───────────number─┐
 │ 1000000000056095 │ -- 1.00 quadrillion
 └──────────────────┘

참고 (Notes)

  • 성능상의 이유로 필요한 행 수를 알고 있다면, 제한이 없는 numbers() / system.numbers보다 제한된 형태(numbers(N), numbers(N, M[, S]))를 선호하세요.
  • 병렬 생성을 위해서는 numbers_mt(...) 또는 system.numbers_mt 테이블을 사용하세요. 결과는 어떤 순서로든 반환될 수 있다는 점에 주의하세요.

더 알아보기 (Learn more)