diff --git a/docker-compose.dev.yml b/docker-compose.dev.yml index 39f9031b..014404ed 100644 --- a/docker-compose.dev.yml +++ b/docker-compose.dev.yml @@ -2,7 +2,7 @@ services: # 只启动依赖的基础设施服务 postgres: - image: paradedb/paradedb:v0.22.6-pg17 + image: paradedb/paradedb:v0.25.11-pg17 container_name: WeKnora-postgres-dev ports: - "${DB_PORT:-5432}:5432" @@ -382,7 +382,7 @@ services: # --------------------------------------------------------------------------- # 复用 dev 已有的 ParadeDB 镜像,不额外拉 postgres 镜像 langfuse-db-init: - image: paradedb/paradedb:v0.22.6-pg17 + image: paradedb/paradedb:v0.25.11-pg17 container_name: WeKnora-langfuse-db-init-dev depends_on: postgres: diff --git a/docker-compose.yml b/docker-compose.yml index cfd23f4a..dcf5539e 100644 --- a/docker-compose.yml +++ b/docker-compose.yml @@ -541,7 +541,7 @@ services: # 修改的PostgreSQL配置 postgres: - image: paradedb/paradedb:v0.22.6-pg17 + image: paradedb/paradedb:v0.25.11-pg17 container_name: WeKnora-postgres environment: - POSTGRES_USER=${DB_USER} @@ -819,7 +819,7 @@ services: # 一次性初始化脚本:在已有的 WeKnora-postgres 里创建 langfuse 数据库(幂等,数据库已存在则跳过) # 复用 WeKnora-postgres 的 ParadeDB 镜像,避免多拉一个 postgres 镜像 langfuse-db-init: - image: paradedb/paradedb:v0.22.6-pg17 + image: paradedb/paradedb:v0.25.11-pg17 container_name: WeKnora-langfuse-db-init depends_on: postgres: diff --git a/internal/application/repository/chunk_image_assets_test.go b/internal/application/repository/chunk_image_assets_test.go index ec938497..d21fb42f 100644 --- a/internal/application/repository/chunk_image_assets_test.go +++ b/internal/application/repository/chunk_image_assets_test.go @@ -20,7 +20,7 @@ import ( // both spellings need the same assertions. For example: // // docker run -d --rm -e POSTGRES_PASSWORD=pg -e POSTGRES_DB=weknora -p 55432:5432 \ -// paradedb/paradedb:v0.22.6-pg17 +// paradedb/paradedb:v0.25.11-pg17 // WEKNORA_REPOSITORY_TEST_POSTGRES_DSN=postgres://postgres:pg@localhost:55432/weknora?sslmode=disable // // Both runs apply the real chunk_images migration, so the triggers and the diff --git a/internal/database/migration_postgres_test.go b/internal/database/migration_postgres_test.go index 575dae01..e735f0a1 100644 --- a/internal/database/migration_postgres_test.go +++ b/internal/database/migration_postgres_test.go @@ -18,7 +18,7 @@ import ( // at a disposable database, for example: // // docker run -d --rm -e POSTGRES_PASSWORD=pg -e POSTGRES_DB=weknora -p 55432:5432 \ -// paradedb/paradedb:v0.22.6-pg17 +// paradedb/paradedb:v0.25.11-pg17 // WEKNORA_MIGRATION_TEST_POSTGRES_DSN=postgres://postgres:pg@localhost:55432/weknora?sslmode=disable // // It checks what SQLite cannot: that 000106 builds its index CONCURRENTLY diff --git a/migrations/versioned/000099_pg_search_0226.up.sql b/migrations/versioned/000099_pg_search_0226.up.sql index c1a257d2..7c3a26f4 100644 --- a/migrations/versioned/000099_pg_search_0226.up.sql +++ b/migrations/versioned/000099_pg_search_0226.up.sql @@ -21,6 +21,15 @@ BEGIN SELECT 1 FROM pg_available_extension_versions WHERE name = 'pg_search' AND version = '0.22.6' ) THEN + -- Newer images only ship the latest install script; 000115 upgrades + -- them directly. Updating the catalog to 0.22.6 there would mismatch + -- the shared library. + IF EXISTS ( + SELECT 1 FROM pg_available_extension_versions + WHERE name = 'pg_search' AND version = '0.25.11' + ) THEN + RETURN; + END IF; RAISE NOTICE 'pg_search 0.22.6 is not available; update the server image and run ALTER EXTENSION pg_search UPDATE TO ''0.22.6'' manually'; RETURN; END IF; diff --git a/migrations/versioned/000115_pg_search_02511.down.sql b/migrations/versioned/000115_pg_search_02511.down.sql new file mode 100644 index 00000000..18f51c6d --- /dev/null +++ b/migrations/versioned/000115_pg_search_02511.down.sql @@ -0,0 +1,2 @@ +-- No-op: extension SQL upgrades cannot be reversed by a schema rollback. +-- Restore a pre-upgrade database backup together with the matching old image. diff --git a/migrations/versioned/000115_pg_search_02511.up.sql b/migrations/versioned/000115_pg_search_02511.up.sql new file mode 100644 index 00000000..12ea9ce4 --- /dev/null +++ b/migrations/versioned/000115_pg_search_02511.up.sql @@ -0,0 +1,34 @@ +-- Complete the SQL side of the ParadeDB v0.22.x -> v0.25.11 image upgrade. +-- A catalog left at an older version than the server's shared library can +-- crash the whole server when its SQL functions are called (for example +-- paradedb.version_info()), so the catalog must follow the image. +DO $$ +DECLARE + search_version TEXT; + vector_version TEXT; +BEGIN + IF current_setting('app.skip_embedding', true) = 'true' THEN + RETURN; + END IF; + + -- Leave absent extensions and other release lines under operator control. + -- Do not downgrade a newer extension or upgrade an external server to its + -- potentially incompatible default version. + SELECT extversion INTO search_version FROM pg_extension WHERE extname = 'pg_search'; + IF search_version ~ '^0\.(22|23|24|25)\.[0-9]+$' AND search_version <> '0.25.11' + AND EXISTS ( + SELECT 1 FROM pg_available_extension_versions + WHERE name = 'pg_search' AND version = '0.25.11' + ) THEN + ALTER EXTENSION pg_search UPDATE TO '0.25.11'; + END IF; + + SELECT extversion INTO vector_version FROM pg_extension WHERE extname = 'vector'; + IF vector_version IN ('0.8.0', '0.8.1', '0.8.2', '0.8.3') + AND EXISTS ( + SELECT 1 FROM pg_available_extension_versions + WHERE name = 'vector' AND version = '0.8.4' + ) THEN + ALTER EXTENSION vector UPDATE TO '0.8.4'; + END IF; +END $$; diff --git a/scripts/test_paradedb_upgrade.py b/scripts/test_paradedb_upgrade.py index 5aa020e3..ca2748fa 100644 --- a/scripts/test_paradedb_upgrade.py +++ b/scripts/test_paradedb_upgrade.py @@ -1,7 +1,7 @@ """Verify a ParadeDB patch upgrade using disposable Docker volumes and real migrations. Requires Python 3 and Docker; no database credentials or running WeKnora needed. -Run: python3 scripts/test_paradedb_upgrade.py +Run: python3 scripts/test_paradedb_upgrade.py [--to 0.25.11|0.22.6] Artifacts (snapshots, plans, logs and a synthetic-data backup) are kept in /tmp. """ import argparse @@ -17,6 +17,12 @@ import uuid ROOT = pathlib.Path(__file__).resolve().parents[1] OUT = None CONTAINER = 'weknora-pdb-upgrade-' + uuid.uuid4().hex[:12] +# target pg_search version -> (image, expected vector version or None if unchanged) +TARGETS = { + '0.22.6': ('paradedb/paradedb:v0.22.6-pg17', None), + '0.25.11': ('paradedb/paradedb:v0.25.11-pg17', '0.8.4'), +} +UPGRADES = ['000099_pg_search_0226.up.sql', '000115_pg_search_02511.up.sql'] def sql(query, db='weknora'): p = subprocess.run(['docker', 'exec', '-i', CONTAINER, 'psql', '-X', '-qAt', '-U', 'postgres', '-d', db, '-v', 'ON_ERROR_STOP=1'], input=query, text=True, capture_output=True) @@ -126,7 +132,9 @@ def migrate(db, paths, label): with (OUT/(label+'.log')).open('w') as log: for path in paths: log.write(path.name+'\n') - sql('BEGIN;\n'+path.read_text()+'\nCOMMIT;', db) + text = path.read_text() + # CONCURRENTLY cannot run in a transaction block; golang-migrate does not add one either. + sql(text if 'CONCURRENTLY' in text else 'BEGIN;\n'+text+'\nCOMMIT;', db) print(f'{label}: {len(paths)} SQL migrations passed', flush=True) @@ -149,6 +157,7 @@ def main(): global OUT parser = argparse.ArgumentParser(description=__doc__) parser.add_argument('--output-dir', type=pathlib.Path) + parser.add_argument('--to', choices=sorted(TARGETS), default='0.25.11', help='target pg_search version') args = parser.parse_args() OUT = args.output_dir or pathlib.Path(tempfile.mkdtemp(prefix='weknora-pdb-upgrade-')) OUT.mkdir(parents=True, exist_ok=True) @@ -156,19 +165,26 @@ def main(): raise RuntimeError('Use an empty output directory') print('Evidence: '+str(OUT), flush=True) volume = CONTAINER+'-data' - old, new = 'paradedb/paradedb:v0.22.2-pg17', 'paradedb/paradedb:v0.22.6-pg17' + old = 'paradedb/paradedb:v0.22.2-pg17' + target = args.to + new, vector_target = TARGETS[target] paths = sorted((ROOT/'migrations/versioned').glob('*.up.sql')) baseline = [p for p in paths if int(p.name.split('_')[0]) < 99] - upgrade = ROOT/'migrations/versioned/000099_pg_search_0226.up.sql' + upgrade = [ROOT/'migrations/versioned'/name for name in UPGRADES] + upgrade_sql = '\n'.join(p.read_text() for p in upgrade) + search_version = "SELECT extversion FROM pg_extension WHERE extname='pg_search'" + vector_version = "SELECT extversion FROM pg_extension WHERE extname='vector'" # Only resources created by this invocation are ever removed. docker('volume', 'create', volume) try: start(old, volume) migrate('weknora', baseline, 'old-migrations') - assert sql("SELECT extversion FROM pg_extension WHERE extname='pg_search'") == '0.22.2' + assert sql(search_version) == '0.22.2' + old_vector = sql(vector_version) # Older external servers without the target package must remain usable. - migrate('weknora', [upgrade], 'unavailable-target') - assert sql("SELECT extversion FROM pg_extension WHERE extname='pg_search'") == '0.22.2' + migrate('weknora', upgrade, 'unavailable-target') + assert sql(search_version) == '0.22.2' + assert sql(vector_version) == old_vector seed() snapshot('before') with (OUT/'before.dump').open('wb') as backup: @@ -177,12 +193,14 @@ def main(): docker('rm', CONTAINER) start(new, volume) # Replacing the image alone leaves the SQL catalog at the old version. - assert sql("SELECT extversion FROM pg_extension WHERE extname='pg_search'") == '0.22.2' - sql("BEGIN; SET LOCAL app.skip_embedding='true';\n"+upgrade.read_text()+"\nCOMMIT;") - assert sql("SELECT extversion FROM pg_extension WHERE extname='pg_search'") == '0.22.2' - migrate('weknora', [upgrade, upgrade], 'extension-upgrade-and-idempotence') - assert sql("SELECT extversion FROM pg_extension WHERE extname='pg_search'") == '0.22.6' - assert sql('SELECT version FROM paradedb.version_info()') == '0.22.6' + assert sql(search_version) == '0.22.2' + sql("BEGIN; SET LOCAL app.skip_embedding='true';\n"+upgrade_sql+"\nCOMMIT;") + assert sql(search_version) == '0.22.2' + migrate('weknora', upgrade + upgrade, 'extension-upgrade-and-idempotence') + assert sql(search_version) == target + assert sql(vector_version) == (vector_target or old_vector) + # Calls into the shared library crash the server if the catalog lags behind it. + assert sql('SELECT version FROM paradedb.version_info()') == target snapshot('after') docker('restart', '-t', '60', CONTAINER) for _ in range(60): @@ -195,10 +213,10 @@ def main(): check_writes() sql('CREATE DATABASE upgrade_fresh TEMPLATE template0') # The new migration must not install pg_search on non-search databases. - migrate('upgrade_fresh', [upgrade], 'absent-extension') - assert sql("SELECT count(*) FROM pg_extension WHERE extname='pg_search'", 'upgrade_fresh') == '0' + migrate('upgrade_fresh', upgrade, 'absent-extension') + assert sql("SELECT count(*) FROM pg_extension WHERE extname IN ('pg_search','vector')", 'upgrade_fresh') == '0' migrate('upgrade_fresh', paths, 'fresh-migrations') - assert sql("SELECT extversion FROM pg_extension WHERE extname='pg_search'", 'upgrade_fresh') == '0.22.6' + assert sql(search_version, 'upgrade_fresh') == target sql("INSERT INTO embeddings(source_id,source_type,content,dimension) VALUES ('fresh',0,'新安装检索',1024)", 'upgrade_fresh') assert sql("SELECT count(*) FROM embeddings WHERE content ||| '检索'", 'upgrade_fresh') == '1' print('PASS: fresh install and Chinese BM25 query', flush=True) diff --git a/website-docs/01-getting-started/02-installation.md b/website-docs/01-getting-started/02-installation.md index ca86f3ab..a05182c6 100644 --- a/website-docs/01-getting-started/02-installation.md +++ b/website-docs/01-getting-started/02-installation.md @@ -43,7 +43,7 @@ flowchart TB - **源码编译**:Go 1.26(见 `docker/Dockerfile.app` builder 阶段 `golang:1.26-bookworm`)、CGO(依赖 `libsqlite3-dev`)、Node.js + npm(前端)、Python 3.10 + uv(docreader)。 - **Kubernetes**:>= 1.25.0(`helm/Chart.yaml`)。 -Compose 默认 ParadeDB `v0.22.6-pg17` 的 x86 CPU 基线为 `x86-64-v2`(包括 SSE4.2、POPCNT),不再强制要求 AVX2。这不代表所有 ARM CPU 或其他可选服务均兼容。 +Compose 默认 ParadeDB 镜像自 `v0.22.6-pg17` 起 x86 CPU 基线为 `x86-64-v2`(包括 SSE4.2、POPCNT),不再强制要求 AVX2;更高镜像版本的基线以 ParadeDB 官方发布说明为准。这不代表所有 ARM CPU 或其他可选服务均兼容。 ## 一、Docker Compose 标准部署(docker-compose.yml) @@ -88,7 +88,7 @@ docker compose up -d | `frontend` | `wechatopenai/weknora-ui:${WEKNORA_VERSION:-latest}` | `${FRONTEND_PORT:-80}:80` | app(healthy) | Nginx 托管 SPA 并反代到 app;`APP_HOST`/`APP_BACKEND_PORT`/`APP_SCHEME` 可指向远程后端 | | `app` | `wechatopenai/weknora-app` | `${APP_PORT:-8080}:8080` | postgres(healthy)、redis、docreader(healthy) | Go 后端;挂载 `./config/config.yaml`、`data-files` 卷;健康检查 `GET /health` | | `docreader` | `wechatopenai/weknora-docreader` | 仅 `expose: 50051`(不发布到宿主机) | — | 文档解析 gRPC 服务;健康检查 `grpc_health_probe`;与 app 共享 `docreader-tmp` 卷传递图片 | -| `postgres` | `paradedb/paradedb:v0.22.6-pg17` | 不映射宿主端口 | — | ParadeDB = PostgreSQL 17 + BM25/向量扩展,默认检索引擎 | +| `postgres` | `paradedb/paradedb:v0.25.11-pg17` | 不映射宿主端口 | — | ParadeDB = PostgreSQL 17 + BM25/向量扩展,默认检索引擎 | | `redis` | `redis:7.0-alpine` | 不映射宿主端口 | — | `--appendonly yes --requirepass ${REDIS_PASSWORD}` | ### 可选服务与 profiles diff --git a/website-docs/01-getting-started/06-paradedb-upgrade.md b/website-docs/01-getting-started/06-paradedb-upgrade.md index 53741552..320e7e6a 100644 --- a/website-docs/01-getting-started/06-paradedb-upgrade.md +++ b/website-docs/01-getting-started/06-paradedb-upgrade.md @@ -1,6 +1,11 @@ # ParadeDB 存量库升级 -仓库的生产与开发 Compose 使用 `paradedb/paradedb:v0.22.6-pg17`。本文处理 **0.22.2 → 0.22.6、PostgreSQL 主版本保持 17** 的升级;不适用于 PostgreSQL 跨主版本升级,也不代表 Helm 中其他旧版本可以直接套用。 +仓库的生产与开发 Compose 使用 `paradedb/paradedb:v0.25.11-pg17`。本文处理 **0.22.x → 0.25.11、PostgreSQL 主版本保持 17** 的升级;不适用于 PostgreSQL 跨主版本升级,也不代表 Helm 中其他旧版本可以直接套用。 + +该版本线相对 `v0.22.6-pg17` 带来 PostgreSQL 17.9 → 17.11、pgvector 0.8.1 → 0.8.4(修复并行 HNSW 构建缓冲区溢出与 HNSW vacuum 期间的索引损坏)以及 pg_search 基于 WAL 的崩溃恢复(0.24.0 起,见 paradedb#4901)。 + +> [!WARNING] +> 替换镜像后**必须**把扩展 catalog 升级到与镜像一致的版本。catalog 停留在旧版本时,部分扩展 SQL 函数(例如 `paradedb.version_info()`)会因签名与新二进制不匹配而触发段错误,导致整个 PostgreSQL 实例崩溃并进入恢复。也**不要**在新镜像上执行 `ALTER EXTENSION pg_search UPDATE TO '0.22.6'`,它同样会造成上述不匹配。 ## 升级步骤 @@ -31,35 +36,39 @@ docker compose up -d --no-deps --wait postgres ``` -4. 完成扩展的 SQL 升级。仅替换镜像不会更新已有数据库内的 `pg_extension` 版本。 +4. 完成扩展的 SQL 升级。仅替换镜像不会更新已有数据库内的 `pg_extension` 版本。新镜像自带 0.22.x 起的完整升级脚本链,任意 0.22.x 都可以一步升级到镜像默认版本: ```bash docker compose exec -T postgres sh -c 'psql -U "$POSTGRES_USER" -d "$POSTGRES_DB" -v ON_ERROR_STOP=1' <<'SQL' - ALTER EXTENSION pg_search UPDATE TO '0.22.6'; + ALTER EXTENSION pg_search UPDATE; + ALTER EXTENSION vector UPDATE; SELECT extname, extversion FROM pg_extension WHERE extname IN ('pg_search', 'vector'); SELECT * FROM paradedb.version_info(); SQL ``` - 在**其他已安装 `pg_search` 的数据库**中同样执行,包括安装过该扩展的 `postgres`、模板库或 Langfuse 库。不要为了升级而向原本不需要的数据库安装扩展。catalog 与 `paradedb.version_info()` 应均报告 0.22.6。 + 在**其他已安装 `pg_search` 或 `vector` 的数据库**中同样执行,包括安装过该扩展的 `postgres`、模板库或 Langfuse 库。不要为了升级而向原本不需要的数据库安装扩展。`pg_search` 的 catalog 与 `paradedb.version_info()` 应均报告 0.25.11,`vector` 应为 0.8.4。 -5. 恢复原先运行的写入服务,确认数据库迁移状态,执行有代表性的关键词与向量检索。这个补丁升级无需专门重建全部索引或重新导入文档;保留备份直到验证完成。 +5. 恢复原先运行的写入服务,确认数据库迁移状态,执行有代表性的关键词与向量检索。已有的 BM25 与 HNSW 索引在新版本下可继续读写,无需专门重建全部索引或重新导入文档;如遇异常可 `REINDEX`。保留备份直到验证完成。 ## 自动迁移的范围 -迁移 `000099` 仅在 WeKnora 数据库内执行扩展升级:已安装版本须为 0.22.2–0.22.5,且服务器提供 0.22.6 扩展包。它遵守 `app.skip_embedding`,不安装缺失的扩展,也不处理其他版本线。 +WeKnora 启动时的迁移只在 WeKnora 数据库内升级扩展,遵守 `app.skip_embedding`,不安装缺失的扩展,也不降级或处理其他版本线: -如果这条迁移在替换数据库镜像**之前**已经执行,安装新镜像后不会自动再跑一次,需要手动执行上面的 SQL。没有 `000099` 的旧应用也需手工升级。其他数据库的扩展不能靠 WeKnora 的迁移代管。 +- `000115`:已安装的 `pg_search` 为 0.22.0–0.25.10 且服务器提供 0.25.11 时,升级到 0.25.11;已安装的 `vector` 为 0.8.0–0.8.3 且服务器提供 0.8.4 时,升级到 0.8.4。 +- `000099`:历史迁移,仅在服务器提供 0.22.6 扩展包(即仍使用 `v0.22.6-pg17` 镜像)时把 0.22.2–0.22.5 升级到 0.22.6;新镜像上会跳过,交给 `000115`。 + +如果这些迁移在替换数据库镜像**之前**已经执行,安装新镜像后不会自动再跑一次,需要手动执行上面的 SQL。没有对应迁移的旧应用也需手工升级。其他数据库的扩展不能靠 WeKnora 的迁移代管。 ## 回滚与复现验证 -回滚需要将升级前备份/快照恢复到独立数据卷,配合旧镜像使用。仅把镜像标签改回旧版不会撤销扩展 SQL 变更,`000099` 的 down 文件也不会尝试降级扩展。 +回滚只能将升级前备份/快照恢复到独立数据卷,配合旧镜像使用。仅把镜像标签改回旧版不会撤销扩展 SQL 变更;而且 pg_search 0.24 起会向 WAL 写入自定义资源管理器记录,旧镜像无法重放这些记录。迁移的 down 文件也不会尝试降级扩展。 -仓库提供隔离验证脚本: +仓库提供隔离验证脚本,默认验证 0.22.2 → 0.25.11,也可用 `--to 0.22.6` 验证历史补丁升级: ```bash docker pull paradedb/paradedb:v0.22.2-pg17 -docker pull paradedb/paradedb:v0.22.6-pg17 +docker pull paradedb/paradedb:v0.25.11-pg17 python3 scripts/test_paradedb_upgrade.py ``` diff --git a/website-docs/02-architecture/01-overview.md b/website-docs/02-architecture/01-overview.md index d37691ad..81ad9fa9 100644 --- a/website-docs/02-architecture/01-overview.md +++ b/website-docs/02-architecture/01-overview.md @@ -13,7 +13,7 @@ WeKnora 采用"主服务 + 前端 + 文档解析微服务"的三进程核心架 | `app` | `wechatopenai/weknora-app`(`docker/Dockerfile.app`,Go) | `8080` | 主后端:REST API、RAG 检索、Agent 引擎、异步任务 worker、IM/Embed 渠道接入。健康检查 `GET /health` | | `frontend` | `wechatopenai/weknora-ui`(`frontend/`,NGINX + Vue3 静态产物) | `80` | Web UI;NGINX 同时充当反向代理,将 `/api` 转发到 `app`(`APP_HOST`/`APP_BACKEND_PORT`/`APP_SCHEME` 可指向远端后端) | | `docreader` | `wechatopenai/weknora-docreader`(`docker/Dockerfile.docreader`,Python) | `50051`(仅 compose 网络内 expose,不映射宿主机) | 文档解析微服务:gRPC 服务端,PDF/DOCX/Excel/EPUB/网页等 25+ 格式解析与页面渲染。健康检查 `grpc_health_probe` | -| `postgres` | `paradedb/paradedb:v0.22.6-pg17` | `5432`(网络内) | 主数据库。ParadeDB 发行版自带 BM25 全文检索与 pgvector 向量能力,因此**默认部署无需独立向量库**(`RETRIEVE_DRIVER=postgres`) | +| `postgres` | `paradedb/paradedb:v0.25.11-pg17` | `5432`(网络内) | 主数据库。ParadeDB 发行版自带 BM25 全文检索与 pgvector 向量能力,因此**默认部署无需独立向量库**(`RETRIEVE_DRIVER=postgres`) | | `redis` | `redis:7.0-alpine`(`appendonly` + `requirepass`) | `6379`(网络内) | Asynq 任务队列、SSE 流管理(跨实例)、system_settings 发布订阅、限流与分布式模型并发闸门 | | `sandbox` | `wechatopenai/weknora-sandbox`(`docker/Dockerfile.sandbox`) | — | WeKnora 标准运行镜像;可直接用于空间 Docker 后端,接入 CubeSandbox/E2B 时则通过模板 API 自动注册并用于 Agent Skills | diff --git a/website-docs/06-development/01-dev-guide.md b/website-docs/06-development/01-dev-guide.md index 296f3bef..3e81b2cb 100644 --- a/website-docs/06-development/01-dev-guide.md +++ b/website-docs/06-development/01-dev-guide.md @@ -64,7 +64,7 @@ make dev-restart # 重启 | 服务 | 镜像 | 端口(默认) | 启动条件 | | --- | --- | --- | --- | -| `postgres` | `paradedb/paradedb:v0.22.6-pg17`(自带 pg_search/BM25) | `5432` | 默认启动 | +| `postgres` | `paradedb/paradedb:v0.25.11-pg17`(自带 pg_search/BM25) | `5432` | 默认启动 | | `redis` | `redis:7.0-alpine`(`--requirepass`) | `6379` | 默认启动 | | `docreader` | 本地构建 `docker/Dockerfile.docreader` | `50051`(gRPC) | 默认启动 | | `searxng`(+`searxng-init`) | `searxng/searxng:latest` | `127.0.0.1:8888` | `--searxng` / `--full`(compose profile `searxng`) | diff --git a/website-docs/06-development/02-database-schema.md b/website-docs/06-development/02-database-schema.md index 415532f4..9c117616 100644 --- a/website-docs/06-development/02-database-schema.md +++ b/website-docs/06-development/02-database-schema.md @@ -413,7 +413,7 @@ make migrate-up BM25 索引(`USING bm25`、Lindera 中文分词)只在 ParadeDB 可用;原生 Postgres 部署需保证相应迁移的条件分支生效或改用 Elasticsearch 等外部检索引擎。存量原生 Postgres 库切到 ParadeDB 可参考 `migrations/paradedb/01-migrate-to-paradedb.sql`。 -官方镜像自 v0.8.2 起为 `paradedb/paradedb:v0.22.6-pg17`。迁移 000099 只把已安装的 pg_search 0.22.2–0.22.5 升级到 0.22.6:若启动日志提示 `pg_search 0.22.6 is not available`,说明数据库镜像还没换,换镜像后手工执行 `ALTER EXTENSION pg_search UPDATE TO '0.22.6'`;其他版本线不会被自动升级或降级。 +官方镜像为 `paradedb/paradedb:v0.25.11-pg17`(v0.8.2 起曾为 `v0.22.6-pg17`)。迁移 000115 在服务器提供对应扩展包时,把已安装的 pg_search 0.22.0–0.25.10 升级到 0.25.11、pgvector 0.8.0–0.8.3 升级到 0.8.4;历史迁移 000099 仅在仍使用 `v0.22.6-pg17` 镜像时生效。其他版本线不会被自动升级或降级。扩展 catalog 必须与镜像版本一致,否则调用部分扩展函数会使数据库崩溃;手工升级见《ParadeDB 存量库升级》,在新镜像上不要执行 `ALTER EXTENSION pg_search UPDATE TO '0.22.6'`。 ### 版本文件冲突 {#_7-5-版本文件冲突}