EXPLAIN query는 PostgreSQL이 쿼리에 고른 실행 계획을 보여 줍니다. 추정 비용과 행 수가 붙은 단계(노드)의 트리입니다. EXPLAIN ANALYZE query는 쿼리를 실제로 실행해 노드마다 실제 시간, 행 수, 반복 횟수를 더합니다. 트리는 가장 안쪽으로 들여 쓴 노드부터 바깥으로 읽습니다. 안쪽 노드가 자기 행을 위의 노드로 넘깁니다.
email에 인덱스가 없으므로 실행 계획은 Seq Scan입니다. PostgreSQL이 모든 행을 읽고 Filter를 통과한 행만 남깁니다. Rows Removed by Filter가 낭비된 작업을 보여 줍니다. 시간은 실행할 때마다 다르니, 숫자보다 실행 계획의 모양이 더 중요합니다.
실행 계획 한 줄 읽기
노드마다 다음 형태의 줄이 출력됩니다:
Seq Scan on users (cost=STARTUP..TOTAL rows=N width=W) (actual time=FIRST..LAST rows=N loops=L)
| 부분 | 의미 |
|---|---|
cost=STARTUP..TOTAL | 첫 행까지의 추정 작업량과 전체 행의 추정 작업량, 플래너 단위(밀리초가 아님) |
rows (첫 번째) | 노드가 돌려줄 것으로 추정한 행 수 |
width | 추정한 평균 행 크기(바이트) |
actual time | 반복 한 번당 첫 행까지, 마지막 행까지 걸린 밀리초 |
rows (actual) | 반복 한 번당 돌려준 행 수 |
loops | 노드가 실행된 횟수. 시간과 행 수에 이 값을 곱합니다 |
부모 노드의 비용에는 자식 노드의 비용이 포함됩니다. 맨 아래의 Planning Time과 Execution Time은 문장 전체의 합계입니다.
자주 보는 실행 계획 노드 알아보기
EXPLAIN (COSTS OFF)는 숫자를 숨겨 실행 계획의 모양을 보기 쉽게 합니다:
안쪽부터 읽으세요. 두 테이블을 모두 스캔하고, 걸러진 고객은 Hash로 들어갑니다. Hash Join이 주문마다 그 해시를 조회하고, 맨 위의 GroupAggregate가 결과를 셉니다. 가장 자주 만나는 노드는 다음과 같습니다:
| 노드 | 하는 일 |
|---|---|
Seq Scan | 테이블 전체를 읽음 |
Index Scan | 인덱스로 행을 찾은 뒤, 각 행을 테이블에서 읽음 |
Index Only Scan | 테이블에 가지 않고 인덱스만으로 답함 |
Bitmap Index Scan + Bitmap Heap Scan | 인덱스에서 맞는 행의 위치를 모은 뒤, 테이블 순서대로 읽음 |
Nested Loop | 바깥 행마다 안쪽 입력에서 맞는 행을 찾음. 바깥쪽이 작을 때 좋음 |
Hash Join + Hash | 한 입력으로 해시 테이블을 만들고, 다른 입력으로 조회함 |
Merge Join | 조인 키로 이미 정렬된 두 입력을 조인함 |
Sort, Incremental Sort | ORDER BY, DISTINCT, 머지 조인을 위해 행을 정렬함 |
HashAggregate, GroupAggregate | 해시 테이블로, 또는 정렬된 입력 위에서 GROUP BY를 수행함 |
Limit | N행 뒤에 멈춤 |
Gather | 병렬 워커에서 행을 모음 |
잘못된 행 수 추정 찾기
EXPLAIN ANALYZE에서 가장 쓸모 있는 확인은 같은 노드의 추정 rows와 실제 rows를 비교하는 것입니다. 둘이 크게 다르면 플래너가 틀린 숫자로 실행 계획을 고른 것이고, 대개 통계가 없거나 오래되었기 때문입니다:
스캔은 실제로 10행을 돌려주지만, 테이블을 아직 분석하지 않아서 추정치는 훨씬 큽니다. EXPLAIN 앞에 ANALYZE tasks;를 넣으면 추정치가 10에 가까워집니다. autovacuum이 백그라운드에서 테이블을 분석하지만, 대량 적재 뒤에는 직접 ANALYZE를 실행하세요(VACUUM과 autovacuum 참고).
데이터를 남기지 않고 변경 문장 분석하기
EXPLAIN ANALYZE는 문장을 실행하므로 UPDATE나 DELETE는 행을 바꿉니다. 트랜잭션으로 감싸고 롤백하세요:
롤백 뒤에도 1000행이 모두 남아 있습니다.
BUFFERS 등 옵션으로 I/O 보기
EXPLAIN (ANALYZE, BUFFERS) SELECT ...; -- pages read from cache (hit) and disk (read)
EXPLAIN (ANALYZE, BUFFERS, SETTINGS) SELECT ...; -- also list changed planner settings
EXPLAIN (FORMAT JSON) SELECT ...; -- machine-readable, for plan visualizers
EXPLAIN (ANALYZE, TIMING OFF) SELECT ...; -- row counts without per-node timing overhead
BUFFERS는 I/O를 보여 줍니다. read 페이지가 많은 노드는 디스크까지 갔다는 뜻입니다. PostgreSQL 17에서는 SERIALIZE(출력 행을 텍스트로 바꾸는 비용)와 MEMORY(플래너 메모리)가 추가되었습니다. 더 많은 실행 계획은 EXPLAIN 공식 가이드에서 살펴볼 수 있습니다.
플래너 설정으로 실행 계획 시험하기
어떤 방식이 없을 때 PostgreSQL이 쓸 실행 계획을 보려면, 세션에서 그 방식을 꺼 보세요. 실험할 때만 쓰고, 운영 코드에서는 절대 쓰지 마세요:
행이 100개면 플래너는 Seq Scan을 선호하지만, enable_seqscan = off에서는 실행 계획에 Index Scan using items_pkey가 나옵니다. 두 EXPLAIN ANALYZE의 시간을 비교해 인덱스가 도움이 되는지 확인하세요. RESET enable_seqscan;은 기본값으로 되돌립니다.
자주 묻는 질문
EXPLAIN과 EXPLAIN ANALYZE는 무엇이 다른가요?
EXPLAIN은 쿼리의 실행 계획만 세우고 추정치를 보여 줍니다. EXPLAIN ANALYZE는 쿼리를 실제로 실행해 노드마다 실제 시간, 행 수, 반복 횟수를 더하므로, 쿼리 자체만큼 시간이 걸립니다.
PostgreSQL 실행 계획의 cost는 무슨 뜻인가요?
cost는 플래너가 임의 단위로 추정한 값으로, 페이지 하나를 순차적으로 읽는 비용이 1(seq_page_cost)이 되도록 맞춰져 있습니다. 같은 쿼리의 실행 계획끼리 비교할 때 쓰며, 밀리초 단위의 시간이 아닙니다.
EXPLAIN ANALYZE는 데이터를 바꾸나요?
네. INSERT, UPDATE, DELETE, MERGE라면 변경을 실제로 수행합니다. 결과를 남기지 않고 측정하려면 BEGIN과 ROLLBACK 사이에서 실행하세요.
인덱스가 있는데 왜 Seq Scan이 선택되나요?
플래너가 그쪽이 더 싸다고 추정했기 때문입니다. 테이블이 작거나, 쿼리가 행의 큰 비율을 돌려주거나, 조건이 인덱스를 쓸 수 없는 경우입니다. 오래된 통계 때문에 잘못 판단하기도 하는데, 이는 ANALYZE로 고칩니다.