database/postgres
1
0
Fork 0
mirror of https://github.com/postgres/postgres.git synced 2025-07-27 12:41:57 +03:00
Code Activity

Add contrib/amcheck debug message.

Browse Source 
Add a DEBUG1 message indicating that verification of the index structure
is underway.  Also reduce the severity level of the existing "tree
level" debug message to DEBUG1.  It should never have been made DEBUG2.
Any B-Tree index with more than a couple of levels will generally also
have so many pages that the per-page DEBUG2 messages will become
completely unmanageable.

In passing, add a new "Tip" to the docs that advises users that run into
corruption that the debug messages might provide useful additional
context.
This commit is contained in:
Peter Geoghegan
2020-04-10 17:44:08 -07:00
parent f333d35428
commit 20fbb711ef
2 changed files with 29 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

21
doc/src/sgml/amcheck.sgml
View File

@ -166,6 +166,27 @@ ORDER BY c.relpages DESC LIMIT 10;
</listitem>
</varlistentry>
</variablelist>
<tip>
<para>
<function>bt_index_parent_check</function> and
<function>bt_index_parent_check</function> both output log
messages about the verification process at
<literal>DEBUG1</literal> and <literal>DEBUG2</literal> severity
levels. These messages provide detailed information about the
verification process that may be of interest to
<productname>PostgreSQL</productname> developers. Advanced users
may also find this information helpful, since it provides
additional context should verification actually detect an
inconsistency. Running:
<programlisting>
SET client_min_messages = DEBUG1;
</programlisting>
in an interactive <application>psql</application> session before
running a verification query will display messages about the
progress of verification with a manageable level of detail.
</para>
</tip>
</sect2>
<sect2>