doc: Improve consistency of parallel vacuum description.

Use consistent phrasing for parallel vacuum descriptions between
manual VACUUM and autovacuum. Specifically, clarify that the parallel
worker count is limited by the respective options only if they are
explicitly specified.

Also, fix a typo in the parallel vacuum section.

Author: Aleksander Alekseev <aleksander@tigerdata.com>
Discussion: https://postgr.es/m/CAJ7c6TPcSqzhbhrsiCMmVwmE8F7pwS7i9J49SP1zPKS_ER+vcA@mail.gmail.com
This commit is contained in:
Masahiko Sawada 2026-04-10 10:59:24 -07:00
parent de74d1e9a5
commit 2a3d2f9f68

View file

@ -1186,15 +1186,15 @@ analyze threshold = analyze base threshold + analyze scale factor * number of tu
vacuum phase, please refer to <xref linkend="vacuum-phases"/>). The
degree of parallelism is determined by the number of indexes on the
relation that support parallel vacuum. For manual <command>VACUUM</command>,
this is limited by the <literal>PARALLEL</literal> option, which is
further capped by <xref linkend="guc-max-parallel-maintenance-workers"/>.
this is limited by the <literal>PARALLEL</literal> option if specified,
which is further capped by <xref linkend="guc-max-parallel-maintenance-workers"/>.
For autovacuum, it is limited by the table's
<xref linkend="reloption-autovacuum-parallel-workers"/> if any which is
capped limited by
<xref linkend="guc-autovacuum-max-parallel-workers"/> parameter. Please
note that it is not guaranteed that the number of parallel workers that was
calculated will be used during execution. It is possible for a vacuum to
run with fewer workers than specified, or even with no workers at all.
<xref linkend="reloption-autovacuum-parallel-workers"/> if specified,
which is further capped by <xref linkend="guc-autovacuum-max-parallel-workers"/>
parameter. Please note that it is not guaranteed that the number of parallel
workers that was calculated will be used during execution. It is possible for
a vacuum to run with fewer workers than specified, or even with no workers at
all.
</para>
<para>