From 5ba40b62318e4d941497333b72d589420a48d82f Mon Sep 17 00:00:00 2001 From: Michael Paquier Date: Thu, 23 Jan 2020 17:01:46 +0900 Subject: [PATCH] Doc: Fix and tweak documentation for ANALYZE reporting The docs had some typos and grammar mistakes, and its indentation was inconsistent. Author: Amit Langote, Justin Pryzby Discussion: https://postgr.es/m/20200116151930.GM26045@telsasoft.com --- doc/src/sgml/monitoring.sgml | 106 ++++++++++++++++++----------------- 1 file changed, 54 insertions(+), 52 deletions(-) diff --git a/doc/src/sgml/monitoring.sgml b/doc/src/sgml/monitoring.sgml index 0bfd6151c4..8839699079 100644 --- a/doc/src/sgml/monitoring.sgml +++ b/doc/src/sgml/monitoring.sgml @@ -3571,51 +3571,53 @@ SELECT pg_stat_get_backend_pid(s.backendid) AS pid, sample_blks_total bigint - Total number of heap blocks that will be sampled. + Total number of heap blocks that will be sampled. sample_blks_scanned bigint - Number of heap blocks scanned. + Number of heap blocks scanned. ext_stats_total bigint - Number of extended statistics. + Number of extended statistics. ext_stats_computed bigint - Number of computed extended statistics computed. This counter only advances when - the phase is computing extended statistics. + Number of extended statistics computed. This counter only advances + when the phase is computing extended statistics. child_tables_total bigint - Number of child tables. + Number of child tables. child_tables_done bigint - Number of child tables scanned. This counter only advances when the phase - is acquiring inherited sample rows. + Number of child tables scanned. This counter only advances when the + phase is acquiring inherited sample rows. current_child_table_relid oid - OID of the child table currently being scanned. This field is only valid when - the phase is computing extended statistics. + + OID of the child table currently being scanned. This field is + only valid when the phase is + acquiring inherited sample rows. @@ -3626,58 +3628,58 @@ SELECT pg_stat_get_backend_pid(s.backendid) AS pid, ANALYZE phases - + Phase Description - - - initializing - + + + initializing + The command is preparing to begin scanning the heap. This phase is expected to be very brief. - - - - acquiring sample rows - + + + + acquiring sample rows + The command is currently scanning the table given by - current_relid to obtain sample rows. - - - - acquiring inherited sample rows - - The command is currently scanning child tables to obtain sample rows. Columns - child_tables_total, + relid to obtain sample rows. + + + + acquiring inherited sample rows + + The command is currently scanning child tables to obtain sample rows. + Columns child_tables_total, child_tables_done, and - current_child_table_relid contain the progress - information for this phase. - - - - computing statistics - - The command is computing statistics from the samples rows obtained during - the table scan. - - - - computing extended statistics - - The command is computing extended statistics from the samples rows obtained - durring the table scan. - - - - finalizing analyze - + current_child_table_relid contain the + progress information for this phase. + + + + computing statistics + + The command is computing statistics from the sample rows obtained + during the table scan. + + + + computing extended statistics + + The command is computing extended statistics from the sample rows + obtained during the table scan. + + + + finalizing analyze + The command is updating pg_class. When this phase is completed, ANALYZE will end. - - - + + +