Doc: add information about partition locking
authorDavid Rowley <[email protected]>
Wed, 2 Apr 2025 01:03:48 +0000 (14:03 +1300)
committerDavid Rowley <[email protected]>
Wed, 2 Apr 2025 01:03:48 +0000 (14:03 +1300)
The documentation around locking of partitions for the executor startup
phase of run-time partition pruning wasn't clear about which partitions
were being locked.  Fix that.

Reviewed-by: Tender Wang <[email protected]>
Discussion: https://postgr.es/m/CAApHDvp738G75HfkKcfXaf3a8s%3D6mmtOLh46tMD0D2hAo1UCzA%40mail.gmail.com
Backpatch-through: 13

doc/src/sgml/ddl.sgml

index c150dd217f9e2cee4c29881f3d50164ce6b97b95..bef1275871198177f533ec7930ba789fe72b9bd8 100644 (file)
@@ -4986,7 +4986,9 @@ EXPLAIN SELECT count(*) FROM measurement WHERE logdate &gt;= DATE '2008-01-01';
        It is possible to determine the number of partitions which were
        removed during this phase by observing the
        <quote>Subplans Removed</quote> property in the
-       <command>EXPLAIN</command> output.
+       <command>EXPLAIN</command> output.  It's important to note that any
+       partitions removed by the partition pruning done at this stage are
+       still locked at the beginning of execution.
       </para>
      </listitem>