Re: docs: warn about post-data-only schema dumps with parallel restore. - Mailing list pgsql-hackers

From David G. Johnston
Subject Re: docs: warn about post-data-only schema dumps with parallel restore.
Date
Msg-id CAKFQuwY_zOFGucP-x=hiPzG0KO0ngTN6aRGP9mp=LoYUw82iuQ@mail.gmail.com
Whole thread
In response to Re: docs: warn about post-data-only schema dumps with parallel restore.  (Tom Lane <tgl@sss.pgh.pa.us>)
Responses Re: docs: warn about post-data-only schema dumps with parallel restore.
List pgsql-hackers
On Tuesday, March 31, 2026, Tom Lane <tgl@sss.pgh.pa.us> wrote:
"David G. Johnston" <david.g.johnston@gmail.com> writes:
> On Tuesday, March 31, 2026, Tom Lane <tgl@sss.pgh.pa.us> wrote:
>> Hmm, I think we could be a bit more definite than that.  What do you
>> think of this advice:
>>
>> <para>
>> When creating an archive (non-text) output file, it is advisable not to
>> restrict the set of database objects dumped, but instead plan to apply
>> any desired object filtering when reading the archive
>> with <application>pg_restore</application>.  This will preserve
>> flexibility and possibly avoid problems at restore time; for details
>> see the <xref linkend="app-pgrestore"/> documentation.  However,
>> omitting table data (<option>--no-data</option>) or large objects
>> (<option>--no-large-objects</option>) does not have any surprising
>> consequences.
>> </para>

> I’m against including that final sentence.  The rest seems ok but I’
> suggest going with an explicit mention that “—no-schema is risky” (or
> otherwise omitting the entire section)

How about replacing that sentence with "In particular, dumping table
data without the corresponding table definition (via --no-schema and
related options) is not recommended."


That should work.

David J.
 

pgsql-hackers by date:

Previous
From: Corey Huinker
Date:
Subject: Re: CAST(... ON DEFAULT) - WIP build on top of Error-Safe User Functions
Next
From: Andres Freund
Date:
Subject: Re: index prefetching