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..TOTAL | szacowana praca przed pierwszym wierszem i dla wszystkich wierszy, w jednostkach planera (nie w milisekundach) |
rows (pierwsze) | szacowana liczba wierszy zwracanych przez węzeł |
width | szacowany średni rozmiar wiersza w bajtach |
actual time | milisekundy do pierwszego i do ostatniego wiersza, na pętlę |
rows (actual) | zwrócone wiersze na pętlę |
loops | ile 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 Scan | czyta całą tabelę |
Index Scan | znajduje wiersze przez indeks, a potem czyta każdy wiersz z tabeli |
Index Only Scan | odpowiada z indeksu bez zaglądania do tabeli |
Bitmap Index Scan + Bitmap Heap Scan | zbiera z indeksu położenia pasujących wierszy, a potem czyta je w kolejności tabeli |
Nested Loop | dla każdego wiersza zewnętrznego szuka dopasowań w wejściu wewnętrznym; dobre, gdy strona zewnętrzna jest mała |
Hash Join + Hash | buduje tablicę haszującą z jednego wejścia i sprawdza ją drugim |
Merge Join | złącza dwa wejścia już posortowane po kluczu złączenia |
Sort, Incremental Sort | sortuje wiersze dla ORDER BY, DISTINCT albo złączenia merge |
HashAggregate, GroupAggregate | GROUP BY z tablicą haszującą albo na posortowanym wejściu |
Limit | zatrzymuje się po N wierszach |
Gather | zbiera 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.