Documentation fix on pgbench \aset command

Yugo Nagata <nagata@sraoss.co.jp>

From: Yugo Nagata <nagata@sraoss.co.jp>
To: Pgsql Hackers <pgsql-hackers@postgresql.org>
Date: 2025-06-26T09:01:25Z
Lists: pgsql-hackers

Attachments

Hi,

The current documentation of pgbench’s \aset command states:

“If a query returns no row, no assignment is made and the variable
 can be tested for existence to detect this.”

However, this is inaccurate, since variable existence check (like \if :{?var})
is not yet supported, although such a feature was proposed in [1] and discussed
again in [2], where \aset itself was introduced.

Therefore, I’ve attached a patch to remove this part from the documentation.

[1] https://www.postgresql.org/message-id/flat/alpine.DEB.2.20.1802191909500.21372%40lancre
[2] https://www.postgresql.org/message-id/flat/alpine.DEB.2.21.1904081914200.2529%40lancre

Best regards,
Yugo Nagata
-- 
Yugo Nagata <nagata@sraoss.co.jp>

Commits

  1. pgbench: Clarify documentation for \gset and \aset.