doc: add example of using pg_dump with GNU split and gzip

This is only possible with GNU split, not other versions like BSD split.

Reported-by: jim@jdoherty.net

Discussion: https://postgr.es/m/162653459215.701.6323855956817776386@wrigleys.postgresql.org

Backpatch-through: 9.6
This commit is contained in:
Bruce Momjian 2021-08-03 10:57:32 -04:00
parent 8f7c8e2bef
commit cfbbb8610d
1 changed files with 11 additions and 2 deletions

View File

@ -273,10 +273,10 @@ cat <replaceable class="parameter">filename</replaceable>.gz | gunzip | psql <re
The <command>split</command> command The <command>split</command> command
allows you to split the output into smaller files that are allows you to split the output into smaller files that are
acceptable in size to the underlying file system. For example, to acceptable in size to the underlying file system. For example, to
make chunks of 1 megabyte: make 2 gigabyte chunks:
<programlisting> <programlisting>
pg_dump <replaceable class="parameter">dbname</replaceable> | split -b 1m - <replaceable class="parameter">filename</replaceable> pg_dump <replaceable class="parameter">dbname</replaceable> | split -b 2G - <replaceable class="parameter">filename</replaceable>
</programlisting> </programlisting>
Reload with: Reload with:
@ -284,6 +284,15 @@ pg_dump <replaceable class="parameter">dbname</replaceable> | split -b 1m - <rep
<programlisting> <programlisting>
cat <replaceable class="parameter">filename</replaceable>* | psql <replaceable class="parameter">dbname</replaceable> cat <replaceable class="parameter">filename</replaceable>* | psql <replaceable class="parameter">dbname</replaceable>
</programlisting> </programlisting>
If using GNU <application>split</application>, it is possible to
use it and <application>gzip</application> together:
<programlisting>
pg_dump <replaceable class="parameter">dbname</replaceable> | split -b 2G --filter='gzip > $FILE.gz'
</programlisting>
It can be restored using <command>zcat</command>.
</para> </para>
</formalpara> </formalpara>