On Tue, Nov 18, 2025 at 3:20 PM Nathan Bossart <[email protected]> wrote:
>
> On Tue, Nov 11, 2025 at 12:48:39PM -0600, Nathan Bossart wrote:
> > I think maintenance.sgml needs an update (specifically, the part about the
> > insert threshold [0]).
>
> Here is a first try.
Thanks for catching this!
@@ -934,12 +934,16 @@ vacuum threshold = Minimum(vacuum max threshold,
vacuum base threshold + vacuum
The table is also vacuumed if the number of tuples inserted since the last
vacuum has exceeded the defined insert threshold, which is defined as:
<programlisting>
-vacuum insert threshold = vacuum base insert threshold + vacuum
insert scale factor * number of tuples
+vacuum insert threshold = vacuum base insert threshold + vacuum
insert scale factor * number of tuples * percent of table not frozen
I wish we could say "* number of unfrozen tuples". I know that's not
true because we don't know how many tuples are on each page, but the
formula feels a little overly detailed this way. Anyway, this is fine.
I didn't apply and render the whole thing, but the wording looks good
to me.
It's actually interesting that we calculate the thresholds in tuples
when vacuum operates per page. And the per tuple costs are not really
as big of a deal as the per page costs.
- Melanie
