mirror of
https://github.com/postgres/postgres.git
synced 2025-10-25 13:17:41 +03:00
6d376c3b0d
This commit introduces a new GUC, log_lock_failure, which controls whether a detailed log message is produced when a lock acquisition fails. Currently, it only supports logging lock failures caused by SELECT ... NOWAIT. The log message includes information about all processes holding or waiting for the lock that couldn't be acquired, helping users analyze and diagnose the causes of lock failures. Currently, this option does not log failures from SELECT ... SKIP LOCKED, as that could generate excessive log messages if many locks are skipped, causing unnecessary noise. This mechanism can be extended in the future to support for logging lock failures from other commands, such as LOCK TABLE ... NOWAIT. Author: Yuki Seino <seinoyu@oss.nttdata.com> Co-authored-by: Fujii Masao <masao.fujii@gmail.com> Reviewed-by: Jelte Fennema-Nio <postgres@jeltef.nl> Discussion: https://postgr.es/m/411280a186cc26ef7034e0f2dfe54131@oss.nttdata.com
128 lines
5.1 KiB
C
128 lines
5.1 KiB
C
/*-------------------------------------------------------------------------
|
|
*
|
|
* lmgr.h
|
|
* POSTGRES lock manager definitions.
|
|
*
|
|
*
|
|
* Portions Copyright (c) 1996-2025, PostgreSQL Global Development Group
|
|
* Portions Copyright (c) 1994, Regents of the University of California
|
|
*
|
|
* src/include/storage/lmgr.h
|
|
*
|
|
*-------------------------------------------------------------------------
|
|
*/
|
|
#ifndef LMGR_H
|
|
#define LMGR_H
|
|
|
|
#include "lib/stringinfo.h"
|
|
#include "storage/itemptr.h"
|
|
#include "storage/lock.h"
|
|
#include "utils/rel.h"
|
|
|
|
|
|
/* XactLockTableWait operations */
|
|
typedef enum XLTW_Oper
|
|
{
|
|
XLTW_None,
|
|
XLTW_Update,
|
|
XLTW_Delete,
|
|
XLTW_Lock,
|
|
XLTW_LockUpdated,
|
|
XLTW_InsertIndex,
|
|
XLTW_InsertIndexUnique,
|
|
XLTW_FetchUpdated,
|
|
XLTW_RecheckExclusionConstr,
|
|
} XLTW_Oper;
|
|
|
|
extern void RelationInitLockInfo(Relation relation);
|
|
|
|
/* Lock a relation */
|
|
extern void LockRelationOid(Oid relid, LOCKMODE lockmode);
|
|
extern void LockRelationId(LockRelId *relid, LOCKMODE lockmode);
|
|
extern bool ConditionalLockRelationOid(Oid relid, LOCKMODE lockmode);
|
|
extern void UnlockRelationId(LockRelId *relid, LOCKMODE lockmode);
|
|
extern void UnlockRelationOid(Oid relid, LOCKMODE lockmode);
|
|
|
|
extern void LockRelation(Relation relation, LOCKMODE lockmode);
|
|
extern bool ConditionalLockRelation(Relation relation, LOCKMODE lockmode);
|
|
extern void UnlockRelation(Relation relation, LOCKMODE lockmode);
|
|
extern bool CheckRelationLockedByMe(Relation relation, LOCKMODE lockmode,
|
|
bool orstronger);
|
|
extern bool CheckRelationOidLockedByMe(Oid relid, LOCKMODE lockmode,
|
|
bool orstronger);
|
|
extern bool LockHasWaitersRelation(Relation relation, LOCKMODE lockmode);
|
|
|
|
extern void LockRelationIdForSession(LockRelId *relid, LOCKMODE lockmode);
|
|
extern void UnlockRelationIdForSession(LockRelId *relid, LOCKMODE lockmode);
|
|
|
|
/* Lock a relation for extension */
|
|
extern void LockRelationForExtension(Relation relation, LOCKMODE lockmode);
|
|
extern void UnlockRelationForExtension(Relation relation, LOCKMODE lockmode);
|
|
extern bool ConditionalLockRelationForExtension(Relation relation,
|
|
LOCKMODE lockmode);
|
|
extern int RelationExtensionLockWaiterCount(Relation relation);
|
|
|
|
/* Lock to recompute pg_database.datfrozenxid in the current database */
|
|
extern void LockDatabaseFrozenIds(LOCKMODE lockmode);
|
|
|
|
/* Lock a page (currently only used within indexes) */
|
|
extern void LockPage(Relation relation, BlockNumber blkno, LOCKMODE lockmode);
|
|
extern bool ConditionalLockPage(Relation relation, BlockNumber blkno, LOCKMODE lockmode);
|
|
extern void UnlockPage(Relation relation, BlockNumber blkno, LOCKMODE lockmode);
|
|
|
|
/* Lock a tuple (see heap_lock_tuple before assuming you understand this) */
|
|
extern void LockTuple(Relation relation, ItemPointer tid, LOCKMODE lockmode);
|
|
extern bool ConditionalLockTuple(Relation relation, ItemPointer tid,
|
|
LOCKMODE lockmode, bool logLockFailure);
|
|
extern void UnlockTuple(Relation relation, ItemPointer tid, LOCKMODE lockmode);
|
|
|
|
/* Lock an XID (used to wait for a transaction to finish) */
|
|
extern void XactLockTableInsert(TransactionId xid);
|
|
extern void XactLockTableDelete(TransactionId xid);
|
|
extern void XactLockTableWait(TransactionId xid, Relation rel,
|
|
ItemPointer ctid, XLTW_Oper oper);
|
|
extern bool ConditionalXactLockTableWait(TransactionId xid,
|
|
bool logLockFailure);
|
|
|
|
/* Lock VXIDs, specified by conflicting locktags */
|
|
extern void WaitForLockers(LOCKTAG heaplocktag, LOCKMODE lockmode, bool progress);
|
|
extern void WaitForLockersMultiple(List *locktags, LOCKMODE lockmode, bool progress);
|
|
|
|
/* Lock an XID for tuple insertion (used to wait for an insertion to finish) */
|
|
extern uint32 SpeculativeInsertionLockAcquire(TransactionId xid);
|
|
extern void SpeculativeInsertionLockRelease(TransactionId xid);
|
|
extern void SpeculativeInsertionWait(TransactionId xid, uint32 token);
|
|
|
|
/* Lock a general object (other than a relation) of the current database */
|
|
extern void LockDatabaseObject(Oid classid, Oid objid, uint16 objsubid,
|
|
LOCKMODE lockmode);
|
|
extern bool ConditionalLockDatabaseObject(Oid classid, Oid objid,
|
|
uint16 objsubid, LOCKMODE lockmode);
|
|
extern void UnlockDatabaseObject(Oid classid, Oid objid, uint16 objsubid,
|
|
LOCKMODE lockmode);
|
|
|
|
/* Lock a shared-across-databases object (other than a relation) */
|
|
extern void LockSharedObject(Oid classid, Oid objid, uint16 objsubid,
|
|
LOCKMODE lockmode);
|
|
extern bool ConditionalLockSharedObject(Oid classid, Oid objid, uint16 objsubid,
|
|
LOCKMODE lockmode);
|
|
extern void UnlockSharedObject(Oid classid, Oid objid, uint16 objsubid,
|
|
LOCKMODE lockmode);
|
|
|
|
extern void LockSharedObjectForSession(Oid classid, Oid objid, uint16 objsubid,
|
|
LOCKMODE lockmode);
|
|
extern void UnlockSharedObjectForSession(Oid classid, Oid objid, uint16 objsubid,
|
|
LOCKMODE lockmode);
|
|
|
|
extern void LockApplyTransactionForSession(Oid suboid, TransactionId xid, uint16 objid,
|
|
LOCKMODE lockmode);
|
|
extern void UnlockApplyTransactionForSession(Oid suboid, TransactionId xid, uint16 objid,
|
|
LOCKMODE lockmode);
|
|
|
|
/* Describe a locktag for error messages */
|
|
extern void DescribeLockTag(StringInfo buf, const LOCKTAG *tag);
|
|
|
|
extern const char *GetLockNameFromTagType(uint16 locktag_type);
|
|
|
|
#endif /* LMGR_H */
|