mirror of
https://git.postgresql.org/git/postgresql.git
synced 2024-09-10 05:59:23 +02:00
145 lines
4.0 KiB
Plaintext
145 lines
4.0 KiB
Plaintext
<!-- doc/src/sgml/pgrowlocks.sgml -->
|
|
|
|
<sect1 id="pgrowlocks" xreflabel="pgrowlocks">
|
|
<title>pgrowlocks</title>
|
|
|
|
<indexterm zone="pgrowlocks">
|
|
<primary>pgrowlocks</primary>
|
|
</indexterm>
|
|
|
|
<para>
|
|
The <filename>pgrowlocks</filename> module provides a function to show row
|
|
locking information for a specified table.
|
|
</para>
|
|
|
|
<sect2>
|
|
<title>Overview</title>
|
|
|
|
<indexterm>
|
|
<primary>pgrowlocks</primary>
|
|
</indexterm>
|
|
|
|
<synopsis>
|
|
pgrowlocks(text) returns setof record
|
|
</synopsis>
|
|
|
|
<para>
|
|
The parameter is the name of a table. The result is a set of records,
|
|
with one row for each locked row within the table. The output columns
|
|
are shown in <xref linkend="pgrowlocks-columns">.
|
|
</para>
|
|
|
|
<table id="pgrowlocks-columns">
|
|
<title><function>pgrowlocks</> Output Columns</title>
|
|
|
|
<tgroup cols="3">
|
|
<thead>
|
|
<row>
|
|
<entry>Name</entry>
|
|
<entry>Type</entry>
|
|
<entry>Description</entry>
|
|
</row>
|
|
</thead>
|
|
<tbody>
|
|
|
|
<row>
|
|
<entry><structfield>locked_row</structfield></entry>
|
|
<entry><type>tid</type></entry>
|
|
<entry>Tuple ID (TID) of locked row</entry>
|
|
</row>
|
|
<row>
|
|
<entry><structfield>locker</structfield></entry>
|
|
<entry><type>xid</type></entry>
|
|
<entry>Transaction ID of locker, or multixact ID if multitransaction</entry>
|
|
</row>
|
|
<row>
|
|
<entry><structfield>multi</structfield></entry>
|
|
<entry><type>boolean</type></entry>
|
|
<entry>True if locker is a multitransaction</entry>
|
|
</row>
|
|
<row>
|
|
<entry><structfield>xids</structfield></entry>
|
|
<entry><type>xid[]</type></entry>
|
|
<entry>Transaction IDs of lockers (more than one if multitransaction)</entry>
|
|
</row>
|
|
<row>
|
|
<entry><structfield>lock_type</structfield></entry>
|
|
<entry><type>text[]</type></entry>
|
|
<entry>Lock mode of lockers (more than one if multitransaction),
|
|
an array of <literal>Key Share</>, <literal>Share</>,
|
|
<literal>For No Key Update</>, <literal>No Key Update</>,
|
|
<literal>For Update</>, <literal>Update</>.</entry>
|
|
</row>
|
|
|
|
<row>
|
|
<entry><structfield>pids</structfield></entry>
|
|
<entry><type>integer[]</type></entry>
|
|
<entry>Process IDs of locking backends (more than one if multitransaction)</entry>
|
|
</row>
|
|
|
|
</tbody>
|
|
</tgroup>
|
|
</table>
|
|
|
|
<para>
|
|
<function>pgrowlocks</function> takes <literal>AccessShareLock</> for the
|
|
target table and reads each row one by one to collect the row locking
|
|
information. This is not very speedy for a large table. Note that:
|
|
</para>
|
|
|
|
<orderedlist>
|
|
<listitem>
|
|
<para>
|
|
If the table as a whole is exclusive-locked by someone else,
|
|
<function>pgrowlocks</function> will be blocked.
|
|
</para>
|
|
</listitem>
|
|
<listitem>
|
|
<para>
|
|
<function>pgrowlocks</function> is not guaranteed to produce a
|
|
self-consistent snapshot. It is possible that a new row lock is taken,
|
|
or an old lock is freed, during its execution.
|
|
</para>
|
|
</listitem>
|
|
</orderedlist>
|
|
|
|
<para>
|
|
<function>pgrowlocks</function> does not show the contents of locked
|
|
rows. If you want to take a look at the row contents at the same time, you
|
|
could do something like this:
|
|
|
|
<programlisting>
|
|
SELECT * FROM accounts AS a, pgrowlocks('accounts') AS p
|
|
WHERE p.locked_row = a.ctid;
|
|
</programlisting>
|
|
|
|
Be aware however that (as of <productname>PostgreSQL</> 8.3) such a
|
|
query will be very inefficient.
|
|
</para>
|
|
</sect2>
|
|
|
|
<sect2>
|
|
<title>Sample Output</title>
|
|
|
|
<screen>
|
|
test=# SELECT * FROM pgrowlocks('t1');
|
|
locked_row | lock_type | locker | multi | xids | pids
|
|
------------+-----------+--------+-------+-----------+---------------
|
|
(0,1) | Shared | 19 | t | {804,805} | {29066,29068}
|
|
(0,2) | Shared | 19 | t | {804,805} | {29066,29068}
|
|
(0,3) | Exclusive | 804 | f | {804} | {29066}
|
|
(0,4) | Exclusive | 804 | f | {804} | {29066}
|
|
(4 rows)
|
|
</screen>
|
|
</sect2>
|
|
|
|
<sect2>
|
|
<title>Author</title>
|
|
|
|
<para>
|
|
Tatsuo Ishii
|
|
</para>
|
|
</sect2>
|
|
|
|
</sect1>
|