mirrors/postgres
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Clarify statements about tar archive format.

Browse Source
This commit is contained in:
Tom Lane 2010-02-23 17:28:09 +00:00
parent 8a12aac32b
commit 1bc8acca25
1 changed files with 16 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

28
doc/src/sgml/ref/pg_dump.sgml
View File

@ -1,5 +1,5 @@
<!-- <!--
$PostgreSQL: pgsql/doc/src/sgml/ref/pg_dump.sgml,v 1.116 2010/02/19 14:36:45 momjian Exp $ $PostgreSQL: pgsql/doc/src/sgml/ref/pg_dump.sgml,v 1.117 2010/02/23 17:28:09 tgl Exp $
PostgreSQL documentation PostgreSQL documentation
--> -->
@ -77,8 +77,8 @@ PostgreSQL documentation
the <quote>custom</quote> format (<option>-Fc</option>). It allows the <quote>custom</quote> format (<option>-Fc</option>). It allows
for selection and reordering of all archived items, and is compressed for selection and reordering of all archived items, and is compressed
by default. The <application>tar</application> format by default. The <application>tar</application> format
(<option>-Ft</option>) is not compressed and it is not possible to (<option>-Ft</option>) is not compressed and has restrictions on
reorder data when loading, but it is otherwise quite flexible; reordering data when loading, but it is otherwise quite flexible;
moreover, it can be manipulated with standard Unix tools such as moreover, it can be manipulated with standard Unix tools such as
<command>tar</command>. <command>tar</command>.
</para> </para>
@ -224,10 +224,11 @@ PostgreSQL documentation
<term><literal>custom</></term> <term><literal>custom</></term>
<listitem> <listitem>
<para> <para>
Output a custom archive suitable for input into Output a custom-format archive suitable for input into
<application>pg_restore</application>. This is the most flexible <application>pg_restore</application>.
format in that it allows reordering of loading data as well This is the most flexible output format in that it allows manual
as object definitions. This format is also compressed by default. selection and reordering of archived items during restore.
This format is also compressed by default.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>
@ -237,11 +238,14 @@ PostgreSQL documentation
<term><literal>tar</></term> <term><literal>tar</></term>
<listitem> <listitem>
<para> <para>
Output a <command>tar</command> archive suitable for input into Output a <command>tar</command>-format archive suitable for input
<application>pg_restore</application>. Using this archive format into <application>pg_restore</application>.
allows reordering and/or exclusion of database objects This output format allows manual selection and reordering of
at the time the database is restored. It is also possible to limit archived items during restore, but there is a restriction: the
which data is reloaded at restore time. relative order of table data items cannot be changed during
restore. Also, <command>tar</command> format does not support
compression and has a limit of 8 GB on the size of individual
tables.
</para> </para>
</listitem> </listitem>
</varlistentry> </varlistentry>