Commit b8c4d385 authored by Magnus Hagander's avatar Magnus Hagander

Clarify documentation around pg_dump -t option

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

Author: Ian Barwick
parent 5b36221c
...@@ -517,9 +517,7 @@ PostgreSQL documentation ...@@ -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 ...@@ -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
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment