Document the way partition MERGE/SPLIT operations create new partitions

Reported-by: Justin Pryzby
Discussion: https://postgr.es/m/ZilrByTp-pbz6Mvf%40pryzbyj2023
Reviewed-by: Justin Pryzby

diff --git a/doc/src/sgml/ref/alter_table.sgml b/doc/src/sgml/ref/alter_table.sgml
index fe36ff82e527f6c5b3a2ba407f1f989bbc6882a3..fc2dfffe49f6f8bdafecac55c276dd538f2eaff1 100644 (file)
--- a/doc/src/sgml/ref/alter_table.sgml
+++ b/doc/src/sgml/ref/alter_table.sgml
@@ -1153,6 +1153,12 @@ WITH ( MODULUS numeric_literal, REM
       splitting we have a partition with the same name).
       Only simple, non-partitioned partition can be split.
      
+     
+      The new partitions will be created the same as tables created with the
+      SQL command CREATE TABLE partition_nameN (LIKE name INCLUDING ALL EXCLUDING INDEXES EXCLUDING IDENTITY).
+      The indexes and identity are created later, after moving the data
+      into the new partitions.
+     
      
       
        This command acquires an ACCESS EXCLUSIVE lock.
@@ -1213,6 +1219,12 @@ WITH ( MODULUS numeric_literal, REM
       can have the same name as one of the merged partitions.  Only simple,
       non-partitioned partitions can be merged.
      
+     
+      The new partition will be created the same as a table created with the
+      SQL command CREATE TABLE partition_name (LIKE name INCLUDING ALL EXCLUDING INDEXES EXCLUDING IDENTITY).
+      The indexes and identity are created later, after moving the data
+      into the new partition.
+     
      
       
        This command acquires an ACCESS EXCLUSIVE lock.