Slow query: Seq Scan pe un tabel mare (index lipsă)
Interogarea citește tot tabelul rând cu rând (`Seq Scan` în PostgreSQL, `type: ALL` în MySQL) pentru că nu există un index pe coloana din `WHERE`. Pe tabele mari, fiecare citire durează și încarcă baza. Rulează `EXPLAIN ANALYZE`, creează indexul potrivit și verifică din nou planul.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Logul de interogări lente (log_min_duration_statement în PostgreSQL, slow_query_log în MySQL) îți arată interogările care trec de un prag. Când rulezi EXPLAIN ANALYZE pe una și vezi Seq Scan on comenzi cu Rows Removed by Filter: 4999990, baza a citit cinci milioane de rânduri ca să găsească zece.
Fără index, costul unei căutări crește liniar cu tabelul: la o mie de rânduri nu observi, la milioane fiecare cerere ține baza ocupată sute de milisecunde. La trafic mare, baza ajunge la 100% CPU sau I/O, iar celelalte interogări încep să aștepte, deci problema unei singure interogări încetinește tot sistemul.
Un index B-tree pe coloana (sau coloanele) din WHERE și ORDER BY transformă scanarea într-o căutare de câțiva pași. Indexurile au un cost la scriere și la stocare, deci se creează pentru interogările frecvente, nu pe fiecare coloană.
De ce apare: cauzele frecvente
1Căutare după o coloană fără index
EXPLAIN ANALYZE SELECT * FROM comenzi WHERE client_id = 42;
-- Seq Scan on comenzi (actual time=0.03..812.4 rows=12)CREATE INDEX CONCURRENTLY idx_comenzi_client ON comenzi (client_id);
-- Index Scan using idx_comenzi_client (actual time=0.02..0.09 rows=12)Indexul permite bazei să sară direct la rândurile clientului 42. CONCURRENTLY îl creează fără să blocheze scrierile.
2Funcție aplicată pe coloana indexată
SELECT * FROM utilizatori WHERE LOWER(email) = 'ana@exemplu.ro';
-- indexul pe email nu e folositCREATE INDEX idx_utilizatori_email_lower ON utilizatori (LOWER(email));Un index obișnuit pe email nu ajută la LOWER(email). Indexul pe expresie se potrivește exact cu condiția.
3Index compus în ordinea greșită
CREATE INDEX idx ON comenzi (status, client_id);
SELECT * FROM comenzi WHERE client_id = 42 ORDER BY creata_la DESC;CREATE INDEX idx ON comenzi (client_id, creata_la DESC);Un index compus ajută doar dacă interogarea folosește prima lui coloană. Ordinea coloanelor urmează filtrul și sortarea.
Repară eroarea, direct în pagină
Pagina „Comenzile mele” e lentă, iar logul de interogări lente arată Seq Scan on comenzi: baza nu are index pe coloana căutată și ajunge peste capacitate. Repară baza astfel încât toate cererile să fie tratate, citirile sub 150 ms și baza sub 70%.
Indiciu
Avertismentul bazei din tab-ul Simulare îți spune ce lipsește.
Reparația
1. Atinge Bază SQL primară. 2. Bifează Index pe coloanele căutate (echivalentul CREATE INDEX ... ON comenzi (client_id)).
Rezultat: baza la ~50%, citirile în jur de 100 ms.
De ce merge
Fără index, fiecare citire scanează tot tabelul (cost ×10), deci baza era mult peste capacitate. Cu indexul pe coloana căutată, citirea costă cât o căutare normală, baza coboară sub 70%, iar latența revine la normal.
Alte forme ale mesajului
Seq Scan on comenzi (cost=0.00..104000.00 rows=12)type: ALL (MySQL EXPLAIN, full table scan)duration: 812.402 ms statement: SELECT * FROM comenzi WHERE client_id = 42
Cum o eviți pe viitor
- Activează logul de interogări lente și revizuiește-l periodic.
- Rulează
EXPLAIN ANALYZEpe interogările noi pe date de mărime realistă. - Creează indexuri pentru coloanele din
WHERE,JOINșiORDER BYale interogărilor frecvente. - Folosește
pg_stat_statementsca să vezi ce interogări consumă cel mai mult timp total.
Întrebări frecvente
De ce merge repede în dezvoltare și încet în producție?
Pentru că în dezvoltare tabelul are câteva sute de rânduri, iar o scanare completă e instantă. Problema apare doar la volumul real, de aceea testezi planurile pe date mari.
Pot pune index pe fiecare coloană?
Nu e o idee bună: fiecare index încetinește scrierile și ocupă spațiu, iar planificatorul poate alege greșit. Indexează după interogările reale.
Erori înrudite
Căutarea cu LIKE '%text%' încarcă baza de date la 100% Un `LIKE '%cuvant%'` cu wildcard la început nu poate folosi un index B-tree, deci fiecare căutare scanează tot tabelul. La trafic mare de căutări, baza principală ajunge la 100%. Mută căutarea full-text într-un motor de căutare (Elasticsearch, OpenSearch) sau folosește un index full-text / trigram. Baza de date primară la 100% CPU din cauza citirilor Majoritatea interogărilor sunt citiri, iar baza primară, singura care le servește, a ajuns la limită. Mută citirile pe replici de citire (read replicas) și pune un cache în față pentru datele citite des; primara rămâne pentru scrieri. upstream timed out (110: Connection timed out) while reading response header from upstream Linia din logul de erori nginx care stă în spatele unui 504: nginx a trimis cererea la server și nu a primit nici măcar antetele răspunsului în `proxy_read_timeout`. Caută ce face serverul atât de mult: o operație lungă ținută sincron (un apel extern, un raport) se mută într-un job asincron. Învață System Design de la zero, cu exerciții la fiecare lecție
Curs System Design: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 10 lecții sunt gratuite.
