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

doc: Mention all options equivalent to pg_dump --filter patterns.

Browse Source 
In the documentation for pg_dump's new --filter option, added by
commit a5cf808be5, each object pattern should match some other
existing pg_dump option, but some had been omitted, so add them.

Noted by Daniel Gustafsson, reviewed by Ayush Vatsa.

Discussion: https://postgr.es/m/CAEZATCWtVUt51B6BjTUQoS4dcNyOBj%2B04ngL7HSH3ehBXTUt%3Dw%40mail.gmail.com
This commit is contained in:
Dean Rasheed 2024-06-10 14:55:41 +01:00
parent 3cb19f45a3
commit c50d4f4028
1 changed files with 21 additions and 16 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

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

@ -866,13 +866,14 @@ PostgreSQL documentation
same rules as the corresponding options: same rules as the corresponding options:
<option>-t</option>/<option>--table</option>, <option>-t</option>/<option>--table</option>,
<option>--table-and-children</option>, <option>--table-and-children</option>,
<option>--exclude-table-and-children</option> or <option>-T</option>/<option>--exclude-table</option>, and
<option>-T</option> for tables, <option>--exclude-table-and-children</option> for tables,
<option>-n</option>/<option>--schema</option> for schemas, <option>-n</option>/<option>--schema</option> and
<option>-N</option>/<option>--exclude-schema</option> for schemas,
<option>--include-foreign-data</option> for data on foreign servers, <option>--include-foreign-data</option> for data on foreign servers,
<option>--exclude-table-data</option>, <option>--exclude-table-data</option> and
<option>--exclude-table-data-and-children</option> for table data, and <option>--exclude-table-data-and-children</option> for table data, and
<option>-e</option>/<option>--extension</option> or <option>-e</option>/<option>--extension</option> and
<option>--exclude-extension</option> for extensions. <option>--exclude-extension</option> for extensions.
To read from <literal>STDIN</literal>, use <filename>-</filename> as the To read from <literal>STDIN</literal>, use <filename>-</filename> as the
filename. The <option>--filter</option> option can be specified in filename. The <option>--filter</option> option can be specified in
@ -895,34 +896,37 @@ PostgreSQL documentation
<itemizedlist> <itemizedlist>
<listitem> <listitem>
<para> <para>
<literal>extension</literal>: extensions, works like the <literal>extension</literal>: extensions. This works like the
<option>-e</option>/<option>--extension</option> option. <option>-e</option>/<option>--extension</option> or
<option>--exclude-extension</option> option.
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
<literal>foreign_data</literal>: data on foreign servers, works like <literal>foreign_data</literal>: data on foreign servers. This works like
the <option>--include-foreign-data</option> option. This keyword can the <option>--include-foreign-data</option> option. This keyword can
only be used with the <literal>include</literal> keyword. only be used with the <literal>include</literal> keyword.
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
<literal>table</literal>: tables, works like the <literal>table</literal>: tables. This works like the
<option>-t</option>/<option>--table</option> option. <option>-t</option>/<option>--table</option> or
<option>-T</option>/<option>--exclude-table</option> option.
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
<literal>table_and_children</literal>: tables including any partitions <literal>table_and_children</literal>: tables including any partitions
or inheritance child tables, works like the or inheritance child tables. This works like the
<option>--table-and-children</option> option. <option>--table-and-children</option> or
<option>--exclude-table-and-children</option> option.
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
<literal>table_data</literal>: table data of any tables matching <literal>table_data</literal>: table data of any tables matching
<replaceable>pattern</replaceable>, works like the <replaceable>pattern</replaceable>. This works like the
<option>--exclude-table-data</option> option. This keyword can only <option>--exclude-table-data</option> option. This keyword can only
be used with the <literal>exclude</literal> keyword. be used with the <literal>exclude</literal> keyword.
</para> </para>
@ -931,15 +935,16 @@ PostgreSQL documentation
<para> <para>
<literal>table_data_and_children</literal>: table data of any tables <literal>table_data_and_children</literal>: table data of any tables
matching <replaceable>pattern</replaceable> as well as any partitions matching <replaceable>pattern</replaceable> as well as any partitions
or inheritance children of the table(s), works like the or inheritance children of the table(s). This works like the
<option>--exclude-table-data-and-children</option> option. This <option>--exclude-table-data-and-children</option> option. This
keyword can only be used with the <literal>exclude</literal> keyword. keyword can only be used with the <literal>exclude</literal> keyword.
</para> </para>
</listitem> </listitem>
<listitem> <listitem>
<para> <para>
<literal>schema</literal>: schemas, works like the <literal>schema</literal>: schemas. This works like the
<option>-n</option>/<option>--schema</option> option. <option>-n</option>/<option>--schema</option> or
<option>-N</option>/<option>--exclude-schema</option> option.
</para> </para>
</listitem> </listitem>
</itemizedlist> </itemizedlist>