From ba7dee43c85f62517d59128ee6be788f1fd86fa8 Mon Sep 17 00:00:00 2001
From: Manuel Reyes Bravo <manuelreyesbravo@gmail.com>
Date: Mon, 16 Nov 2026 21:16:54 -0300
Subject: [PATCH v1] Fix IO tracking of temporary relations in single-user mode

pgstat_tracks_io_object() lists B_STANDALONE_BACKEND among the backend
types that never do IO on temporary relations, since 28e626bde00 (v16).
A backend in single-user mode executes queries like a client backend,
and can create and use temporary tables and sequences.  With assertions
enabled, an INSERT into a temporary table, CREATE TEMP TABLE AS or
nextval() on a temporary sequence fails the assertion in
pgstat_count_io_op():

  $ echo "CREATE TEMP TABLE t AS SELECT 1;" | postgres --single postgres
  TRAP: failed Assert("pgstat_tracks_io_op(MyBackendType, io_object, io_context, io_op)")

Without assertions, this IO is not counted: pg_stat_io has no
"temp relation" row for "standalone backend".

Remove B_STANDALONE_BACKEND from this list, and fix the comment above
it.  A TAP test runs these commands in single-user mode, with a
temporary table larger than temp_buffers so as local buffers are
evicted, written and read back, then checks pg_stat_io once the server
is started.

Discussion:
---
 src/backend/utils/activity/pgstat_io.c        | 14 ++--
 src/test/modules/test_misc/meson.build        |  1 +
 .../test_misc/t/016_single_user_temp_io.pl    | 79 +++++++++++++++++++
 src/test/regress/expected/stats.out           |  3 +-
 4 files changed, 89 insertions(+), 8 deletions(-)
 create mode 100644 src/test/modules/test_misc/t/016_single_user_temp_io.pl

