PostgreSQL FTS

# PostgreSQL 17 พร้อม kham_pg ติดตั้งไว้แล้ว (latest = PG 17)
docker run --rm -e POSTGRES_PASSWORD=secret \
  -p 5432:5432 nickmsft/kham-pg:latest

# ระบุ PostgreSQL version — tags ที่มี:
#   v0.8.2-pg14  v0.8.2-pg16  v0.8.2-pg17  v0.8.2-pg18
docker run --rm -e POSTGRES_PASSWORD=secret \
  -p 5432:5432 nickmsft/kham-pg:v0.8.2-pg17

# เชื่อมต่อและใช้งานได้เลย
psql -h localhost -U postgres -c "
  CREATE EXTENSION kham_pg;
  SELECT to_tsvector('kham', 'กินข้าวกับปลา');
"

pg_config --version   # PostgreSQL 14 หรือใหม่กว่า

cargo build -p kham-pg --release
make -C kham-pg install

-- โหลด extension
CREATE EXTENSION kham_pg;

-- ค้นหาข้อความแบบ full-text ด้วย configuration kham ในตัว
SELECT to_tsvector('kham', 'กินข้าวกับปลา') @@ plainto_tsquery('kham', 'ปลา');
-- t  (กับ เป็น stopword จึงถูกกรองออก; ปลา ถูก index ไว้)

CREATE TABLE articles (
  id    SERIAL PRIMARY KEY,
  title TEXT,
  body  TEXT,
  tsv   TSVECTOR
);

UPDATE articles
SET tsv = to_tsvector('kham', coalesce(title, '') || ' ' || coalesce(body, ''));

CREATE INDEX articles_tsv_idx ON articles USING GIN(tsv);

CREATE TRIGGER articles_tsv_update
  BEFORE INSERT OR UPDATE ON articles
  FOR EACH ROW EXECUTE FUNCTION
    tsvector_update_trigger(tsv, 'public.kham', title, body);

SELECT id,
  ts_headline('kham', body, query,
    'StartSel=<mark>, StopSel=</mark>') AS snippet
FROM articles,
     to_tsquery('kham', 'ข้าว & ปลา') AS query
WHERE tsv @@ query
ORDER BY ts_rank(tsv, query) DESC;

-- query ภาษาอังกฤษ (RTGS) ค้นหาเอกสารภาษาไทย
SELECT to_tsvector('kham', 'กินข้าวกับปลา') @@ plainto_tsquery('kham', 'pla');
-- t  (ปลา → 'pla' ถูก index ไว้ในตำแหน่งเดียวกัน)

-- ค้นหาด้วยรหัส lk82 ของ ปลา (4800)
SELECT title FROM articles WHERE tsv @@ to_tsquery('kham', '4800');

-- ค้นหา ๑๒๓ ด้วยตัวเลข ASCII
SELECT to_tsvector('kham', '๑๒๓') @@ plainto_tsquery('kham', '123') AS found;
-- t

-- หาเอกสารที่มีคำกริยา
SELECT title FROM articles WHERE tsv @@ 'pos_verb'::tsquery;

-- ดู POS tags ที่ถูก index สำหรับคำนั้น
SELECT lexeme FROM unnest(to_tsvector('kham', 'ปลา'))
WHERE lexeme LIKE 'pos_%';
-- pos_noun

-- udom83 soundex
CREATE TEXT SEARCH CONFIGURATION kham_udom83 (PARSER = kham);
ALTER TEXT SEARCH CONFIGURATION kham_udom83
    ADD MAPPING FOR thai, named WITH kham_fts_dict_udom83;
ALTER TEXT SEARCH CONFIGURATION kham_udom83
    ADD MAPPING FOR latin, number, unknown WITH kham_dict;

-- MetaSound
CREATE TEXT SEARCH CONFIGURATION kham_metasound (PARSER = kham);
ALTER TEXT SEARCH CONFIGURATION kham_metasound
    ADD MAPPING FOR thai, named WITH kham_fts_dict_metasound;
ALTER TEXT SEARCH CONFIGURATION kham_metasound
    ADD MAPPING FOR latin, number, unknown WITH kham_dict;

-- จัดอันดับพื้นฐาน
SELECT id, ts_rank(tsv, query) AS rank
FROM articles, to_tsquery('kham', 'ข้าว') query
WHERE tsv @@ query
ORDER BY rank DESC;

-- Field boosting: token น้ำหนัก A มีค่า ~5× เทียบกับน้ำหนัก C
UPDATE articles
SET tsv =
  setweight(to_tsvector('kham', coalesce(title, '')), 'A') ||
  setweight(to_tsvector('kham', coalesce(body,  '')), 'C');