본문 바로가기
Q&A2026년 4월 18일1분 읽기

PostgreSQL 쿼리가 EXPLAIN에서는 Index Scan인데 실제 실행하면 Seq Scan으로 돕니다

개
개발자준호
조회 524댓글 3

같은 쿼리인데 EXPLAIN은 Index Scan을 보여주고, EXPLAIN ANALYZE로 실제 돌리면 Seq Scan이 찍힙니다.

EXPLAIN
SELECT * FROM orders WHERE user_id = 123 AND created_at >= '2026-01-01';

-- 결과: Index Scan using idx_orders_user_id

EXPLAIN ANALYZE
SELECT * FROM orders WHERE user_id = 123 AND created_at >= '2026-01-01';

-- 결과: Seq Scan on orders (cost=... actual time=...)

이게 어떻게 된 일인가요? 플래너가 거짓말을 하는 건가요?

이전 글
Docker 이미지가 M2 Mac에서는 되는데 GitHub Actions(x86)에서는 "exec format error"로 실패합니다
다음 글
AWS Lambda Node.js cold start가 10초 넘게 걸려요 (번들 사이즈 15MB)

댓글 3

김김영삼6개월 전

거짓말은 아닙니다. EXPLAIN(ANALYZE 없음)은 실행을 하지 않고 계획만 보여줍니다. 그리고 PostgreSQL 플래너는 실행 직전에 통계 기반으로 계획을 다시 결정합니다. 사이에 다음 중 하나가 발생하면 계획이 바뀝니다.



  1. 통계 드리프트: 마지막 ANALYZE 이후 데이터가 많이 바뀌어 실행 시점엔 Seq가 싸다고 판단

  2. plan caching: prepared statement/PL에서 generic plan이 캐시돼 조건에 따라 바뀜

  3. 파라미터 값에 따른 선택성 재평가: user_id=123인 행이 전체의 40%라면 Index가 오히려 느림

  4. random_page_cost / effective_cache_size 기본값이 SSD 환경에서 비현실적


1차 진단
-- 통계 최신화
ANALYZE orders;

-- user_id=123의 선택성 확인
SELECT n_distinct, most_common_vals, most_common_freqs
  FROM pg_stats WHERE tablename = 'orders' AND attname = 'user_id';

-- 실제 행 수
SELECT count(*) FROM orders WHERE user_id = 123;
-- vs
SELECT count(*) FROM orders;

123인 행이 5% 이상이면 플래너가 Seq를 고르는 게 정상입니다.


2차: random_page_cost

기본값 4.0은 HDD 기준입니다. SSD/NVMe면 1.1~1.5로 내리는 게 표준.


-- postgresql.conf 또는 ALTER SYSTEM
random_page_cost = 1.1
effective_cache_size = '24GB'   # 호스트 RAM의 50~75%

3차: 복합 인덱스로 유도

조건이 user_id와 created_at 복합이면 복합 인덱스가 답입니다.


CREATE INDEX idx_orders_user_created ON orders(user_id, created_at DESC);

4차: prepared statement 함정

드라이버에서 prepare 후 execute를 반복하면 generic plan이 캐시됩니다. 특정 파라미터에서만 이상하다면 이게 원인입니다. plan_cache_mode = force_custom_plan으로 세션에서 강제 가능.


보통은 1번(통계 드리프트)과 2번(cost 파라미터)로 80% 이상 해결됩니다.

데데이터사이언스현6개월 전

저는 prod에서 auto_explain을 기본으로 켜놔서, 느린 쿼리의 실제 plan이 로그에 남도록 해둡니다. EXPLAIN만으론 진실이 안 보여서요.


-- postgresql.conf
shared_preload_libraries = 'auto_explain'
auto_explain.log_min_duration = '500ms'
auto_explain.log_analyze = on
auto_explain.log_buffers = on

이거 도입하면 plan 문제의 90%는 자연스럽게 추적됩니다.

개개발자준호6개월 전

ANALYZE 한번 돌리니까 실제로 Index Scan으로 바뀌네요. 통계가 하루 전이었어요. random_page_cost도 1.1로 내렸습니다. auto_explain은 운영에 바로 넣어야겠네요. 감사합니다!

Ctrl+Enter로 등록