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

Clarify documentation around pg_dump -t option

Browse Source 
The behavior is different for different types of objects, so make that
more clear.

Author: Ian Barwick
This commit is contained in:
Magnus Hagander 2020-10-06 15:46:36 +02:00
parent 5b36221c46
commit b8c4d38512
1 changed files with 9 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

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

@ -517,9 +517,7 @@ PostgreSQL documentation
<listitem> <listitem>
<para> <para>
Dump only tables with names matching Dump only tables with names matching
<replaceable class="parameter">pattern</replaceable>. <replaceable class="parameter">pattern</replaceable>. Multiple tables
For this purpose, <quote>table</quote> includes views, materialized views,
sequences, and foreign tables. Multiple tables
can be selected by writing multiple <option>-t</option> switches. The can be selected by writing multiple <option>-t</option> switches. The
<replaceable class="parameter">pattern</replaceable> parameter is <replaceable class="parameter">pattern</replaceable> parameter is
interpreted as a pattern according to the same rules used by interpreted as a pattern according to the same rules used by
@ -531,6 +529,14 @@ PostgreSQL documentation
<xref linkend="pg-dump-examples"/> below. <xref linkend="pg-dump-examples"/> below.
</para> </para>
<para>
As well as tables, this option can be used to dump views, materialized views,
foreign tables, and sequence definitions. However it will not dump the contents
of views or materialized views, and the contents of foreign tables will only be
dumped if the corresponding foreign server is specified with
<option>--include-foreign-data</option>.
</para>
<para> <para>
The <option>-n</option> and <option>-N</option> switches have no effect when The <option>-n</option> and <option>-N</option> switches have no effect when
<option>-t</option> is used, because tables selected by <option>-t</option> will <option>-t</option> is used, because tables selected by <option>-t</option> will