| PostgreSQL 8.3.3문서 | ||||
|---|---|---|---|---|
| Prev | Fast Backward | Fast Forward | Next | |
이 명령은 주어진 명령문에 대해 PostgreSQL planner가 생성하는 실행 계획을 표시합니다. 이 실행 계획은 어떻게 그 테이블이 참조되는지 보여준다. 그 명령문은 단순한 순차석 스캔, 인텍스 스캔에 의해 스캔 될 것이지, 만약 복수의 테이블이 참조 될 경우 , 결합 알고리즘은 각 테이블로 부터 요구된 행의 결합을 할 것인지를 보여준다.
표시 되는 것의 문장의 실행에 걸리는 가격의 견적입니다. 이 가격은 planner가 명령문이 실행에 걸리는 시간(디스크 페이지 추출의 단위로 측정)을 추측한 것입니다. 구체적으로는, 2개의 수가 표시됩니다. 첫 행이 실행되기 전까지의 스타트 업 시간과 모든 행이 실행될 때까지의 합계 시간입니다. 대부분의 쿼리문에 있어 문제가 되는 것은 합계 시간이지만 EXISTS의 서브 쿼리문에서는 planner는 가장 짧은 합계 시간보다, 스타트 업 시간이 가장 짧아지는 플랜을 선택합니다.(executor는 첫 행이 실행한 후에 정지 할 것입니다.) 또한, LIMIT절을 실행할 때 행수를 제한하는 경우, planner는 실제 가장 싼 계획의 견적과 전체를 처리했을 경우의 가격 사이에 적절한 어구를 만듭니다.
ANALYZE옵션은 명령문의 실제 계획을 만들 뿐만 아니라, 명령문이 실제로 실행됩니다. 이 경우는 각 계획 노드로 소비된 총경과시간(밀리 세컨드 단위)과 실제로 돌려주어지는 행수도 표시됩니다. planner의 추측과 실제의 값이 어느 정도 맞는지를 확인하는 것이 유용합니다.
Important: ANALYZE를 사용했을 경우는, 문장이 실제로 실행되는 것을 잊지 말아 주세요. EXPLAIN는 SELECT가 실행 된 후의 결과물을 버리지만 명령에 수반하는 부작용은 발생합니다. INSERT,UPDATE,DELETE,EXECUTE문에 대해서, 데이터에 영향을 주지 않게EXPLAIN ANALYZE를 실행하고 싶은 경우는, 이하의 방법을 사용해 주세요.
BEGIN; EXPLAIN ANALYZE ...; ROLLBACK;
명령을 실행하고 실제의 실행 시간을 표시합니다.
요약 보다는 계획 트리의 내부 표현을 모두 표시합니다. 일반적으로 이 옵션은 특별한 디버깅의 목적일 때, 유용합니다. VERBOSE의 출력물은 explain_pretty_print 구성 매개변수의 설정에 의존하여 인쇄에 적절한 형태일 수도 아닐 수도 있습니다.
실행 계획의 표시 대상이 되는,SELECT,INSERT,UPDATE,DELETE,VALUES,EXECUTE,DECLARE의 몇개의 문장입니다.
PostgreSQL의 optimizer의 가격 정보의 사용에 관한 문서는 많지 않습니다. 자세한 정보에 대해서는,Section 13.1을 참조해 주세요.
PostgreSQL문의 planner가 충분한 정보를 사용해 문의를 최적화할 수 있도록(듯이) 하려면 , ANALYZE 문장을 실행해, 테이블내의 데이터 분포에 대한 통계 정보를 기록해 두지 않으면 안됩니다. 이것을 실시하지 않는 경우(혹은 ANALYZE를 실행한 후, 테이블내의 데이터의 통계적 분포가 큰폭으로 바뀌었을 때), 추정 코스트가 쿼리문의 실제 특성과는 일치하지 않을 우려가 높고, 그 결과, 부적절한 쿼리문의 계획이 선택될 가능성이 있습니다.
유전적 쿼리문의 최적화(GEQO)는 불규칙적으로 실행 계획을 시험합니다. 따라서, 결합 관계의 수가 유전적 쿼리문의 최적화의 사용이 시작되는geqo_threshold을 넘으면, 실행 계획은 명령문이 실행하는 각 시간이 변화합니다.
integer열과 10000행이 존재하는 테이블에 대에서 단순한 쿼리문의 계획을 표시합니다.
EXPLAIN SELECT * FROM foo;
QUERY PLAN
---------------------------------------------------------
Seq Scan on foo (cost=0.00..155.00 rows=10000 width=4)
(1 row)
인덱스가 존재하고 쿼리의WHERE조건으로 인덱스를 이용할 수 있는 경우, EXPLAIN는 다른 계획을 표시할 가능성이 있습니다.
EXPLAIN SELECT * FROM foo WHERE i = 4;
QUERY PLAN
--------------------------------------------------------------
Index Scan using fi on foo (cost=0.00..5.98 rows=1 width=4)
Index Cond: (i = 4)
(2 rows)
다음은 집약 함수를 사용한 쿼리에 대한 쿼리 계획의 예를 나타냅니다.
EXPLAIN SELECT sum(i) FROM foo WHERE i < 10;
QUERY PLAN
---------------------------------------------------------------------
Aggregate (cost=23.93..23.93 rows=1 width=4)
-> Index Scan using fi on foo (cost=0.00..23.92 rows=6 width=4)
Index Cond: (i < 10)
(3 rows)
이하는 EXPLAIN EXECUTE에 의해 준비된 쿼리에 대한 실행 계획을 표시하는 예입니다.
PREPARE query(int, int) AS SELECT sum(bar) FROM test
WHERE id > $1 AND id < $2
GROUP BY foo;
EXPLAIN ANALYZE EXECUTE query(100, 200);
QUERY PLAN
-------------------------------------------------------------------------------------------------------------------------
HashAggregate (cost=39.53..39.53 rows=1 width=8) (actual time=0.661..0.672 rows=7 loops=1)
-> Index Scan using test_pkey on test (cost=0.00..32.97 rows=1311 width=8) (actual time=0.050..0.395 rows=99 loops=1)
Index Cond: ((id > $1) AND (id < $2))
Total runtime: 0.851 ms
(4 rows)
물론, 여기서 가리킨 구체적인 수치는 대상으로 하는 테이블의 실제의 내용에 의해 바뀝니다. 또, 이 수치나 선택된 쿼리문의 전략은 planner의 향상을 위해 PostgreSQL의 릴리스간에 다를 가능성이 있기 때문에 주의해 주세요. 게다가ANALYZE명령은 데이터의 통계 정보를 추정할 때에 랜덤인 샘플링을 사용합니다.