diff --git a/src/backend/utils/activity/pgstat_io.c b/src/backend/utils/activity/pgstat_io.c
index 3c8fcb20..cec57596 100644
--- a/src/backend/utils/activity/pgstat_io.c
+++ b/src/backend/utils/activity/pgstat_io.c
@@ -413,16 +413,16 @@ pgstat_tracks_io_object(BackendType bktype, IOObject io_object,
 		return false;
 
 	/*
-	 * In core Postgres, only regular backends and WAL Sender processes
-	 * executing queries will use local buffers and operate on temporary
-	 * relations. Parallel workers will not use local buffers (see
-	 * InitLocalBuffers()); however, extensions leveraging background workers
-	 * have no such limitation, so track IO on IOOBJECT_TEMP_RELATION for
-	 * BackendType B_BG_WORKER.
+	 * In core Postgres, only regular backends, WAL Sender processes executing
+	 * queries and standalone backends (single-user mode) will use local
+	 * buffers and operate on temporary relations. Parallel workers will not
+	 * use local buffers (see InitLocalBuffers()); however, extensions
+	 * leveraging background workers have no such limitation, so track IO on
+	 * IOOBJECT_TEMP_RELATION for BackendType B_BG_WORKER.
 	 */
 	no_temp_rel = bktype == B_AUTOVAC_LAUNCHER || bktype == B_BG_WRITER ||
 		bktype == B_CHECKPOINTER || bktype == B_AUTOVAC_WORKER ||
-		bktype == B_STANDALONE_BACKEND || bktype == B_STARTUP ||
+		bktype == B_STARTUP ||
 		bktype == B_WAL_SUMMARIZER || bktype == B_WAL_WRITER ||
 		bktype == B_WAL_RECEIVER;
 
diff --git a/src/test/modules/test_misc/meson.build b/src/test/modules/test_misc/meson.build
index 5d81f5b1..f1750847 100644
--- a/src/test/modules/test_misc/meson.build
+++ b/src/test/modules/test_misc/meson.build
@@ -24,6 +24,7 @@ tests += {
       't/013_temp_obj_multisession.pl',
       't/014_log_statement_max_length.pl',
       't/015_temp_schema_exit_deferrable.pl',
+      't/016_single_user_temp_io.pl',
     ],
     # The injection points are cluster-wide, so disable installcheck
     'runningcheck': false,
diff --git a/src/test/modules/test_misc/t/016_single_user_temp_io.pl b/src/test/modules/test_misc/t/016_single_user_temp_io.pl
new file mode 100644
index 00000000..cc9a7386
--- /dev/null
+++ b/src/test/modules/test_misc/t/016_single_user_temp_io.pl
@@ -0,0 +1,79 @@
+# Copyright (c) 2026, PostgreSQL Global Development Group
+
+# Check that a backend in single-user mode can do IO on temporary relations,
+# and that this IO is reported in pg_stat_io.
+
+use strict;
+use warnings FATAL => 'all';
+use PostgreSQL::Test::Cluster;
+use PostgreSQL::Test::Utils;
+use Test::More;
+
+# Skip the tests on Windows, as single-user mode would fail on permission
+# failure with privileged accounts.
+if ($windows_os)
+{
+	plan skip_all => 'this test is not supported by this platform';
+}
+
+# Run set of queries in single-user mode.
+sub test_single_mode
+{
+	my ($node, $queries, $testname) = @_;
+
+	my $result = run_log(
+		[
+			'postgres', '--single', '-F',
+			'-c' => 'exit_on_error=true',
+			'-D' => $node->data_dir,
+			'postgres'
+		],
+		'<' => \$queries);
+
+	ok($result, $testname);
+}
+
+my $node = PostgreSQL::Test::Cluster->new('node');
+$node->init;
+
+test_single_mode(
+	$node, qq(
+CREATE TEMP TABLE temp_insert (a int);
+INSERT INTO temp_insert VALUES (1);
+),
+	"INSERT into temporary table");
+test_single_mode(
+	$node,
+	"CREATE TEMP TABLE temp_ctas AS SELECT 1 AS a;",
+	"CREATE TEMP TABLE AS");
+test_single_mode(
+	$node, qq(
+CREATE TEMP SEQUENCE temp_seq;
+SELECT nextval('temp_seq');
+),
+	"nextval() on temporary sequence");
+
+# A temporary table larger than temp_buffers, so as local buffers are
+# evicted, written and read back.
+test_single_mode(
+	$node, qq(
+SET temp_buffers = 100;
+CREATE TEMP TABLE temp_big AS SELECT g AS a, repeat('x', 100) AS b FROM generate_series(1, 20000) g;
+SELECT count(*) FROM temp_big;
+),
+	"temporary table larger than temp_buffers");
+
+# The IO done on temporary relations by the standalone backend is visible
+# once the server is started.
+$node->start;
+my $result = $node->safe_psql(
+	'postgres', qq(
+SELECT extends > 0, reads > 0, writes > 0, evictions > 0, hits > 0
+  FROM pg_stat_io
+  WHERE backend_type = 'standalone backend' AND
+    object = 'temp relation' AND context = 'normal'));
+is($result, 't|t|t|t|t',
+	"IO on temporary relations of standalone backend in pg_stat_io");
+$node->stop;
+
+done_testing();
diff --git a/src/test/regress/expected/stats.out b/src/test/regress/expected/stats.out
index 8b154712..b1935882 100644
--- a/src/test/regress/expected/stats.out
+++ b/src/test/regress/expected/stats.out
@@ -81,6 +81,7 @@ standalone backend|relation|bulkwrite
 standalone backend|relation|init
 standalone backend|relation|normal
 standalone backend|relation|vacuum
+standalone backend|temp relation|normal
 standalone backend|wal|init
 standalone backend|wal|normal
 startup|relation|bulkread
@@ -104,7 +105,7 @@ walsummarizer|wal|init
 walsummarizer|wal|normal
 walwriter|wal|init
 walwriter|wal|normal
-(88 rows)
+(89 rows)
 \a
 -- List of registered statistics kinds.
 SELECT id, name, fixed_amount,
-- 
2.56.1

