安装原生扩展

Rust 原生扩展目前为开发预览，在 Linux 上的 PostgreSQL 17 中运行。它提供同步的 jev_native.* 函数，可直接从 SQL 调用，不依赖 Python 服务。

使用原生 Compose 配置#

在 main 分支的代码目录中运行：

python deploy/configure.py --native
docker compose -f compose.yaml -f compose.native.yaml build
docker compose -f compose.yaml -f compose.native.yaml up -d --wait

这套配置会构建扩展，并配置证据注册表所需的受限账户。原生配置使用独立数据卷，但默认主机端口与普通应用部署相同；若两套同时运行，请先调整端口。

理解执行路径#

直接调用 jev_native.* 时，语义执行由 PostgreSQL 内的 Rust 扩展负责。自然语言规划、HTTP 接口和网页工作区仍由 Python 应用提供。

在应用中启用受支持的原生读取，需要相同代码版本的应用、匹配的迁移，以及 SDD_SEMANTIC_ENGINE=native。这不会把所有算子都切换到 Rust。持续维护的语义特征和语义写入复核仍需要 Python。

配置模型服务#

原生扩展使用服务器端的 JEV_NATIVE_CONFIG_FILE 读取兼容的 HTTP 服务配置。不要把密钥写入 SQL 参数或示例查询。

执行器位于数据库中，模型仍可能由远程服务提供。本地推理同样需要兼容的 HTTP 接口。应用与原生扩展的服务配置相互独立。

在已有服务器安装#

自行构建需要 PostgreSQL 17 的开发文件、Rust 和匹配的 pgrx 工具链。详细版本、安装权限、注册表配置和升级步骤见英文原生安装指南。

建议先用独立数据库验证，再决定是否用于实际工作负载。当前集成测试验证执行行为，不代表自然语言准确率或性能优势。

本页介绍用法与注意事项。完整参数及详细约定请参阅对应英文文档。