Content-Type: text/plain; charset="utf-8"
MIME-Version: 1.0
Content-Transfer-Encoding: quoted-printable
Subject: BUG #19529: Documentation appears inconsistent with pg_dump
 --statistics behavior for CREATE STATISTICS objects
To: pgsql-bugs@lists.postgresql.org
From: PG Bug reporting form <noreply@postgresql.org>
Cc: igi@sraoss.co.jp
Reply-To: igi@sraoss.co.jp, pgsql-bugs@lists.postgresql.org
Date: Fri, 19 Jun 2026 07:17:44 +0000
Message-ID: <19529-c7eb1e7a0b07eae6@postgresql.org>
Auto-Submitted: auto-generated
Archived-At: 
 <https://www.postgresql.org/message-id/19529-c7eb1e7a0b07eae6%40postgresql.org>
Precedence: bulk

The following bug has been logged on the website:

Bug reference:      19529
Logged by:          Igi Izumi
Email address:      igi@sraoss.co.jp
PostgreSQL version: 19beta1
Operating system:   Rocky Linux 10.2 x86_64
Description:       =20

The PostgreSQL 19 pg_dump documentation currently states:
"When --statistics is specified, pg_dump will include most optimizer
statistics in the resulting dump file. This does not include all statistics,
such as those created explicitly with CREATE STATISTICS, custom statistics
added by an extension, or statistics collected by the cumulative statistics
system. Therefore, it may still be useful to run ANALYZE after restoring
from a dump file to ensure optimal performance; see Section 24.1.3 and
Section 24.1.6 for more information."
https://www.postgresql.org/docs/19/app-pgdump.html

However, PostgreSQL 19 introduced support for restoring extended statistics
with pg_restore_extended_stats(), and the following commits appear to add
support for dumping and restoring CREATE STATISTICS data:

=E3=83=BBInclude extended statistics data in pg_dump
https://git.postgresql.org/gitweb/?p=3Dpostgresql.git;a=3Dcommitdiff;h=3Dc3=
2fb29e9

=E3=83=BBAdd pg_restore_extended_stats()
https://git.postgresql.org/gitweb/?p=3Dpostgresql.git;a=3Dcommitdiff;h=3D0e=
80f3f88

Because of these changes, it appears that statistics created explicitly with
CREATE STATISTICS are now handled by pg_dump --statistics, while the
PostgreSQL 19 documentation still states that they are not included.

Could you please confirm whether the documentation is correct, or whether
this is a documentation bug?