Re: [PATCH] Doc: clarify that pg_upgrade statistics transfer works cross-version

From: Laurenz Albe <laurenz(dot)albe(at)cybertec(dot)at>
To: Bruce Momjian <bruce(at)momjian(dot)us>, Nikolay Samokhvalov <nik(at)postgres(dot)ai>
Cc: pgsql-docs(at)lists(dot)postgresql(dot)org
Subject: Re: [PATCH] Doc: clarify that pg_upgrade statistics transfer works cross-version
Date: 2026-03-24 16:53:27
Message-ID: 48ad7007c0bbca725847473fe410cdda5753c65d.camel@cybertec.at
Views: Whole Thread | Raw Message | Download mbox | Resend email
Thread:
Lists: 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(dot)albe(at)cybertec(dot)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

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Bruce Momjian 2026-03-24 18:11:54 Re: [PATCH] Doc: clarify that pg_upgrade statistics transfer works cross-version
Previous Message Bruce Momjian 2026-03-24 15:04:38 Re: [PATCH] Doc: clarify that pg_upgrade statistics transfer works cross-version