Sehrope Sarkuni：为JVM打造的新型PostgreSQL驱动pg-java
内容提要
pg-java是一个为JVM设计的新型PostgreSQL驱动，优先支持PostgreSQL原生协议，支持虚拟线程和流式处理。它提供批量插入数组参数重写、管道API、默认加密保护密码，并严格管理公共API。性能与pgjdbc相当，批量插入更快。该驱动主要由AI编写，经过大量测试，目前为预发布状态，支持JDBC层和兼容层。
延伸解读
设计取舍：安全默认与兼容性
pg-java在安全默认值上做了务实选择：sslmode保持prefer，但拒绝在无TLS的TCP连接上通过password或md5认证发送密码，避免默认verify-full导致用户直接禁用加密。同时提供allowUnencryptedPasswordAuth作为显式退出，兼容层则沿用pgjdbc默认，确保换jar不改变安全行为。
批量插入优化：数组参数重写
pg-java的批量INSERT重写为数组参数，SQL文本恒定，一次执行即可完成，避免多行VALUES重写的SQL膨胀和参数上限问题。基准测试显示其批量插入吞吐约为非重写路径的2倍，略优于pgjdbc的最佳批量模式。但该优化仅限INSERT，因为UPDATE/DELETE无法保证逐元素更新计数和行顺序。
AI开发流程的启示
驱动主要由AI编写，但关键在于配套的工程约束：AGENTS.md规范、架构决策记录（ADR）、可执行的API表面清单、严格的构建检查（格式、ASCII、模块分层、覆盖率）以及运行pgjdbc和Hibernate测试套件作为回归门禁。这些机制确保AI生成的代码符合预期，并防止错误回归。
性能与成熟度评估
在基准测试中，pg-java原生路径吞吐约为pgjdbc的101%-108%，分配方面部分路径更优（宽行少26%），但写路径分配更多。目前仍为预发布，未发布到Maven Central，API可能变动，兼容层非认证替代品。建议仅用于评估，生产使用需谨慎。
Q&A
pg-java是什么？它与pgjdbc有何不同？
pg-java是一个为JVM设计的新型PostgreSQL驱动，由Sehrope Sarkuni开发。它优先支持PostgreSQL原生协议，而不是以JDBC为基础。与pgjdbc相比，pg-java支持虚拟线程、流式处理、批量插入数组参数重写、管道API等特性，并且默认加密保护密码。
pg-java如何实现批量插入优化？
pg-java可以将批量INSERT重写为使用数组参数的单个语句，例如将N次INSERT重写为一次INSERT ... SELECT * FROM unnest(...)。这样SQL文本恒定，只需M个参数（每列一个数组），避免参数上限和多次解析，性能约为非重写路径的2倍，略优于pgjdbc的最佳批量模式。该功能通过rewriteBatchUsingArrays选项启用，目前仅支持INSERT。
pg-java的管道API有什么特点？
pg-java提供了真正的管道API，允许在等待结果之前发送多个语句，通过sync()方法作为错误边界。它支持显式流控制，避免死锁，并且结果按队列顺序返回。
pg-java如何保护密码安全？
pg-java默认在未加密的TCP连接上拒绝发送密码（除非使用SCRAM认证），通过allowUnencryptedPasswordAuth选项可以覆盖此行为。它还支持require_auth和channelBinding=require来提供降级保护。
pg-java的性能表现如何？
在基准测试中，pg-java的原生路径吞吐量约为pgjdbc的101-108%，批量插入性能约为pgjdbc的两倍。分配方面，宽行场景下分配量比pgjdbc少26%，但写入路径分配较多。
pg-java是如何由AI编写的？
pg-java主要由AI（Claude）在六周内编写，约1400个提交，52000行Java代码和43000行测试。开发过程通过AGENTS.md、ADR、计划文档和构建门禁来确保代码质量和一致性。
pg-java的当前状态和未来计划是什么？
pg-java目前是预发布状态，尚未发布到Maven Central，API仍在变动。它支持TCP、TLS、Unix套接字连接，SCRAM认证，简单和扩展查询协议，COPY，LISTEN/NOTIFY，大对象，管道和批量重写。未来计划包括实现JSON绑定和复合到记录映射等。
