Cum funcționează căutarea full-text în PostgreSQL?

Question

Accepted Answer

PostgreSQL are **căutare full-text încorporată** — căutarea în documente/text pentru cuvinte cu stemming, clasare și conștientizare lingvistică, mult mai puternică decât `LIKE`. Utilizează tipurile **`tsvector`** (document procesat) și **`tsquery`** (interogare de căutare), cu indecși GIN pentru viteză.

## Problema pe care LIKE nu o rezolvă

```text
LIKE '%word%' → no stemming (won't match "running" for "run"), no ranking, no language
  awareness, and can't use an index well (leading wildcard) → slow and limited.
Full-text search → stems words, ignores stop words, ranks by relevance, indexable.
```

## tsvector și tsquery

```sql
-- to_tsvector — process text into searchable lexemes (stemmed, stop-words removed)
SELECT to_tsvector('english', 'The cats are running fast');
-- → 'cat':2 'fast':5 'run':4  (stemmed: cats→cat, running→run; "the"/"are" removed)

-- to_tsquery / plainto_tsquery — parse a search query
SELECT to_tsvector('english', body) @@ to_tsquery('english', 'running')
FROM articles;   -- @@ = the match operator; matches "run" stem
```

`to_tsvector` convertește textul în **lexeme** normalizate (stemizează cuvintele, elimină cuvinte goale), iar `to_tsquery` analizează termenii de căutare. Operatorul `@@` testează o potrivire — deci "running" se potrivește cu documente conținând "run", "runs", etc.

## O coloană care poate fi căutată + indice GIN (configurația practică)

```sql
-- add a generated tsvector column and index it with GIN
ALTER TABLE articles ADD COLUMN search_vector tsvector
  GENERATED ALWAYS AS (to_tsvector('english', title || ' ' || body)) STORED;
CREATE INDEX idx_search ON articles USING GIN (search_vector);

-- fast searches using the index
SELECT title FROM articles
WHERE search_vector @@ plainto_tsquery('english', 'machine learning');
```

## Clasarea rezultatelor după relevanță

```sql
SELECT title, ts_rank(search_vector, query) AS rank
FROM articles, plainto_tsquery('english', 'database') query
WHERE search_vector @@ query
ORDER BY rank DESC;          -- most relevant first
```

`ts_rank` evaluează cât de bine se potrivește fiecare document, permițând rezultate ordonate după relevanță.

## De ce conteaza

Căutarea full-text încorporată în PostgreSQL este o funcționalitate valoroasă care vă permite să implementați **funcționalitate de căutare în baza de date** — fără a avea nevoie de un motor de căutare separat (cum ar fi Elasticsearch) pentru multe cazuri de utilizare — deci înțelegerea ei este utilă pentru aplicațiile care au nevoie de căutare în text.

Valoarea cheie este că este mult mai puternică decât `LIKE` (care nu poate stemiza cuvinte, clasifica rezultate sau fi indexată eficient): căutarea full-text oferă **stemming de cuvinte** (potrivirea "running" pentru "run"), **eliminarea cuvintelor goale**, **conștientizare lingvistică**, **clasare după relevanță** și în mod crucial este **indexabilă** (cu indecși GIN pentru căutări rapide) — oferind capacități de căutare reale (tipul pe care îl așteaptă utilizatorii: potrivirea variațiilor de cuvinte, clasarea după relevanță) direct în Postgres.

Înțelegerea conceptelor de bază — **`tsvector`** (text document procesat, stemizat), **`tsquery`** (termeni de căutare analizați), operatorul **`@@`** de potrivire și **`ts_rank`** pentru clasarea relevanței — plus configurația practică (o coloană `tsvector` generată indexată cu GIN pentru performanță) acoperă modul de implementare a unei căutări eficace.

Deși motoarele de căutare dedicate oferă mai mult pentru nevoile complexe, căutarea full-text în Postgres este suficientă și convenabilă pentru multe aplicații (evitând complexitatea operațională a unui sistem de căutare separat și menținând datele de căutare consecvente cu datele dvs. relaționale).

Deoarece căutarea în text este o cerință comună a aplicațiilor, și deoarece Postgres oferă căutare full-text capabilă încorporată (puternică, indexabilă, cu stemming și clasare) care adesea este suficientă fără un motor de căutare separat, înțelegerea ei — modelul tsvector/tsquery, configurația indexată și clasarea — este cunoaștere valoroasă, relevant practică care vă permite să adăugați funcționalitate reală de căutare folosind capabilitățile încorporate ale PostgreSQL, o funcționalitate utilă care este adesea neglijată în favoarea unor soluții externe mai complexe când Postgres ar fi suficient.