Improve documentation for default_tablespace on partitioned tables

Backpatch to 12, where 87259588d0ab introduced the current behavior.

Per note from Justin Pryzby.

Co-authored-by: Justin Pryzby 
Discussion: https://postgr.es/m/20210416143135[email protected]

diff --git a/doc/src/sgml/config.sgml b/doc/src/sgml/config.sgml
index 28fd0670f763d385b9128d8289ea1dc4596fe439..136b51bf122d035108ae0d08a7a99eac6241c0e6 100644 (file)
--- a/doc/src/sgml/config.sgml
+++ b/doc/src/sgml/config.sgml
@@ -7937,8 +7937,7 @@ COPY postgres_log FROM '/full/path/to/logfile.csv' WITH csv;
        
         This variable specifies the default tablespace in which to create
         objects (tables and indexes) when a CREATE command does
-        not explicitly specify a tablespace.  It also determines the tablespace
-        that a partitioned relation will direct future partitions to.
+        not explicitly specify a tablespace.
        
 
        
@@ -7962,6 +7961,14 @@ COPY postgres_log FROM '/full/path/to/logfile.csv' WITH csv;
         the template database it is copied from.
        
 
+       
+        If this parameter is set to a value other than the empty string
+        when a partitioned table is created, the partitioned table's
+        tablespace will be set to that value, which will be used as
+        the default tablespace for partitions created in the future,
+        even if default_tablespace has changed since then.
+       
+
        
         For more information on tablespaces,
         see .