commit 7240af7e6b7168ff1ad1790c6537b29f93fb6891 Author: Ian Barwick Date: Tue Oct 6 21:40:37 2020 +0900 doc: clarify behaviour of pg_dump's -t/--table option The existing wording gives the impression it might be possible to dump the contents of views, which is not possible. Also, from PostgreSQL 13 it is possible to dump the contents of foreign tables, but this requires the --include-foreign-data option. diff --git a/doc/src/sgml/ref/pg_dump.sgml b/doc/src/sgml/ref/pg_dump.sgml index f99dc3f31e..4e2c80983e 100644 --- a/doc/src/sgml/ref/pg_dump.sgml +++ b/doc/src/sgml/ref/pg_dump.sgml @@ -517,9 +517,7 @@ PostgreSQL documentation Dump only tables with names matching - pattern. - For this purpose, table includes views, materialized views, - sequences, and foreign tables. Multiple tables + pattern. Multiple tables can be selected by writing multiple switches. The pattern parameter is interpreted as a pattern according to the same rules used by @@ -531,6 +529,14 @@ PostgreSQL documentation below. + + 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 + . + + The and switches have no effect when is used, because tables selected by will