Обсуждение: request clarification on pg_restore documentation

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

request clarification on pg_restore documentation

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

Page: https://www.postgresql.org/docs/14/app-pgrestore.html
Description:

pg_restore seems to have two ways to restore data:

--section=data 

or

 --data-only

There is this cryptic warning that --data-only is "similar to but for
historical reasons different from" --section=data

But there is no further explanation of what those differences are or what
might be missed or different in your restore if you pick one option or the
other. Maybe one or the other option is the "preferred current way" and one
is the "historical way" or they are aimed at different types of use cases,
but that's not clear.

Re: request clarification on pg_restore documentation

От
Bruce Momjian
Дата:
Thread moved to hackers.

---------------------------------------------------------------------------

On Thu, Sep 29, 2022 at 02:30:13PM +0000, PG Doc comments form wrote:
> The following documentation comment has been logged on the website:
> 
> Page: https://www.postgresql.org/docs/14/app-pgrestore.html
> Description:
> 
> pg_restore seems to have two ways to restore data:
> 
> --section=data 
> 
> or
> 
>  --data-only
> 
> There is this cryptic warning that --data-only is "similar to but for
> historical reasons different from" --section=data
> 
> But there is no further explanation of what those differences are or what
> might be missed or different in your restore if you pick one option or the
> other. Maybe one or the other option is the "preferred current way" and one
> is the "historical way" or they are aimed at different types of use cases,
> but that's not clear.


-- 
  Bruce Momjian  <bruce@momjian.us>        https://momjian.us
  EDB                                      https://enterprisedb.com

  Indecision is a decision.  Inaction is an action.  Mark Batterson