Doc: improve documentation about run-time pruning's effects on EXPLAIN.

Tatsuo Ishii complained that this para wasn't very intelligible.
Try to make it better.

Discussion: https://postgr.es/m/20191207.200500.989741087350666720.t-ishii@sraoss.co.jp
This commit is contained in:
Tom Lane 2019-12-08 10:36:29 -05:00
parent e75b1e3371
commit a395e21e98
1 changed files with 10 additions and 9 deletions

View File

@ -896,15 +896,16 @@ EXPLAIN ANALYZE SELECT * FROM tenk1 WHERE unique1 < 100 AND unique2 > 9000
</para> </para>
<para> <para>
Generally, the <command>EXPLAIN</command> output will display details for Normally, <command>EXPLAIN</command> will display every plan node
every plan node which was generated by the query planner. However, there created by the planner. However, there are cases where the executor
are cases where the executor is able to determine that certain nodes are can determine that certain nodes need not be executed because they
not required; currently, the only node types to support this are the cannot produce any rows, based on parameter values that were not
<literal>Append</literal> and <literal>MergeAppend</literal> nodes. These available at planning time. (Currently this can only happen for child
node types have the ability to discard subnodes which they are able to nodes of an Append or MergeAppend node that is scanning a partitioned
determine won't contain any records required by the query. It is possible table.) When this happens, those plan nodes are omitted from
to determine that nodes have been removed in this way by the presence of a the <command>EXPLAIN</command> output and a <literal>Subplans
"Subplans Removed" property in the <command>EXPLAIN</command> output. Removed: <replaceable>N</replaceable></literal> annotation appears
instead.
</para> </para>
</sect2> </sect2>