跳到主内容
智客 ZICQ

智客百科 基础设施

pgvector(PostgreSQL 向量扩展)

基础设施
别名: pgvector PostgreSQL 向量检索 pgvector extension ·2026-10-10

pgvector(PostgreSQL 向量扩展)

pgvector 是 PostgreSQL 官方生态中最具影响力的开源向量检索扩展。它通过为 Postgres 引入原生的 vector、halfvec 及 sparsevec 数据类型,配合 HNSW 和 IVFFlat 索引以及专用距离计算操作符,使企业能够直接在既有的关系型数据库内以极低运维成本运行高并发、高准确率的向量近似最近邻(ANN)检索。


1. 为什么选择 pgvector:工程优势与架构定位

在构建 AI 应用(如 RAG 与语义搜索)时,团队面临“独立专用向量库(如 Milvus、Qdrant)”与“关系型数据库扩展(pgvector)”的架构选型抉择:

选型维度 专用向量数据库(Milvus / Qdrant) PostgreSQL + pgvector
运维复杂度 高(需维护独立分布式集群、配置持久化与监控) 极低(复用现有的 RDS、Supabase 或自建 PG)
事务一致性(ACID) 弱(向量数据与元数据双写易产生不一致) 严格 ACID(向量与业务数据在同一事务内更新/回滚)
复合过滤与关联 仅支持简单元数据过滤,无法做深层 SQL JOIN 强大(在单条 SQL 中无缝 JOIN 订单表、用户表与权限 ACL)
数据规模上限 亿级至十亿级超大规模 百万至数千万级(配合量化与 HNSW 性能极佳)

2. 核心索引架构:HNSW 与 IVFFlat

pgvector 支持两种主流 ANN 索引算法,各自适用于完全不同的业务场景:

2.1 HNSW(分层可导航小世界图)

业界性能与召回率(Recall)表现最佳的图索引:

  • 原理:构建多层自上而下的跳转图,搜索时从稀疏顶层快速跳跃到密集底层,时间复杂度为 O(logN)。
  • 参数调优:
    • m(节点最大双向连接数,默认 16,建议 16-32):控制图稠密度。
    • ef_construction(建索引时的探索深度,默认 64,建议 64-128):值越大索引构建越慢,但最终召回率越高。
    • hnsw.ef_search(查询时动态候选集大小,默认 40):查询时动态调节精度(如 SET hnsw.ef_search = 100; 提高召回率)。
  • 优缺点:召回率极高(>95%-99%),查询延迟极低(单并发数毫秒);但索引占用内存大、建索引耗时较长。

2.2 IVFFlat(倒排文件扁平索引)

基于 k-means 聚类的倒排索引:

  • 原理:将高维空间划分为 K 个 Voronoi 空间单元(Lists),查询时仅扫描离 Query 最近的几个单元(Probes)。
  • 参数调优:lists = sqrt(行数),查询时通过 SET ivfflat.probes = 10; 调节扫描范围。
  • 优缺点:建索引极快,内存开销极小;但需要先填充足够训练数据才能建索引,高维场景下召回率对分布敏感。

3. 距离度量操作符与 SQL 实战

pgvector 为不同数学距离度量提供了专用的 C 语言加速操作符:

-- 启用扩展
CREATE EXTENSION IF NOT EXISTS vector;

-- 创建表结构(以 1536 维 OpenAI Embedding 为例)
CREATE TABLE knowledge_base (
    id BIGSERIAL PRIMARY KEY,
    tenant_id INT NOT NULL,
    title TEXT NOT NULL,
    content TEXT NOT NULL,
    embedding vector(1536)
);

-- 建立 HNSW 索引(使用余弦距离)
CREATE INDEX ON knowledge_base 
USING hnsw (embedding vector_cosine_ops)
WITH (m = 16, ef_construction = 64);

