Location via proxy:   [ UP ]  
[Report a bug]   [Manage cookies]                
Skip to content

Commit 8875a16

Browse files
committed
Mention that pg_dump does not dump ALTER DATABASE ... SET commands;
backpatch to 8.3.X. Also fix markup that had just one bullet.
1 parent edb6a4c commit 8875a16

File tree

1 file changed

+16
-22
lines changed

1 file changed

+16
-22
lines changed

doc/src/sgml/ref/pg_dump.sgml

+16-22
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<!--
2-
$PostgreSQL: pgsql/doc/src/sgml/ref/pg_dump.sgml,v 1.103 2008/07/20 18:43:30 tgl Exp $
2+
$PostgreSQL: pgsql/doc/src/sgml/ref/pg_dump.sgml,v 1.104 2008/08/21 22:25:44 momjian Exp $
33
PostgreSQL documentation
44
-->
55

@@ -754,22 +754,13 @@ CREATE DATABASE foo WITH TEMPLATE template0;
754754
</para>
755755

756756
<para>
757-
<application>pg_dump</application> has a few limitations:
758-
759-
<itemizedlist>
760-
<listitem>
761-
<para>
762-
When a data-only dump is chosen and the option
763-
<option>--disable-triggers</> is used,
764-
<application>pg_dump</application> emits commands to disable
765-
triggers on user tables before inserting the data and commands
766-
to re-enable them after the data has been inserted. If the
767-
restore is stopped in the middle, the system catalogs might be
768-
left in the wrong state.
769-
</para>
770-
</listitem>
771-
772-
</itemizedlist>
757+
<application>pg_dump</application> has a limitation; when a
758+
data-only dump is chosen and the option <option>--disable-triggers</>
759+
is used, <application>pg_dump</application> emits commands
760+
to disable triggers on user tables before inserting the data
761+
and commands to re-enable them after the data has been
762+
inserted. If the restore is stopped in the middle, the system
763+
catalogs might be left in the wrong state.
773764
</para>
774765

775766
<para>
@@ -782,11 +773,14 @@ CREATE DATABASE foo WITH TEMPLATE template0;
782773
</para>
783774

784775
<para>
785-
The dump file produced by <application>pg_dump</application> does
786-
not contain the statistics used by the optimizer to make query
787-
planning decisions. Therefore, it is wise to run
788-
<command>ANALYZE</command> after restoring from a dump file to
789-
ensure good performance.
776+
The dump file produced by <application>pg_dump</application>
777+
does not contain the statistics used by the optimizer to make
778+
query planning decisions. Therefore, it is wise to run
779+
<command>ANALYZE</command> after restoring from a dump file
780+
to ensure good performance. The dump file also does not
781+
contain any <command>ALTER DATABASE ... SET</> commands;
782+
these settings are dumped by <xref linkend="app-pg-dumpall">,
783+
along with database users and other installation-wide settings.
790784
</para>
791785

792786
<para>

0 commit comments

Comments
 (0)