PostgreSQL 向量扩展插件pgvector安装

重要提示 :本指南基于 PostgreSQL 16.1 和 OpenCloudOS 系统环境,已解决 pg_config 路径问题

📌 前置条件

以下路径都需要替换为自己的包所在路径、以下以我的为例!

  1. 已安装 PostgreSQL 16.1 (路径:/www/server/pgsql)
  2. 确认 pg_config 存在于 /www/server/pgsql/bin/pg_config
  3. 已安装 PostgreSQL 开发包(postgresql16-devel)

✅ 安装步骤(详细流程)

步骤 1:确认 PostgreSQL 安装路径

bash 复制代码
[root@VM-4-5-opencloudos ~]# ls -l /www/server/pgsql/bin/pg_config

# 输出的位置
-rwxr-xr-x 1 postgres postgres 42352 Dec 29 19:28 /www/server/pgsql/bin/pg_config

步骤 2:修复环境变量配置(关键!)

错误原因 :PATH 未正确包含 PostgreSQL bin 目录

如果没有环境变量的会有以下错误

bash 复制代码
[root@VM-4-5-opencloudos pgvector]# make
make: pg_config: No such file or directory
make: Nothing to be done for 'all'.
修正 .bash_profile
bash 复制代码
# 打开配置文件
vi ~/.bash_profile

替换为以下正确配置 (删除所有多余空格)

bash 复制代码
export PG_HOME=/www/server/pgsql
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/www/server/pgsql/lib  # 修正:移除空格
export PGDATA=/www/server/pgsql/data
PATH=$PATH:$HOME/.local/bin:$HOME/bin:$PG_HOME/bin
export PATH
alias psql='/www/server/pgsql/bin/psql'
重新加载配置
bash 复制代码
source ~/.bash_profile
验证 PATH 配置
bash 复制代码
echo $PATH | grep /www/server/pgsql/bin
检查 pg_config 是否可找到
bash 复制代码
which pg_config

步骤 3:下载 pgvector 源码

bash 复制代码
cd /tmp
git clone --branch v0.8.1 https://github.com/pgvector/pgvector.git

步骤 4:编译安装 pgvector

bash 复制代码
# 编译安装(自动使用正确的 pg_config)
make
make install

步骤 5:验证安装

bash 复制代码
# 连接数据库
psql -U postgres

⚠️ 常见问题解决

问题现象 解决方案
make: pg_config: No such file or directory 1. 修正 .bash_profile(移除空格) 2. source ~/.bash_profile 3. 验证 which pg_config
pgvector 安装后无法加载 1. 确保 PostgreSQL 服务重启 2. 检查 pg_hba.conf 是否允许本地连接
版本不匹配错误 1. 确认 PostgreSQL 和 pgvector 版本兼容 2. 使用与 PostgreSQL 版本匹配的 pgvector 版本(如 PostgreSQL 16 → pgvector 0.8.1+)

🔧 配置文件参考(重要)

1. .bash_profile 修正后内容

bash 复制代码
# PostgreSQL 环境配置
export PG_HOME=/www/server/pgsql
export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/www/server/pgsql/lib
export PGDATA=/www/server/pgsql/data
PATH=$PATH:$HOME/.local/bin:$HOME/bin:$PG_HOME/bin
export PATH
alias psql='/www/server/pgsql/bin/psql'

重要提醒 :安装后必须重启 PostgreSQL 服务,否则无法加载新扩展!

本指南已通过 OpenCloudOS 环境验证,可确保 pgvector 在 PostgreSQL 16.1 上成功安装。如遇问题,请优先检查 which pg_config 是否返回正确路径。

相关推荐
草莓熊Lotso4 小时前
【C++ 基于微服务的即时通讯系统】用户服务之Redis数据层落地:会话、登录状态与验证码全封装
数据库·c++·redis·微服务·语音识别
Flynn Liang5 小时前
AI Agent 分层记忆体系实战:用 Redis 五类结构构建可淘汰、可追溯的长短期记忆
数据库·人工智能·redis
Henry-SAP14 小时前
PP的生产调度员(Production Scheduler)的角色与配置
数据库
Flynn Liang17 小时前
HikariCP 连接池不是越大越好:I/O 密集型 Java 服务的数据库容量工程
java·数据库·mysql·高并发·连接池·hikaricp·sql 优化
小乖写代码18 小时前
消息、回执与媒体 · msgstore.db · Messages, Receipts, and Media
数据库·媒体·whatsapp·消息回执
GeW19 小时前
世界目光聚焦中国:底层技术、Linux、数据库的破局逻辑
linux·数据库
PingCAP20 小时前
平凯数据库 × 圣诺云数:让治理数据实时可用、跨域可信流通
数据库·tidb
利威尔xu20 小时前
PostgreSQL 索引失效 4 类:函数运算让查询全表扫描拖垮性能
开发语言·数据库·postgresql·性能优化·索引优化
PingCAP20 小时前
挚文集团(陌陌、探探)从 MySQL 分库分表到 TiDB 实时统一架构的实践
数据库·tidb
Decay__20 小时前
SQLServer 运维自动化平台 —— PowerShell + SQL Agent 作业:部署、监控、巡检、告警、工单闭环一体化
运维·数据库·sql·mysql·架构