doc: Update pg_dump/dumpall/upgrade about handling of external statistics

The pages of pg_dump, pg_dumpall and pg_upgrade mentioned that their
--no-statistics and --statistics options did not include the handling of
statistics created by CREATE STATISTICS, which was wrong.

Oversight in c32fb29e97.

Reported-by: Igi Izumi <igi@sraoss.co.jp>
Discussion: https://postgr.es/m/19529-c7eb1e7a0b07eae6@postgresql.org
This commit is contained in:
Michael Paquier 2026-06-23 08:20:11 +09:00
parent ef01ca6dbc
commit f0a4f280b4
3 changed files with 1 additions and 4 deletions

View file

@ -1703,7 +1703,6 @@ CREATE DATABASE foo WITH TEMPLATE template0;
When <option>--statistics</option> is specified,
<command>pg_dump</command> will include most optimizer statistics in the
resulting dump file. This does not include all statistics, such as
those created explicitly with <xref linkend="sql-createstatistics"/>,
custom statistics added by an extension, or statistics collected by the
cumulative statistics system. Therefore, it may still be useful to
run <command>ANALYZE</command> after restoring from a dump file to ensure

View file

@ -893,7 +893,6 @@ exclude database <replaceable class="parameter">PATTERN</replaceable>
When <option>--statistics</option> is specified,
<command>pg_dumpall</command> will include most optimizer statistics in the
resulting dump file. This does not include all statistics, such as
those created explicitly with <xref linkend="sql-createstatistics"/>,
custom statistics added by an extension, or statistics collected by the
cumulative statistics system. Therefore, it may still be useful to
run <command>ANALYZE</command> on each database after restoring from a dump

View file

@ -834,8 +834,7 @@ psql --username=postgres --file=script.sql postgres
Unless the <option>--no-statistics</option> option is specified,
<command>pg_upgrade</command> will transfer most optimizer statistics
from the old cluster to the new cluster. This does not transfer
all statistics, such as those created explicitly with
<xref linkend="sql-createstatistics"/>, custom statistics added by
all statistics, such as custom statistics added by
an extension, or statistics collected by the cumulative statistics system.
</para>