diff --git a/doc/src/sgml/ref/pg_dump.sgml b/doc/src/sgml/ref/pg_dump.sgml index 7f538e90194..ae1bc14d2f2 100644 --- a/doc/src/sgml/ref/pg_dump.sgml +++ b/doc/src/sgml/ref/pg_dump.sgml @@ -1687,6 +1687,18 @@ CREATE DATABASE foo WITH TEMPLATE template0; catalogs might be left in the wrong state. + + 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 pg_restore. This will preserve + flexibility and possibly avoid problems at restore time; for details + see the documentation. + In particular, dumping table data without the corresponding table + definition (via and related options) is + not recommended. + + When is specified, pg_dump will include most optimizer statistics in the diff --git a/doc/src/sgml/ref/pg_restore.sgml b/doc/src/sgml/ref/pg_restore.sgml index 9d91c365214..6ae2cdcfc10 100644 --- a/doc/src/sgml/ref/pg_restore.sgml +++ b/doc/src/sgml/ref/pg_restore.sgml @@ -1215,6 +1215,22 @@ CREATE DATABASE foo WITH TEMPLATE template0; + + + Parallel restore ( greater than 1) requires + applying dependency information from the archive file to ensure + that an object is not restored before other objects it depends on. + This information will be incomplete, leading to unexpected restore + failures, if the archive does not include object definitions + (the section). Therefore, avoid + using pg_dump options such + as , , + or without when + creating an archive you wish to restore in parallel. Instead, you + may provide such options to pg_restore. + + + pg_restore cannot restore large objects selectively; for instance, only those for a specific table. If @@ -1224,14 +1240,6 @@ CREATE DATABASE foo WITH TEMPLATE template0; - - - When restoring from a non-plain-text archive made using - pg_dumpall, the - option may be used, but must include . - - - The following options cannot be used when restoring from a non-plain-text @@ -1242,6 +1250,8 @@ CREATE DATABASE foo WITH TEMPLATE template0; , , and . + Also, if the option is used, it must + include .