Conas a úsáideann tú EXPLAIN agus EXPLAIN ANALYZE?

Question

Accepted Answer

Taispeánann **`EXPLAIN`** **plean forghníomhaithe an fhéachaint** PostgreSQL — conas a rith sé fiosrúchán (cén sceanóir, ceanglachain, innéacsanna). Rithíonn **`EXPLAIN ANALYZE`** an fiosrúchán go dáiríre agus taispeánann sé am fíor agus líon na sraitheanna. Is iad seo na príomhuirlisí chun fiosrúcháin dhéanach a dhiagnóisiú.

## EXPLAIN — an plean (gan a rith)

```sql
EXPLAIN SELECT * FROM orders WHERE customer_id = 5;
-- shows the PLAN: scan type, estimated cost, estimated rows — but doesn't run it
```

## EXPLAIN ANALYZE — an plean le sonraí gníomhaithe FÍOR

```sql
EXPLAIN ANALYZE SELECT * FROM orders WHERE customer_id = 5;
-- ACTUALLY runs it → shows REAL time, ACTUAL rows, and where time was spent
EXPLAIN (ANALYZE, BUFFERS) SELECT ...;   -- also shows buffer/cache usage
```

Tá `EXPLAIN ANALYZE` níos úsáiúla toisc go dtaispeánann sé *feidhmíochta iarbhír* (am fíor, líon sraitheanna fíor) — ag nochtadh an áit ina gcaitheann an fiosrúchán am go dáiríre, ní hamháin meastacháin.

## Ag léamh an phlean: na príomhrudaí atá le fáil amach

```text
SCAN TYPES (most important):
  Seq Scan      → FULL TABLE SCAN (reads every row) — slow on big tables, often the problem
  Index Scan    → uses an index to find rows — fast
  Index Only Scan → reads only the index (doesn't touch the table) — fastest
  Bitmap Scan   → for combining indexes / many matches

WATCH FOR:
  ✗ Seq Scan on a large table being filtered → likely a MISSING INDEX
  ✗ Estimated rows VERY different from actual rows → outdated statistics (run ANALYZE)
  ✗ Expensive joins, sorts spilling to disk ("external merge")
  ✗ The node with the highest actual time = the bottleneck
```

## Sampla diagnóiseach

```sql
EXPLAIN ANALYZE SELECT * FROM orders WHERE customer_id = 5;
-- "Seq Scan on orders ... actual time=120ms" → a full scan, slow

CREATE INDEX idx_orders_customer ON orders(customer_id);

EXPLAIN ANALYZE SELECT * FROM orders WHERE customer_id = 5;
-- "Index Scan using idx_orders_customer ... actual time=0.05ms" → fixed!
```

## Cén fáth a bhíonn tábhacht ann

Is uirlisí riachtanach, príomhúla iad `EXPLAIN` agus `EXPLAIN ANALYZE` do **dhiagnóisiú agus dóbriarthu fiosrúchán mall** i PostgreSQL — tá feidhmíochta an fhiosrúcháin fíorabharach do fheidhmchláir, agus is ar an bhealach seo a thuigeann tú *cén fáth* go bhfuil fiosrúchán mall agus go ndéanann tú dreasanna a fhíorú, mar sin tá an fhiúntas acu ina eolas an-thábhachtach do dhul chun cinn ar dhul i ngleic le feidhmíochta an bhunachair sonraí.

Is é an luach bunúsach **infheictheacht an phlean forghníomhaithe**: in ionad a bheith ag gealadh cén fáth go bhfuil fiosrúchán mall, nochtann `EXPLAIN ANALYZE` (a rithíonn an fiosrúchán agus a thaispeánann am fíor agus líon sraitheanna fíor) go díreach conas a rithíonn Postgres é agus an áit ina gcaitheann tú am.

Is iad na rudaí is tábhachtaí a thuiscint ná na **cineálacha scannadh** — go háirithe a aithint ar **`Seq Scan` (scan tábla iomlán)** ar thábla scagtha mór, rud a léiríonn de ghnáth **innéacs ar iarraidh** (an fhadhb feidhmíochta fiosrúcháin is coitianta agus is thionchar), i gcoibhneas le **`Index Scan`** gasta.

Is é tuiscint ar an bplean a léamh (cineálacha scannadh, comparáid idir sraitheanna measta agus iarbhír chun staidéar caite a fhairsing, an nód is geal a aithint mar an bottleneck, súil a choinneáil ar dhréachta a bhaineann le diosca) an scil ábhartha do bharrfheidhmhiú an fhiosrúcháin.

Is é an fhoclóir diagnóiseach — `EXPLAIN ANALYZE` a rith, an bottleneck a aithint (go minic `Seq Scan`), an leigheas a chur i bhfeidhm (de ghnáth innéacs a chur leis), agus athshúil a dhéanamh chun a fhíorú — an cur chuige caighdeánach, tomhas-dhríofa, do bharrfheidhmhiú an fhiosrúcháin.

Ó is gur geal fiosrúcháin a bheith ina bhríomh ar dhrochmh-feidhmíochta an bhunachair sonraí, agus ó is iad `EXPLAIN`/`EXPLAIN ANALYZE` na *uirlisí* chun iad a dhiagnóisiú (a nochtann innéacsanna ar iarraidh, pleananna dona, agus bottlenecks) agus dreasanna a fhíorú, is eolas tábhachtach, ard-luachúil é an tuiscint orthu do fheidhmíochta PostgreSQL — is ar an bhealach seo a fhéadann tú fiosrúcháin mhall a dhéanamh amach agus a dhúshlánú go córasach seachas a bheith ag gealadh, scil chriticiúil do bhunachair agus topaic choitianta do dhul i ngleic le barr-fheidhmhiú an fhiosrúcháin.