From e032752680193a26e21c3927968f72bed20db99e Mon Sep 17 00:00:00 2001 From: test Date: Sun, 3 May 2026 16:05:54 +0200 Subject: [PATCH] Improve docs for EXPLAIN (IO) Commit 681daed931 introduced a new EXPLAIN options "IO", but the docs did not explain what information is added to the output. Expand the description a little bit, similarly to the other EXPLAIN options. While at it, fix a typo in the first sentence. Reported-by: FIXME link to the typo report Author: Tomas Vondra --- doc/src/sgml/ref/explain.sgml | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/doc/src/sgml/ref/explain.sgml b/doc/src/sgml/ref/explain.sgml index e95e19081e1..d0644bca038 100644 --- a/doc/src/sgml/ref/explain.sgml +++ b/doc/src/sgml/ref/explain.sgml @@ -303,7 +303,13 @@ ROLLBACK; IO - Include information on I/O performed by scan nodes proving such information. + Include information on I/O performed by scan nodes providing such + information. + Specifically, include information about the prefetch queue (the average + and maximum distance, and the capacity), and information about issued + I/O requests (number of requests and an average request size, number of + I/O waits, and an average number of concurrent I/O requests). + In text format, only non-zero values are printed. This parameter may only be used when ANALYZE is also enabled. It defaults to FALSE. -- 2.54.0