Monitorings

Kā lasīt PostgreSQL EXPLAIN ANALYZE bez minēšanas

EXPLAIN ANALYZE precīzi parāda, kur lēns vaicājums tērē laiku, bet tikai tad, ja zināt, kuriem skaitļiem ticēt. Lūk, kā lasīt izmaksas, faktiskās rindas, cilpas un buferus, atpazīt piecus modeļus, kas slēpjas aiz vairuma slikto plānu, un droši to izmantot produkcijas izmēra datos.

· 13 min lasīšanai · AG Data komanda

PostgreSQL EXPLAIN ANALYZE izpilda jūsu vaicājumu un parāda plānotāja izvēlēto plānu ar reāliem laikiem un rindu skaitu blakus katram novērtējumam. Tas ir pats noderīgākais rīks lēnam vaicājumam un arī visbiežāk pārprastais: cilvēki skatās uz izmaksu skaitļiem, kas ir minējumi, un izlaiž rindas, kas patiešām izskaidro problēmu.

Šī rokasgrāmata ir par to, kā izvadi izlasīt ātri: kuri skaitļi ir svarīgi, daži modeļi, kas slēpjas aiz vairuma slikto plānu, un kam pievērst uzmanību, ja tabulā ir miljards rindu, nevis tūkstotis. Ja vēl jāatrod, kuru vaicājumu skatīt, sāciet ar mūsu pg_stat_statements rokasgrāmatu.

Palaidiet to pareizi

Vienkāršs EXPLAIN vaicājumu tikai plāno. EXPLAIN ANALYZE to izpilda. Rokasgrāmata skaidri saka, ka blakusefekti notiek kā parasti, un tās ieteikums INSERT, UPDATE, DELETE, MERGE un līdzīgiem vaicājumiem ir ietīt tos transakcijā un atcelt (EXPLAIN):

-- Read-only query: run it for real
EXPLAIN (ANALYZE, BUFFERS) SELECT ...;

-- Anything that writes: run it inside a transaction and throw it away
BEGIN;
EXPLAIN (ANALYZE, BUFFERS) UPDATE orders SET status = 'archived' WHERE created_at < '2025-01-01';
ROLLBACK;

Vienmēr prasiet buferus. Kopš PostgreSQL 18 BUFFERS tiek iekļauts automātiski kopā ar ANALYZE (PostgreSQL 18 laidiena piezīmes); vecākās versijās pievienojiet to paši. Citas opcijas, ko vērts zināt:

Izlasiet vienu mezglu

Index Scan using orders_customer_id_idx on orders
    (cost=0.43..8.45 rows=1 width=64)
    (actual time=0.031..0.120 rows=12.00 loops=2500)
  Index Cond: (customer_id = c.id)
  Buffers: shared hit=9800 read=240

PostgreSQL 18 faktiskās rindas rāda ar decimāldaļām (rows=12.00), jo tie ir vidējie pa cilpām; vecākas versijas tos noapaļo, kas paslēpj atšķirību starp 0,4 un 0 rindām cilpā.

Pieci modeļi aiz vairuma slikto plānu

  1. Novērtējumi kļūdās 10 reizes vai vairāk. Katrā mezglā, sākot no apakšas, salīdziniet novērtēto rows ar faktisko rows × loops. Pirmais mezgls, kur tie stipri atšķiras, parasti ir cēlonis; viss virs tā plānots uz nepareiziem skaitļiem. Tipiski risinājumi: palaist ANALYZE, palielināt statistikas mērķi šai kolonnai vai pievienot paplašināto statistiku korelētām kolonnām.
  2. Nested loop ar milzīgu cilpu skaitu. Plānotājs gaidīja 10 ārējās rindas un saņēma 200 000, tāpēc iekšējais indeksa skenējums izpildījās 200 000 reižu. Bieži tas ir 1. modelis citā izskatā.
  3. Daudz Rows Removed by Filter. Skenējums nolasa miljonu rindu, lai paturētu piecdesmit. Vai nu trūkst indeksa, vai esošais indekss neatbilst nosacījumam (nepareiza kolonnu secība, funkcija uz kolonnas, tipu neatbilstība).
  4. Darbs izlīst uz diska. Sort mezgls parāda, vai kārtots atmiņā vai uz diska, un Hash mezgls ar vairāk nekā vienu batch arī izmanto diska vietu (EXPLAIN lietošana):
    Sort Method: external merge  Disk: 812344kB
    ...
    Hash  (actual time=... rows=... loops=1)
      Buckets: 131072  Batches: 16  Memory Usage: 4097kB
    Parastais risinājums ir lielāks work_mem šim vaicājumam vai sesijai, nevis globāli, vai plāns, kam nav jākārto tik daudz.
  5. Index Only Scan ar daudz Heap Fetches. Mūsu pieredzē tas nozīmē, ka redzamības karte (visibility map) atpaliek, tāpēc "tikai indeksa" skenējums lielākajai daļai rindu tomēr apmeklē tabulu. Pārbaudiet, vai vacuum šai tabulai tiek līdzi.
"never executed" ir laba ziņa. Mūsu pieredzē mezgls ar atzīmi (never executed) nozīmē, ka PostgreSQL to izpildes laikā izlaida, piemēram, savienojuma iekšējo pusi, kad ārējā puse neatgrieza nevienu rindu. Tā nav kļūda, un tā izmaksas nav problēmas daļa.

Sagatavotie vaicājumi un vispārīgie plāni

Vaicājums, kas psql ir ātrs, bet no lietotnes lēns, bieži ir plānu kešatmiņas problēma. Sagatavotiem vaicājumiem PostgreSQL pirmās piecas izpildes veic ar pielāgotiem (custom) plāniem, tad salīdzina vispārīgo (generic) plānu ar to vidējām izmaksām un var pārslēgties uz vispārīgo (PREPARE). Vispārīgais plāns nevar izmantot faktisko parametra vērtību, tāpēc nevienmērīgi sadalītiem datiem tas var būt briesmīgs, piemēram, ja vienam klientam pieder 40% rindu. Salīdziniet EXPLAIN (GENERIC_PLAN) ar parastu EXPLAIN ar reālu vērtību un, ja vajag, iestatiet plan_cache_mode = force_custom_plan attiecīgajai lomai vai sesijai.

Lielās datubāzēs

EXPLAIN ANALYZE uz 50 rindu izstrādes tabulas pasaka ļoti maz. Rokasgrāmata to saka tieši: rezultātus uz rotaļu izmēra tabulas nevar attiecināt uz lielām tabulām, jo plānotāja izmaksu novērtējumi nav lineāri un tas var izvēlēties citu plānu. Lielās produkcijas sistēmās:

Kad zināt, ko plāns stāsta, risinājumi ir ierastie: indeksi, statistika, vacuum, tad atmiņa. Mūsu lēno vaicājumu optimizācijas kontrolsaraksts tos iziet secīgi.

Galvenās atziņas

PostgreSQL EXPLAIN Vaicājumu optimizācija Veiktspēja
Sadarbība ar mums

Vaicājuma plāns, ko nevarat izskaidrot?

Atsūtiet mums plānu. EXPLAIN izvades lasīšana ir mūsu ikdiena, un mēs labojam lēnus PostgreSQL vaicājumus uz produkcijas izmēra datiem, nevis uz rotaļu kopijām.

Sazināties Vairāk no emuāra