Laurenz Albe：cursor_tuple_fraction与PostgreSQL JDBC驱动程序
内容提要
这篇文章讲述了作者在研究PostgreSQL参数cursor_tuple_fraction时的失败经历，该参数用于优化使用游标的查询。作者还介绍了cursor_tuple_fraction的另一个用途，即优化查询的总执行时间。文章还提到了使用PostgreSQL JDBC驱动程序时的注意事项。最后，作者解释了为什么JDBC驱动程序无法受益于cursor_tuple_fraction的快速启动计划。
延伸解读
cursor_tuple_fraction 的适用场景
cursor_tuple_fraction 主要针对使用游标的查询，让优化器优先选择能快速返回首行的执行计划，而非总执行时间最短的计划。这对于客户端分块处理结果集、希望尽快看到数据的场景很有价值。但若游标声明为 WITH HOLD，结果集在提交时物化，此时应将该参数设为 1.0，以优化总执行时间。
JDBC 驱动为何无法受益
PostgreSQL JDBC 驱动通过扩展查询协议实现游标：重复发送 execute 消息并限制返回行数，而非使用 DECLARE 语句。因此，PostgreSQL 在查询规划时并不知道结果会被分块获取，无法应用 cursor_tuple_fraction 来生成快速启动计划。除非显式使用 LIMIT 子句，否则 JDBC 驱动无法利用该参数优化首行返回速度。
auto_explain 与事务提交的注意事项
使用 auto_explain 捕获执行计划时，若通过 JDBC 驱动执行查询，需注意：关闭结果集（rs.close()）并不会向服务器发送关闭游标的消息，游标实际在事务提交时才关闭。auto_explain 依赖语句执行时长来记录计划，因此必须显式提交事务，否则可能无法记录到执行计划。
Q&A
cursor_tuple_fraction参数的主要用途是什么？
cursor_tuple_fraction参数用于优化使用游标的查询，优先快速返回结果行。
在使用PostgreSQL JDBC驱动程序时，有哪些性能优化建议？
可以通过设置fetchSize来分块读取结果集，以改善性能。
为什么cursor_tuple_fraction在JDBC驱动程序中无效？
因为JDBC驱动程序不使用DECLARE语句创建游标，导致无法在查询规划时考虑cursor_tuple_fraction。
如何使用auto_explain工具捕获执行计划？
需要在postgresql.conf中启用auto_explain，并设置log_min_duration参数来记录执行计划。
使用WITH HOLD游标时，如何优化查询的总执行时间？
可以将cursor_tuple_fraction设置为1.0，以优化查询的总执行时间。
在PostgreSQL中，游标的作用是什么？
游标用于迭代结果集，避免一次性读取完整结果集，从而减少内存消耗。
