值 1 → 行1, 行5, 行10
值 3 → 行1, 行2, 行7
值 5 → 行1, 行3, 行8

GIN Index Structure:
┌─────────────┬──────────────────────┐
│    Key      │    Posting List      │
├─────────────┼──────────────────────┤
│   "apple"   │  (1,2), (5,3), ...   │
│   "banana"  │  (2,1), (7,4), ...   │
│     42      │  (3,2), (9,1), ...   │
└─────────────┴──────────────────────┘

-- 數(shù)組操作
SELECT * FROM products WHERE tags @> ARRAY['electronics'];  -- 包含
SELECT * FROM products WHERE tags && ARRAY['sale', 'discount']; -- 任一匹配
-- JSONB 操作
SELECT * FROM users WHERE profile @> '{"age": 25}';  -- 包含鍵值對
SELECT * FROM users WHERE profile ? 'email';         -- 包含鍵
SELECT * FROM users WHERE profile ?| ARRAY['phone', 'email']; -- 任一鍵存在
-- 全文檢索
SELECT * FROM articles WHERE content_tsvector @@ to_tsquery('english', 'database & performance');

-- 數(shù)組操作
SELECT * FROM products WHERE tags @> ARRAY['electronics'];  -- 包含
SELECT * FROM products WHERE tags && ARRAY['sale', 'discount']; -- 任一匹配
-- JSONB 操作
SELECT * FROM users WHERE profile @> '{"age": 25}';  -- 包含鍵值對
SELECT * FROM users WHERE profile ? 'email';         -- 包含鍵
SELECT * FROM users WHERE profile ?| ARRAY['phone', 'email']; -- 任一鍵存在
-- 全文檢索
SELECT * FROM articles WHERE content_tsvector @@ to_tsquery('english', 'database & performance');

Insert Process with fastupdate=on:
┌─────────────┐    ┌──────────────────┐    ┌─────────────┐
│   New Data  │───?│  Pending List    │───?│  Main Index │
└─────────────┘    └──────────────────┘    └─────────────┘
                          ▲
                          │
                   gin_clean_pending_list()

-- 查詢: SELECT * FROM table WHERE col @> ARRAY[1,2];
-- GIN 查詢步驟：
-- 1. 查找值 1 的 posting list: [row1, row3, row5]
-- 2. 查找值 2 的 posting list: [row1, row2, row5]
-- 3. 取交集: [row1, row5]
-- 4. 返回結(jié)果

-- 表結(jié)構(gòu)
CREATE TABLE products (
    id SERIAL PRIMARY KEY,
    name TEXT,
    tags TEXT[],  -- 標(biāo)簽數(shù)組
    price NUMERIC
);
-- 插入測試數(shù)據(jù)
INSERT INTO products (name, tags, price) VALUES
('iPhone 15', ARRAY['electronics', 'phone', 'apple'], 999),
('MacBook Pro', ARRAY['electronics', 'laptop', 'apple'], 2499),
('Nike Air Max', ARRAY['clothing', 'shoes', 'sport'], 120);
-- 創(chuàng)建 GIN 索引
CREATE INDEX idx_products_tags ON products USING GIN (tags);
-- 查詢包含特定標(biāo)簽的商品
EXPLAIN ANALYZE 
SELECT * FROM products WHERE tags @> ARRAY['electronics'];
-- Index Scan using idx_products_tags on products
-- 查詢包含任一標(biāo)簽的商品
EXPLAIN ANALYZE 
SELECT * FROM products WHERE tags && ARRAY['phone', 'laptop'];
-- Bitmap Heap Scan with Bitmap Index Scan

-- 表結(jié)構(gòu)
CREATE TABLE users (
    id SERIAL PRIMARY KEY,
    name TEXT,
    profile JSONB  -- 用戶配置
);
-- 插入數(shù)據(jù)
INSERT INTO users (name, profile) VALUES
('Alice', '{"age": 25, "city": "Beijing", "skills": ["Java", "Python"]}'),
('Bob', '{"age": 30, "city": "Shanghai", "skills": ["JavaScript", "React"]}');
-- 創(chuàng)建 GIN 索引
CREATE INDEX idx_users_profile ON users USING GIN (profile);
-- 查詢年齡為25的用戶
EXPLAIN ANALYZE 
SELECT * FROM users WHERE profile @> '{"age": 25}';
-- 查詢具有特定技能的用戶
EXPLAIN ANALYZE 
SELECT * FROM users WHERE profile->'skills' ? 'Java';
-- 創(chuàng)建特定路徑的 GIN 索引（更高效）
CREATE INDEX idx_users_skills ON users USING GIN ((profile->'skills'));

-- 1. 針對特定 JSON 路徑創(chuàng)建索引（比全 JSONB 索引更高效）
CREATE INDEX idx_users_email ON users USING GIN ((profile->>'email'));  -- 錯誤！
CREATE INDEX idx_users_email ON users USING GIN ((profile->'email'));   -- 正確
-- 2. 使用表達式索引
CREATE INDEX idx_users_age ON users USING GIN ((profile->'age'));
-- 3. 復(fù)合條件考慮部分索引
CREATE INDEX idx_active_users ON users USING GIN (profile) 
WHERE status = 'active';

-- 查看當(dāng)前 GIN 參數(shù)
SHOW gin_fuzzy_search_limit;
SHOW gin_pending_list_limit;
-- 會話級調(diào)整（臨時）
SET gin_pending_list_limit = '16MB';
SET gin_fuzzy_search_limit = 10000;
-- 系統(tǒng)級調(diào)整（postgresql.conf）
# gin_pending_list_limit = 16MB
# gin_fuzzy_search_limit = 10000

-- 手動清理待處理列表（當(dāng) fastupdate=on 時）
SELECT gin_clean_pending_list('idx_products_tags');
-- 監(jiān)控 GIN 索引狀態(tài)
SELECT * FROM pg_stat_user_indexes 
WHERE indexname = 'idx_products_tags';
-- 定期 REINDEX（特別是在大量更新后）
REINDEX INDEX idx_products_tags;

-- 對于寫入密集型應(yīng)用，考慮關(guān)閉 fastupdate
CREATE INDEX idx_write_heavy ON table USING GIN (col) WITH (fastupdate = off);
-- 對于讀取密集型應(yīng)用，保持 fastupdate=on（默認）
-- 但監(jiān)控 pending list 大小，避免查詢性能下降

-- 確保使用正確的操作符
-- ? 正確：profile ? 'email'
-- ? 錯誤：profile->>'email' IS NOT NULL
-- 檢查索引是否創(chuàng)建正確
\d+ users  -- 查看索引信息
-- 強制使用索引（調(diào)試用）
SET enable_seqscan = off;

-- 方案1：批量操作后手動清理
BEGIN;
INSERT INTO table ...;  -- 批量插入
SELECT gin_clean_pending_list('index_name');
COMMIT;
-- 方案2：臨時關(guān)閉 fastupdate
DROP INDEX idx_name;
CREATE INDEX idx_name ON table USING GIN (col) WITH (fastupdate = off);

-- 方案1：只索引必要字段
-- 而不是 CREATE INDEX ON table USING GIN (jsonb_col);
-- 使用 CREATE INDEX ON table USING GIN ((jsonb_col->'needed_field'));
-- 方案2：定期 REINDEX
REINDEX INDEX CONCURRENTLY idx_name;
-- 方案3：考慮分區(qū)表