...
Eroare System Design · Baza de date: conexiuni, lock-uri, interogări lente

Slow query: Seq Scan pe un tabel mare (index lipsă)

Pe scurt

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

Greșit
EXPLAIN ANALYZE SELECT * FROM comenzi WHERE client_id = 42;
-- Seq Scan on comenzi (actual time=0.03..812.4 rows=12)
Corect
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ă

Greșit
SELECT * FROM utilizatori WHERE LOWER(email) = 'ana@exemplu.ro';
-- indexul pe email nu e folosit
Corect
CREATE 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ă

Greșit
CREATE INDEX idx ON comenzi (status, client_id);
SELECT * FROM comenzi WHERE client_id = 42 ORDER BY creata_la DESC;
Corect
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ă tu

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.

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 ANALYZE pe interogările noi pe date de mărime realistă.
  • Creează indexuri pentru coloanele din WHERE, JOIN și ORDER BY ale interogărilor frecvente.
  • Folosește pg_stat_statements ca 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

← Toate erorile System Design

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.