Windows 安装 PostgreSQL 并安装 vector 扩展

PostgreSQL 数据库与 Vector 扩展完整安装指南（Windows 系统）

一、PostgreSQL 安装流程

1. 获取安装包
   访问 PostgreSQL 官网下载页面，选择与系统匹配的最新版本安装程序

2. 执行安装程序

   • 双击运行安装向导
   • 选择默认安装路径 C:\Program Files\PostgreSQL\<版本号>
   • 设置超级用户密码（需包含大小写字母和数字）
   • 确认端口号为 5432（默认值，建议保持）

3. 验证服务状态
   打开 PowerShell 执行：

   Get-Service postgresql* | Select-Object Name, Status
   

   正常状态应显示 Running

二、环境配置优化

1. 添加系统路径
   将 PostgreSQL 工具路径加入环境变量：

   C:\Program Files\PostgreSQL\<版本号>\bin
   

   操作步骤：系统属性 → 高级 → 环境变量 → Path 编辑

2. 字符编码设置
   在 IDE 或应用配置中添加（如需处理中文）：

   -Dfile.encoding=UTF-8
   

三、Vector 扩展部署

1. 编译环境准备

   • 安装 Visual Studio Build Tools
   • 安装 PostgreSQL 开发包（安装时勾选 PGXS 组件）

2. **扩展安装步骤

   git clone --depth 1 https://github.com/pgvector/pgvector.git
   cd pgvector
   nmake /F Makefile.windows
   nmake /F Makefile.windows install
   

四、数据库配置

1. 创建专属数据库

   CREATE DATABASE vectordb 
     TEMPLATE template0 
     ENCODING 'UTF8' 
     LC_COLLATE 'C' 
     LC_CTYPE 'C';
   

2. 启用向量扩展

   \connect vectordb
   CREATE EXTENSION IF NOT EXISTS vector;
   

五、功能验证测试

1. 扩展状态检查

   SELECT * FROM pg_extension WHERE extname = 'vector';
   

2. 向量操作演示

   CREATE TABLE embeddings (
     id SERIAL PRIMARY KEY,
     feature VECTOR(768)
   );
   
   INSERT INTO embeddings (feature) 
   VALUES ('[0.12, 0.34, ..., 0.78]'),
          ('[0.56, 0.91, ..., 0.22]');
   
   SELECT id, feature <-> '[0.23, 0.45, ..., 0.67]' AS distance 
   FROM embeddings 
   ORDER BY distance LIMIT 5;
   

六、故障排查指南

问题现象	解决方案
扩展加载失败	检查 data/postgresql.conf 中 shared_preload_libraries = 'vector'
权限拒绝错误	使用 psql -U postgres -h 127.0.0.1 连接
向量运算异常	确认 vector.so 文件位于 lib/postgresql 目录

日志路径参考
C:\Program Files\PostgreSQL\<版本号>\data\log\postgresql-<日期>.log

注意事项

1. 建议使用 PostgreSQL 15 及以上版本
2. 进行向量运算时确保内存 ≥ 8GB
3. 开发环境建议关闭 ssl 减少性能损耗