Menu

PostgreSQL EXPLAIN ANALYZE: jak czytać plan zapytania

EXPLAIN pokazuje plan, który PostgreSQL wybiera dla zapytania, a EXPLAIN ANALYZE wykonuje zapytanie i dodaje rzeczywiste liczby wierszy i czasy każdego kroku. Naucz się czytać drzewo planu i popularne węzły.

Na tej stronie są działające edytory: edytuj, uruchamiaj i od razu zobacz wynik.

EXPLAIN query pokazuje plan, który PostgreSQL wybiera dla zapytania: drzewo kroków (węzłów) z szacowanymi kosztami i liczbami wierszy. EXPLAIN ANALYZE query dodatkowo wykonuje zapytanie i dodaje rzeczywisty czas, wiersze i pętle każdego węzła. Czytaj drzewo od najbardziej wciętego węzła na zewnątrz: węzły wewnętrzne przekazują swoje wiersze węzłowi powyżej.

Na email nie ma indeksu, więc plan to Seq Scan: PostgreSQL czyta każdy wiersz i zostawia te, które przechodzą przez Filter. Rows Removed by Filter pokazuje zmarnowaną pracę. Czasy są inne przy każdym uruchomieniu; kształt planu znaczy więcej niż liczby.

Czytanie jednej linii planu

Każdy węzeł wypisuje linię w takim kształcie:

Seq Scan on users  (cost=STARTUP..TOTAL rows=N width=W) (actual time=FIRST..LAST rows=N loops=L)
CzęśćZnaczenie
cost=STARTUP..TOTALszacowana praca przed pierwszym wierszem i dla wszystkich wierszy, w jednostkach planera (nie w milisekundach)
rows (pierwsze)szacowana liczba wierszy zwracanych przez węzeł
widthszacowany średni rozmiar wiersza w bajtach
actual timemilisekundy do pierwszego i do ostatniego wiersza, na pętlę
rows (actual)zwrócone wiersze na pętlę
loopsile razy węzeł się wykonał; pomnóż przez to czas i wiersze

Koszty węzła nadrzędnego obejmują jego dzieci. Planning Time i Execution Time na dole to sumy dla całego polecenia.

Popularne węzły planu

EXPLAIN (COSTS OFF) ukrywa liczby, więc kształt planu łatwiej zobaczyć:

Czytaj od środka. Obie tabele są skanowane, a przefiltrowani klienci trafiają do Hash. Hash Join sprawdza go każdym zamówieniem, a GroupAggregate na górze liczy wynik. Węzły, które spotkasz najczęściej:

WęzełCo robi
Seq Scanczyta całą tabelę
Index Scanznajduje wiersze przez indeks, a potem czyta każdy wiersz z tabeli
Index Only Scanodpowiada z indeksu bez zaglądania do tabeli
Bitmap Index Scan + Bitmap Heap Scanzbiera z indeksu położenia pasujących wierszy, a potem czyta je w kolejności tabeli
Nested Loopdla każdego wiersza zewnętrznego szuka dopasowań w wejściu wewnętrznym; dobre, gdy strona zewnętrzna jest mała
Hash Join + Hashbuduje tablicę haszującą z jednego wejścia i sprawdza ją drugim
Merge Joinzłącza dwa wejścia już posortowane po kluczu złączenia
Sort, Incremental Sortsortuje wiersze dla ORDER BY, DISTINCT albo złączenia merge
HashAggregate, GroupAggregateGROUP BY z tablicą haszującą albo na posortowanym wejściu
Limitzatrzymuje się po N wierszach
Gatherzbiera wiersze od równoległych workerów

Wykrywanie złych szacunków liczby wierszy

Najbardziej przydatne sprawdzenie w EXPLAIN ANALYZE to porównanie szacowanych rows z rzeczywistymi rows w tym samym węźle. Gdy mocno się różnią, planer wybrał plan na podstawie złych liczb, często dlatego, że statystyk brakuje albo są nieaktualne:

Skan zwraca w rzeczywistości 10 wierszy, ale szacunek jest dużo wyższy, bo tabela nie została jeszcze przeanalizowana. Dodaj ANALYZE tasks; przed EXPLAIN, a szacunek zbliży się do 10. Autovacuum analizuje tabele w tle, ale po masowym ładowaniu danych uruchom ANALYZE sam (zobacz VACUUM i autovacuum).

Plan zmiany danych bez jej zachowania

EXPLAIN ANALYZE wykonuje polecenie, więc UPDATE albo DELETE zmienia wiersze. Opakuj je w transakcję i wycofaj:

Po wycofaniu wszystkie 1000 wierszy nadal są na miejscu.

I/O przez BUFFERS i inne opcje

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 pokazuje I/O: węzeł z wieloma stronami read sięgał na dysk. PostgreSQL 17 dodał SERIALIZE (koszt zamiany wierszy wyniku na tekst) i MEMORY (pamięć planera). Oficjalny przewodnik po EXPLAIN omawia więcej planów.

Testowanie planu ustawieniami planera

Żeby zobaczyć plan, którego PostgreSQL użyłby bez jakiejś metody, wyłącz tę metodę w swojej sesji. Rób to tylko w eksperymentach, nigdy w kodzie produkcyjnym:

Przy 100 wierszach planer woli Seq Scan; z enable_seqscan = off plan pokazuje Index Scan using items_pkey. Porównaj oba czasy z EXPLAIN ANALYZE, żeby sprawdzić, czy indeks pomaga. RESET enable_seqscan; przywraca ustawienie domyślne.

Najczęściej zadawane pytania

Czym różni się EXPLAIN od EXPLAIN ANALYZE?

EXPLAIN tylko planuje zapytanie i pokazuje szacunki. EXPLAIN ANALYZE dodatkowo je wykonuje i dodaje rzeczywisty czas, liczbę wierszy i liczbę pętli każdego węzła, więc trwa tyle co samo zapytanie.

Co oznacza cost w planie PostgreSQL?

Cost to szacunek planera w umownych jednostkach, przeskalowany tak, że sekwencyjny odczyt jednej strony kosztuje 1 (seq_page_cost). Przydaje się do porównywania planów tego samego zapytania, a nie jako czas w milisekundach.

Czy EXPLAIN ANALYZE zmienia dane?

Tak, dla INSERT, UPDATE, DELETE i MERGE wykonuje zmianę. Uruchom je między BEGIN a ROLLBACK, żeby zmierzyć czas bez zachowania wyniku.

Dlaczego wybrany jest Seq Scan, choć istnieje indeks?

Bo planer uznaje go za tańszy: tabela jest mała, zapytanie zwraca dużą część wierszy albo warunek nie może użyć indeksu. W błąd mogą go też wprowadzić nieaktualne statystyki, co naprawia ANALYZE.

Ilustracja języków programowania w Coddy

Ucz się programowania z Coddy

Zacznij