Recommend more clearly custom pg_dump format over tar, buy showing

custom format examples first.
This commit is contained in:
Bruce Momjian 2006-05-06 23:25:37 +00:00
parent bcf860b7f3
commit d9d2d91544
1 changed files with 17 additions and 17 deletions

View File

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/pg_dump.sgml,v 1.83 2006/04/15 18:11:16 momjian Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/pg_dump.sgml,v 1.84 2006/05/06 23:25:37 momjian Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -243,6 +243,19 @@ PostgreSQL documentation
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry>
<term><literal>c</></term>
<term><literal>custom</></term>
<listitem>
<para>
Output a custom archive suitable for input into
<application>pg_restore</application>. This is the most flexible
format in that it allows reordering of loading data as well
as object definitions. This format is also compressed by default.
</para>
</listitem>
</varlistentry>
<varlistentry> <varlistentry>
<term><literal>t</></term> <term><literal>t</></term>
<term><literal>tar</></term> <term><literal>tar</></term>
@ -257,19 +270,6 @@ PostgreSQL documentation
</listitem> </listitem>
</varlistentry> </varlistentry>
<varlistentry>
<term><literal>c</></term>
<term><literal>custom</></term>
<listitem>
<para>
Output a custom archive suitable for input into
<application>pg_restore</application>. This is the most flexible
format in that it allows reordering of loading data as well
as object definitions. This format is also compressed by default.
</para>
</listitem>
</varlistentry>
</variablelist> </variablelist>
</para> </para>
@ -665,11 +665,11 @@ CREATE DATABASE foo WITH TEMPLATE template0;
</para> </para>
<para> <para>
To dump a database called <literal>mydb</> to a <filename>tar</filename> To dump a database called <literal>mydb</> to a file in custom format:
file: file:
<screen> <screen>
<prompt>$</prompt> <userinput>pg_dump -Ft mydb &gt; db.tar</userinput> <prompt>$</prompt> <userinput>pg_dump -Fc mydb &gt; db.out</userinput>
</screen> </screen>
</para> </para>
@ -677,7 +677,7 @@ CREATE DATABASE foo WITH TEMPLATE template0;
To reload this dump into an existing database called <literal>newdb</>: To reload this dump into an existing database called <literal>newdb</>:
<screen> <screen>
<prompt>$</prompt> <userinput>pg_restore -d newdb db.tar</userinput> <prompt>$</prompt> <userinput>pg_restore -d newdb db.out</userinput>
</screen> </screen>
</para> </para>