FastGPT V4.5版本升级操作与数据库配置说明

升级背景

FastGPT V4.5版本包含两项核心更新：一是将PgVector插件升级至0.5版本，引入HNSW索引以提升知识库检索速度，该索引相比原有IVFFlat索引有性能提升，但构建索引的速度较慢，例如4c16g配置下处理500万组数据的并行构建约需48小时；二是新增AI对话模块的【返回AI内容】选项，可控制AI内容不直接返回浏览器。本次升级需对数据库进行专项操作，包含插件升级、索引重构与新索引构建。

升级操作步骤

根据部署方式分为两种场景：

Sealos部署方案

进入Sealos桌面的数据库应用，点击【pg】数据库的详情页面。
点击右上角重启按钮，等待数据库重启完成。
点击左侧一键链接，打开Terminal终端。
依次执行以下SQL命令：

```sql ALTER EXTENSION vector UPDATE; \dx alter system set maintenanceworkmem = 2400MB; select pgreloadconf(); REINDEX DATABASE postgres; CREATE INDEX CONCURRENTLY vectorindex ON modeldata USING hnsw ( vector vectoripops) WITH (m = 16 , efconstruction = 64 );

```

执行完成后可关闭终端，索引构建耗时较长无需等待完成。

Docker Compose部署方案

修改docker-compose.yml中pg容器的镜像版本，替换为ankane/pgvector:v0.5.0或registry.cn-hangzhou.aliyuncs.com/fastgpt/pgvector:v0.5.0。
执行命令更新镜像并重启容器：

```bash docker-compose pull docker-compose up -d

```

进入pg容器终端：

```bash docker exec -it pg bash

```

连接数据库，需替换命令中的username和password为实际数据库账号密码：

```bash psql postgresql://username:password@localhost:5432/postgres

```

依次执行以下SQL命令：

```sql ALTER EXTENSION vector UPDATE; \dx alter system set maintenanceworkmem = 2400MB; select pgreloadconf(); REINDEX DATABASE postgres; ALTER DATABASE postgres REFRESH COLLATION VERSION; CREATE INDEX CONCURRENTLY vectorindex ON modeldata USING hnsw ( vector vectoripops) WITH (m = 16 , efconstruction = 64 );

```

执行完成后可关闭终端，索引构建无需等待完成。

升级验证

升级完成后可重新连接数据库终端，执行\dx命令查看vector插件版本，确认版本为0.5.0；执行\d modeldata命令，若返回结果中包含vector_index hnsw (vector vector_ip_ops) WITH (m= 16 , ef_construction= 64 )且无INVALID字样，则代表升级与索引构建完成。