F.39. pgrowlocks
Модуль pgrowlocks предоставляет функцию, показывающую информацию о блокировке строк для заданной таблицы.
По умолчанию его использование разрешено суперпользователям, членам роли pg_stat_scan_tables и пользователям с правом SELECT в заданной таблице.
F.39.1. Обзор
pgrowlocks(text) returns setof record
В параметре передаётся имя таблицы. В результате возвращается набор записей, в котором строка соответствует строке, заблокированной в таблице. Столбцы результата показаны в Таблице F.103.
Таблица F.103. Столбцы результата pgrowlocks
| Name | Тип | Описание |
|---|---|---|
locked_row | tid | Идентификатор кортежа (TID) блокированной строки |
locker | xid | Идентификатор блокирующей транзакции или идентификатор мультитранзакции, если это мультитранзакция |
multi | boolean | True, если блокирующий субъект — мультитранзакция |
xids | xid[] | Идентификаторы блокирующих транзакций (больше одной для мультитранзакции) |
modes | text[] | Режим блокирования (больше одного для мультитранзакции), массив со значениями Key Share, Share, For No Key Update, No Key Update, For Update, Update. |
pids | integer[] | Идентификаторы блокирующих обслуживающих процессов (больше одного для мультитранзакции) |
Функция pgrowlocks запрашивает блокировку AccessShareLock для целевой таблицы и считывает строку за строкой для сбора информации о блокировке строк. Это происходит небыстро для большой таблицы. Заметьте, что:
Если таблица заблокирована в режиме
ACCESS EXCLUSIVE, функцияpgrowlocksбудет блокироваться.Функция
pgrowlocksне гарантирует внутреннюю согласованность результатов. В ходе её выполнения могут быть установлены новые блокировки строк, либо освобождены старые.
Функция pgrowlocks не показывает содержимое заблокированных строк. Если вы хотите параллельно взглянуть на содержимое строк, можно проделать примерно следующее:
SELECT * FROM accounts AS a, pgrowlocks('accounts') AS p
WHERE p.locked_row = a.ctid;Однако учтите, что такой запрос будет очень неэффективным.
F.39.2. Пример вывода
=# SELECT * FROM pgrowlocks('t1');
locked_row | locker | multi | xids | modes | pids
------------+--------+-------+-------+----------------+--------
(0,1) | 609 | f | {609} | {"For Share"} | {3161}
(0,2) | 609 | f | {609} | {"For Share"} | {3161}
(0,3) | 607 | f | {607} | {"For Update"} | {3107}
(0,4) | 607 | f | {607} | {"For Update"} | {3107}
(4 rows)F.39.3. Автор
Тацуо Исии (Tatsuo Ishii)