首页
/ pgrx v0.14.0 发布:支持 Windows 平台与多项重要更新

pgrx v0.14.0 发布:支持 Windows 平台与多项重要更新

2025-06-14 01:12:46作者:余洋婵Anita

pgrx 是一个用于开发 PostgreSQL 扩展的 Rust 框架,它允许开发者使用 Rust 语言编写高性能、安全的数据库扩展。最新发布的 v0.14.0 版本带来了多项重要更新,其中最引人注目的是对 Windows 平台的支持,这标志着 pgrx 框架跨平台能力的重要突破。

Windows 平台支持

v0.14.0 版本首次正式支持 Windows 平台,这是一个重要的里程碑。在 Windows 上使用 pgrx 开发 PostgreSQL 扩展时,需要注意以下几点关键事项:

  1. 必须启用 pgrx 的 cshim 特性,可以通过在项目的 Cargo.toml 中配置或使用 cargo build --features pgrx/cshim 命令来启用。

  2. 编译器现在会将代码和数据放在不同的段(section)中,这是 Windows 平台的特殊要求。

  3. 所有标记为 #[pg_guard] 的函数现在必须使用 "C-unwind" ABI(应用二进制接口),这一变更不仅适用于 Windows,也适用于所有支持的平台。"C-unwind" ABI 允许异常在跨语言边界时正确展开堆栈,这对于保证程序在异常情况下的正确行为至关重要。

重要变更与改进

移除对 PostgreSQL 12 的支持

v0.14.0 正式移除了对 PostgreSQL 12 的支持。如果项目仍需支持 PostgreSQL 12,需要将依赖锁定在 pgrx v0.13.1 版本。这一变更反映了项目对保持现代性和维护效率的考量。

API 变更与改进

  1. DatumWithOid 增强:新增了 new_from_datumnull_oid 方法,提供了更灵活的方式来处理带有 OID 的数据。

  2. 统计信息支持:实现了 pgstat 宏,使得扩展可以更方便地收集和报告统计信息。

  3. OID 类型改进:为 Oid 类型实现了 Display trait,并重命名了 as_u32 方法为 to_u32,使其更符合 Rust 的命名惯例。

  4. 事务 ID 支持:新增了对 PostgreSQL 事务 ID (xid) 类型的映射支持,现在可以在 #[pg_extern] 函数中使用 pg_sys::TransactionId 作为参数或返回类型。

性能优化

  1. 数组处理优化:通过消除中间 Vec 分配,优化了数组的 IntoDatum 实现,减少了内存分配和复制操作。

  2. 高效操作:新增了 PgHeapTuple::set_by_index_unchecked 方法,为需要极致性能的场景提供了不进行检查的版本。

新增 PostgreSQL 头文件支持

v0.14.0 包含了更多 PostgreSQL 内部头文件的绑定,为开发者提供了更全面的底层访问能力:

  • 存储层内部结构 (storage/buf_internals.h)
  • 文本搜索缓存 (tsearch/ts_cache.h)
  • 表空间缓存 (utils/spccache.h)
  • 分区相关头文件

这些新增的头文件绑定使得开发者能够实现更复杂、更底层的数据库功能。

开发者体验改进

  1. 交叉编译支持:现在可以更方便地为不同目标平台编译扩展。

  2. 代码质量提升:进行了大量的代码清理和 lint 修正,提高了代码的整体质量。

  3. 文档改进:修正了多处文档错误,并更新了 Windows 平台的使用说明。

升级建议

升级到 v0.14.0 时,开发者需要注意以下几点:

  1. 检查所有使用 #[pg_guard] 的函数,确保它们使用 "C-unwind" ABI。

  2. 更新 PgLwLockPgAtomic 的使用方式,因为这些类型的构造函数现在需要名称参数。

  3. 在 Linux 上使用 --runas 选项前,需要先执行 sudo sysctl fs.protected_fifos=0 来调整内核设置。

  4. 如果项目仍需要支持 PostgreSQL 12,需要明确锁定 pgrx 依赖版本为 0.13.1。

pgrx v0.14.0 的这些改进和新特性,特别是 Windows 平台支持,大大扩展了 Rust 开发 PostgreSQL 扩展的可能性,为开发者提供了更强大、更灵活的工具集。

登录后查看全文
热门项目推荐
相关项目推荐