Обсуждение: clarification for pg_basebackup and major versions

Поиск
Список
Период
Сортировка

clarification for pg_basebackup and major versions

От
PG Doc comments form
Дата:
The following documentation comment has been logged on the website:

Page: https://www.postgresql.org/docs/18/app-pgbasebackup.html
Description:

Hi, Team !

Could we pls. clarify the following statement on the documentation page
https://www.postgresql.org/docs/18/app-pgbasebackup.html:
'pg_basebackup works with servers of the same or older major version, down
to 9.1.'

What does it exactly mean 'works with servers of the same or older major
version' ?

Most probably it means the possibility to use pg_basebackup binary of
version PG 17 to take backup of PG 14 server. Or something else ?

But it's definitely not ability to use pg_basebackup for PostgreSQL major
version upgrade, since pg_basebackup is not listed among the supported
options in https://www.postgresql.org/docs/18/upgrading.html

So, pls. let me propose two things:
- to clarify how pg_basebackup works with servers of the same or older major
version
- to clearly specify pg_basebackup cannot be used for PostgreSQL major
version upgrade

It could be done on the same page
https://www.postgresql.org/docs/18/app-pgbasebackup.html

Thanks !

best regards
Alexey Shishkin

Re: clarification for pg_basebackup and major versions

От
"David G. Johnston"
Дата:


On Monday, December 29, 2025, PG Doc comments form <noreply@postgresql.org> wrote:

- to clarify how pg_basebackup works with servers of the same or older major
version

There is no “how”, it just does.  The documentation is versioned and “it” means the binary produced by that version.
 
- to clearly specify pg_basebackup cannot be used for PostgreSQL major
version upgrade

The page clearly states what a backup can be used for and upgrade is not listed.

David J.