Re: [PATCH] Doc: clarify that pg_upgrade statistics transfer works cross-version - Mailing list pgsql-docs

From Laurenz Albe
Subject Re: [PATCH] Doc: clarify that pg_upgrade statistics transfer works cross-version
Date
Msg-id 48ad7007c0bbca725847473fe410cdda5753c65d.camel@cybertec.at
Whole thread Raw
In response to Re: [PATCH] Doc: clarify that pg_upgrade statistics transfer works cross-version  (Bruce Momjian <bruce@momjian.us>)
Responses Re: [PATCH] Doc: clarify that pg_upgrade statistics transfer works cross-version
List pgsql-docs
On Tue, 2026-03-24 at 11:04 -0400, Bruce Momjian wrote:
> On Tue, Mar 24, 2026 at 05:36:42AM -0700, Nikolay Samokhvalov wrote:
> > On Mon, Mar 23, 2026 at 23:59 Laurenz Albe <laurenz.albe@cybertec.at> wrote:
> > How about adding a simple remark, like
> >
> > --- a/doc/src/sgml/ref/pgupgrade.sgml
> > +++ b/doc/src/sgml/ref/pgupgrade.sgml
> > +     Transferring optimizer statistics works regardless of the old cluster's
> > +     major version.
> >
> > That would work too -- my goal was just to resolve confusion.
>
> I was under the same impression --- that it only worked with upgrades
> _from_ PG 18 and later.  However, I can't find any documentation on this
> limitation, so why did so many think this was true?  I don't think
> adding anything to the docs is the right approach.

Bruce, you are confusing me.  Your first sentence suggests that you
(erroneously) thought that upgrading statistics only works when upgrading
*from* v18 or better.  But your last sentence suggests that you'd rather
not add anything to the documentation that could dispel that misconception.

Why?

Yours,
Laurenz Albe



pgsql-docs by date:

Previous
From: Bruce Momjian
Date:
Subject: Re: [PATCH] Doc: clarify that pg_upgrade statistics transfer works cross-version
Next
From: Bruce Momjian
Date:
Subject: Re: [PATCH] Doc: clarify that pg_upgrade statistics transfer works cross-version