generate_series(start, stop, step)은 start부터 stop까지(stop 포함) step씩(생략하면 1) 움직이며 값마다 한 행을 돌려줍니다. 정수, numeric, 그리고 interval 간격을 쓰는 타임스탬프에 동작합니다. FROM에서 테이블처럼 씁니다.
1, 4, 7, 10과 각각의 제곱을 돌려줍니다. 간격이 음수면 거꾸로 셉니다: generate_series(5, 1, -2)는 5, 3, 1입니다. generate_series(5, 1)처럼 끝에 닿을 수 없는 시리즈는 행을 돌려주지 않습니다. generate_series(0, 1, 0.25)는 numeric 값으로 움직입니다.
날짜 시리즈 만들기
타임스탬프나 날짜를 interval 간격과 함께 넘기세요. date 버전은 없어서 값이 timestamptz로 나오므로 ::date로 형 변환합니다:
2월 26일부터 월말을 넘어 3월 2일까지 5일이 나옵니다. 간격에는 interval '1 hour', interval '15 minutes', interval '1 month', interval '1 week' 등 어떤 interval이든 쓸 수 있습니다.
timestamptz 값에서 interval '1 day' 간격은 세션 TimeZone의 달력을 따릅니다. 서머타임이 바뀌는 날에는 한 간격이 23시간이나 25시간이 될 수 있습니다. PostgreSQL 16부터는 네 번째 인자로 세션 설정과 상관없이 간격을 계산할 시간대를 지정할 수 있습니다:
SELECT generate_series(
timestamptz '2026-03-28 00:00 Europe/Berlin',
timestamptz '2026-03-31 00:00 Europe/Berlin',
interval '1 day',
'Europe/Berlin');
보고서의 빠진 날짜 채우기
데이터에 GROUP BY를 걸면 행이 있는 기간만 나옵니다. 주문이 없는 날도 0으로 보여 주려면 날짜를 생성하고 데이터를 LEFT JOIN하세요:
11월 1일은 주문 2건, 4일은 1건이고, 2일, 3일, 5일은 0입니다. count(*)가 아니라 조인한 테이블의 컬럼(count(o.id))을 세세요. 그렇지 않으면 빈 날도 모두 1로 셉니다.
created_at::date = d 대신 created_at을 범위로 비교하면 created_at의 인덱스를 쓸 수 있습니다. 같은 패턴에 interval '1 month'와 date_trunc를 쓰면 빈 달을 채울 수 있습니다(날짜 함수 참고).
테스트 데이터 만들기
시리즈에서 INSERT ... SELECT를 하면 한 문장으로 필요한 만큼 행을 만들 수 있습니다:
테이블에 가입일 30일에 걸친 사용자 1,000명이 들어갑니다. 값은 i로 계산하므로 실행할 때마다 결과가 같습니다. 값이 매번 달라지길 원하면 random()을 쓰세요. 같은 방법으로 백만 행을 만들어 인덱스를 시험하고 EXPLAIN ANALYZE로 실행 계획을 비교해 보세요.
행에 번호 붙이기와 조인에서 시리즈 쓰기
WITH ORDINALITY는 집합을 반환하는 함수 어디에나 위치 컬럼을 더합니다:
09:00부터 10:00까지 15분 간격 슬롯 다섯 개가 1부터 5까지 번호와 함께 나옵니다. 시리즈는 CROSS JOIN에서도 쓸 수 있습니다. 예를 들어 모든 사용자를 한 달의 모든 날과 짝지을 수 있습니다.
SELECT 목록에 쓴 generate_series도 여러 행을 돌려주지만, 길이가 다른 두 호출을 쓰면 짧은 쪽이 NULL로 채워집니다. 집합을 반환하는 함수는 FROM에 두세요. 트리 탐색처럼 함수 하나로 표현할 수 없는 시리즈에는 재귀 CTE를 쓰세요.
자주 묻는 질문
generate_series는 끝 값을 포함하나요?
간격이 끝 값에 정확히 닿으면 포함합니다: generate_series(1, 5)는 1부터 5까지 돌려줍니다. 닿지 않으면 끝 값을 넘지 않는 마지막 값에서 멈추므로, generate_series(1, 10, 4)는 1, 5, 9를 돌려줍니다.
MySQL에도 generate_series가 있나요?
없습니다. MySQL에서는 재귀 CTE(WITH RECURSIVE)로 시리즈를 만듭니다. 이 방법은 PostgreSQL에서도 되지만 쓰기가 더 깁니다.
날짜로 generate_series를 쓰면 왜 타임스탬프가 나오나요?
이 함수에는 date 버전이 없어서 PostgreSQL이 timestamptz 버전을 씁니다. 각 값을 ::date로 다시 형 변환하세요.
행마다 난수를 만들려면 어떻게 하나요?
SELECT 목록에서 random()을 호출하세요: SELECT i, random() FROM generate_series(1, 5) AS i는 행마다 0과 1 사이의 값을, floor(random() * 100)::int는 0부터 99까지의 정수를 줍니다. PostgreSQL 17부터는 random(1, 100)이 그 범위의 정수 난수를 바로 돌려줍니다.