Citus数据库对PostgreSQL 17的支持与适配工作

Citus团队近期完成了对PostgreSQL 17版本的全面支持工作，这是一项重要的技术升级。作为PostgreSQL的分布式扩展，Citus需要确保与最新PostgreSQL版本的完全兼容性。本文将详细介绍这次适配过程中的技术挑战和解决方案。

测试框架与验证

Citus团队采用了全面的回归测试套件来验证PG17兼容性，包括：

• 多节点测试(multi-1/multi/multi-mx)
• 企业版功能测试(enterprise)
• 列存储测试(columnar)
• 隔离级别测试(isolation)
• 多种配置测试(arbitrary-configs)
• 基础功能测试(vanilla)

所有测试套件最终都达到了零失败的完美状态，确保了功能的完整性和稳定性。

主要技术挑战与解决方案

权限系统变更

PostgreSQL 17引入了MAINTAIN权限，这导致了多处权限相关测试失败。团队通过以下方式解决：

• 更新错误消息预期，从"must be owner of"调整为"permission denied"
• 处理新增的MAINTAIN权限位(16384)相关错误
• 调整多用户场景下的权限验证逻辑

查询计划优化器改进

PG17的查询优化器有显著改进，导致多处EXPLAIN输出变化：

• Hash Join改为Nested Loop Join
• 新增Materialize操作
• 合并操作优化 团队更新了测试预期输出以匹配新的优化器行为。

分区表功能增强

针对分区表功能的改进：

• 处理了排除约束(exclusion constraints)在分区表上的支持变化
• 修复了包含identity列的分区表附加操作
• 调整了表访问方法(table access method)在分区表上的限制

MERGE命令增强

PG17对MERGE命令做了重要扩展：

• 支持WITH子句和COPY操作
• 改进了分布列(distribution column)更新限制的错误提示
• 增强了对视图(view)操作的限制
• 调整了RETURNING子句的语法检查

其他重要修复

• 处理了数组字面量解析的严格化
• 修复了类型依赖关系的处理方式
• 调整了统计信息相关函数的返回值
• 解决了时区相关测试的差异问题

升级路径验证

团队特别关注了版本升级的兼容性：

• 完成了PG15到PG17的升级测试
• 验证了PG16到PG17的升级路径
• 确保所有升级场景都能正确工作

总结

Citus团队通过系统性的测试和修复，成功实现了对PostgreSQL 17的全面支持。这项工作不仅保证了现有功能的兼容性，也为利用PG17的新特性奠定了基础。所有修复已合并到release-13.0分支，用户可放心升级到PG17环境使用Citus。