距离度量操作符速查:

  1. 余弦距离(Cosine Distance):<=>(vector_cosine_ops)
    Dcos(u,v)=1−u·v‖u‖‖v‖
    自然语言文本语义匹配的首选。
  2. 欧氏距离(L2 Distance):<->(vector_l2_ops)
    DL2(u,v)=√∑(ui−vi)2
  3. 负内积(Inner Product):<#>(vector_ip_ops) 返回 −(u·v)(因为 Postgres 默认升序 ASC 排序,负号使得内积最大的向量排在最前面)。若向量已归一化,内积等价于余弦相似度,计算速度最快。

4. 显存与存储压缩优化:halfvec 与二进制量化

在高并发企业场景下,未压缩的高维向量会吞噬大量服务器内存。pgvector 提供了深度的量化与压缩能力:

  1. 半精度向量(halfvec): 将 32 位浮点数压缩为 16 位 IEEE 754 半精度浮点数(2 字节/维度)。
    ALTER TABLE knowledge_base ADD COLUMN embedding_half halfvec(1536);
    
    • 显存与磁盘占用直接减半(从 6KB/条降至 3KB/条)。
    • 工业级评测表明,召回率损失通常小于 0.1%,性价比极高。
  2. 二进制标量量化(Binary Quantization, bit): 将向量每一维度的正负号压缩为 1 个比特位,直接利用 CPU 的 POPCNT 指令计算汉明距离(Hamming Distance <~>)。
    • 内存压缩高达 32 倍!
    • 常用模式:第一步用二进制索引从百万库中极速召回 Top 100 候选,第二步在内存中用原始向量重新精排取 Top 10。

5. 混合检索(Hybrid Search)与过滤优化

5.1 解决“先过滤还是先搜向量”的经典陷阱

当执行 WHERE tenant_id = 101 ORDER BY embedding <=> $1 LIMIT 5 时,如果租户 101 的数据量占比较小,传统的 HNSW 索引扫描可能会提前耗尽探索预算而返回空结果。

  • 迭代图扫描(Iterative Scan):pgvector 0.7+ 引入了迭代图遍历机制,在图搜索时持续向外探索,直到收集够满足 WHERE 过滤条件的记录数,彻底解决了多租户过滤漏检难题。

5.2 单条 SQL 实现 RRF 混合重排

结合 Postgres 原生的全文检索(FTS)与 pgvector 语义检索,利用倒数排名融合(RRF)实现极致检索:

WITH semantic_search AS (
    SELECT id, RANK() OVER (ORDER BY embedding <=> $1) AS rank_sem
    FROM knowledge_base
    WHERE tenant_id = $2
    ORDER BY embedding <=> $1
    LIMIT 50
),
text_search AS (
    SELECT id, RANK() OVER (ORDER BY ts_rank_cd(to_tsvector('chinese', content), plainto_tsquery('chinese', $3)) DESC) AS rank_text
    FROM knowledge_base
    WHERE tenant_id = $2 AND to_tsvector('chinese', content) @@ plainto_tsquery('chinese', $3)
    LIMIT 50
)
SELECT COALESCE(s.id, t.id) AS id,
       COALESCE(1.0 / (60 + s.rank_sem), 0.0) +
       COALESCE(1.0 / (60 + t.rank_text), 0.0) AS rrf_score
FROM semantic_search s
FULL OUTER JOIN text_search t ON s.id = t.id
ORDER BY rrf_score DESC
LIMIT 10;

6. 生产环境容量估算与性能调优

  1. HNSW 内存驻留黄金准则: HNSW 索引必须能全部装入内存(shared_buffers 或系统磁盘缓存),否则频繁的磁盘随机 I/O 会导致查询延迟从 5ms 飙升至数百毫秒。
    • 内存估算公式:Index Size≈(d×4+m×8)×N 字节。
    • 例如 100 万条 1536 维向量(m=16):(1536×4+16×8)×1,000,000≈6.27GB 纯索引内存。
  2. 索引构建配置: 建索引前临时调大维护内存:SET maintenance_work_mem = '8GB'; 并将 max_parallel_maintenance_workers 设为物理 CPU 核心数,可使建索引耗时缩短数倍。

进一步阅读