Documentation for vacuum_cost config options.

Jan

diff --git a/doc/src/sgml/runtime.sgml b/doc/src/sgml/runtime.sgml
index 71d7f0621c8dc75343faad5a1c53ce039d037129..67e8931273a87564d21e0c50c7e1c1283bfbc2e8 100644 (file)
--- a/doc/src/sgml/runtime.sgml
+++ b/doc/src/sgml/runtime.sgml
@@ -1,5 +1,5 @@
 <!--
-$PostgreSQL: pgsql/doc/src/sgml/runtime.sgml,v 1.236 2004/02/03 17:34:02 tgl Exp $
+$PostgreSQL: pgsql/doc/src/sgml/runtime.sgml,v 1.237 2004/02/13 12:25:09 wieck Exp $
 -->
 
 <Chapter Id="runtime">
@@ -990,6 +990,87 @@ SET ENABLE_SEQSCAN TO OFF;
 
      </variablelist>
     </sect3>
+
+    <sect3 id="runtime-config-resource-vacuum-cost">
+     <title>Cost Based Vacuum Delay</title>
+
+     <variablelist>
+     <varlistentry>
+      <term><varname>vacuum_cost_page_hit</varname> (<type>integer</type>)</term>
+      <listitem>
+       <para>
+               During a default <command>VACUUM</command> (not
+               <command>FULL</command>) the system maintains and internal counter
+               accumulating the cost of various operations performed. When the
+               accumulated cost reaches a limit, the backend performing the
+               <command>VACUUM</command> will sleep for a while, reset the
+               accumulator and continue. The intention is to lower the IO impact
+               of <command>VACUUM</command>.
+          </para>
+
+          <para>
+               The variable <varname>vacuum_cost_page_hit</varname> is the cost
+               for vacuuming a buffer found inside the shared buffer cache. 
+               It represents the cost to lock the buffer pool, lookup the 
+               shared hash table and to actually scan the block content.
+       </para>
+      </listitem>
+     </varlistentry>
+
+     <varlistentry>
+      <term><varname>vacuum_cost_page_miss</varname> (<type>integer</type>)</term>
+      <listitem>
+       <para>
+               The cost for vacuuming a buffer that has to be read from disk.
+               This represents the effort to lock the buffer pool, lookup the
+               cache directory, reading the block from disk and scanning the
+               content.
+       </para>
+      </listitem>
+     </varlistentry>
+
+     <varlistentry>
+      <term><varname>vacuum_cost_page_dirty</varname> (<type>integer</type>)</term>
+      <listitem>
+       <para>
+               This extra cost is added when vacuum modifies a block that was
+               clean before. It represents the extra IO required to flush the
+               dirty block out to disk again.
+       </para>
+      </listitem>
+     </varlistentry>
+
+     <varlistentry>
+      <term><varname>vacuum_cost_limit</varname> (<type>integer</type>)</term>
+      <listitem>
+       <para>
+           This is the cost limit that must be reached or exceeded before
+               the <command>VACUUM</command> will nap.
+       </para>
+      </listitem>
+     </varlistentry>
+
+     <varlistentry>
+      <term><varname>vacuum_cost_naptime</varname> (<type>integer</type>)</term>
+      <listitem>
+       <para>
+               The time im milliseconds the <command>VACUUM</command> will
+               nap when the cost limit has been reached or exceeded.
+               There are certain bulk operations that hold critical
+               locks and should therefore perform
+               as quickly as possible. Because of that it is possible that the
+               cost actually accumulates far higher than this limit. To compensate
+               for this, the final naptime is calculated as
+               <varname>vacuum_cost_naptime</varname> * 
+               <varname>accumulated_balance</varname> /
+               <varname>vacuum_cost_limit</varname> with a maximum of
+               <varname>vacuum_cost_naptime</varname> * 4.
+       </para>
+      </listitem>
+     </varlistentry>
+
+     </variablelist>
+    </sect3>
    </sect2>
 
    <sect2 id="runtime-config-wal">