From b6290ea48e1b8e868516d95cb86a0d3565d63847 Mon Sep 17 00:00:00 2001 From: Fujii Masao Date: Thu, 25 Sep 2025 12:09:32 +0900 Subject: [PATCH] pgbench: Clarify documentation for \gset and \aset. This commit updates the pgbench documentation to list \gset and \aset as separate terms for easier reading. It also clarifies that \gset raises an error if the query returns zero or multiple rows, and explains how to detect cases where the query with \aset returned no rows. Author: Yugo Nagata Reviewed-by: Fujii Masao Discussion: https://postgr.es/m/20250626180125.5b896902a3d0bcd93f86c240@sraoss.co.jp --- doc/src/sgml/ref/pgbench.sgml | 15 +++++++-------- 1 file changed, 7 insertions(+), 8 deletions(-) diff --git a/doc/src/sgml/ref/pgbench.sgml b/doc/src/sgml/ref/pgbench.sgml index ab252d9fc74..5ca9de63fa3 100644 --- a/doc/src/sgml/ref/pgbench.sgml +++ b/doc/src/sgml/ref/pgbench.sgml @@ -1188,10 +1188,8 @@ pgbench options d - - \gset [prefix] - \aset [prefix] - + \gset [prefix] + \aset [prefix] @@ -1203,16 +1201,17 @@ pgbench options d When the \gset command is used, the preceding SQL query is expected to return one row, the columns of which are stored into variables named after column names, and prefixed with prefix - if provided. + if provided. If the query returns zero or multiple rows, an error is raised. When the \aset command is used, all combined SQL queries (separated by \;) have their columns stored into variables named after column names, and prefixed with prefix - if provided. If a query returns no row, no assignment is made and the variable - can be tested for existence to detect this. If a query returns more than one - row, the last value is kept. + if provided. If a query returns no rows, no assignment is made. + This can be detected by initializing the variable beforehand with + a value the query cannot return, then checking whether it changes. + If a query returns more than one row, the last values is kept. -- 2.47.3