Re: Documentation clarification request: pg_dumpall and Large Objects - Mailing list pgsql-docs

From Laurenz Albe
Subject Re: Documentation clarification request: pg_dumpall and Large Objects
Date
Msg-id ae61f593b83ef62e5737c205a04498ea281b8a02.camel@cybertec.at
Whole thread Raw
In response to Re: Documentation clarification request: pg_dumpall and Large Objects  (Laurenz Albe <laurenz.albe@cybertec.at>)
Responses Re: Documentation clarification request: pg_dumpall and Large Objects
List pgsql-docs
On Thu, 2025-12-04 at 19:11 +0100, Laurenz Albe wrote:
> On Thu, 2025-12-04 at 18:12 +0100, Radoulov, Dimitre wrote:
> > Il Gio 4 Dic 2025, 16:50 Laurenz Albe <laurenz.albe@cybertec.at> ha scritto:
> > > On Thu, 2025-12-04 at 13:12 +0100, Radoulov, Dimitre wrote:
> > > > I would like to request a clarification in the pg_dumpall
> > > > documentation regarding Large Objects (LOBs). The current
> > > > documentation does not explicitly state whether pg_dumpall includes
> > > > Large Objects in its output.
> > >
> > > I admit that you have to go by circumstantial evidence here.  But rather
> > > than explicitly naming large objects, perhaps it would be useful to add something
> > > like
> > >
> > >   pg_dumpall is primarily intended as a tool to upgrade database clusters.
> > >   As such, it by default exports all data of the entire cluster.
> > >   The only part of the state of a database cluster that is *not* included
> > >   in the output of pg_dumpall are the configuration files and database parameters
> > >   changed with ALTER SYSTEM.
>
> Attached is a patch for such a change.

Commit 763aaa06f0 has changed the situation: with the addition of other formats
than the plain format, it no longer makes sense to say that pg_dumpall
is not useful for backup.  Still, we should clarify what is *not* included.

The attached patch does that and in passing improves the readability.

Yours,
Laurenz Albe

Attachment

pgsql-docs by date:

Previous
From: "David G. Johnston"
Date:
Subject: Re: A suggestion about the usage manual of \d command
Next
From: yuanchao zhang
Date:
Subject: Re: A suggestion about the usage manual of \d command