43.39. pg_locks

La vue pg_locks fournit un accès aux informations concernant les verrous détenus par les transactions ouvertes sur le serveur de bases de données. Voir le Chapitre 12, Contrôle d'accès simultané pour une discussion plus importante sur les verrous.

pg_locks contient une ligne par objet verrouillable actif, type de verrou demandé et transaction associée. Un même objet verrouillable peut apparaître plusieurs fois si plusieurs transactions ont posé ou attendent des verrous sur celui-ci. Toutefois, un objet qui n'est pas actuellement verrouillé n'apparaît pas.

Il existe plusieurs types distincts d'objets verrouillables : les relations complètes (tables, par exemple), les pages individuelles de relations, des tuples individuels de relations, les identifiants de transaction et les objets généraux de la base de données (identifiés par l'OID de la classe et l'OID de l'objet, de la même façon que dans pg_description ou pg_depend). De plus, le droit d'étendre une relation est représenté comme un objet verrouillable distinct.

Tableau 43.39. Colonnes pg_locks

Nom Type Références Description
locktype text   Type de l'objet verrouillable : relation, extend, page, tuple, transactionid, object, userlock ou advisory
database oid pg_database.oid L'OID de la base de données dans laquelle existe l'objet, 0 si l'objet est partagé ou NULL si l'objet est un identifiant de transaction
relation oid pg_class.oid L'OID de la relation ou NULL si l'objet n'est pas une relation ni une partie de relation
page integer   Le numéro de page à l'intérieur de cette relation ou NULL si l'objet n'est pas un tuple ou une page de relation
tuple smallint   Le numéro du tuple dans la page ou NULL si l'objet n'est pas un tuple
transactionid xid   L'identifiant d'une transaction ou NULL si l'objet n'est pas un identifiant de transaction
classid oid pg_class.oid L'OID du catalogue système contenant l'objet ou NULL si l'objet n'est pas un objet général de la base de données
objid oid any OID column L'OID de l'objet dans son catalogue système ou NULL si l'objet n'est pas un objet général de la base de données
objsubid smallint   Pour une colonne de table, c'est le numéro de la colonne (classid et objid font référence à la table elle-même). Pour tous les autres types d'objets, cette colonne vaut 0. NULL si l'objet n'est pas un objet général de la base de données.
transaction xid   L'ID de la transaction qui détient ou attend le verrou.
pid integer   L'identifiant du processus serveur détenant ou attendant le verrou. NULL si le verrou est possédé par une transaction préparée.
mode text   Nom du type de verrou détenu ou attendu par ce processus (voir la Section 12.3.1, « Verrous de niveau table »)
granted boolean   True si le verrou est détenu, false s'il est attendu

granted est true sur une ligne représentant un verrou tenu par la transaction indiquée. Une valeur false indique que cette transaction attend l'acquisition du verrou, ce qui implique qu'une autre transaction a choisi un mode de verrouillage conflictuel sur le même objet verrouillable. La transaction en attente dort jusqu'au relâchement du verrou (ou jusqu'à ce qu'une situation de blocage soit détectée). Une transaction unique peut attendre l'acquisition d'au plus un verrou à la fois.

Chaque transaction détient un verrou exclusif sur son identifiant de transaction pour toute sa durée. Si une transaction trouve nécessaire d'attendre spécifiquement une autre transaction, elle le fait en essayant d'acquérir un verrou partagé sur l'identifiant de l'autre transaction. Ceci n'est couronné de succès que lorsque l'autre transaction termine et relâche son verrou.

Bien que les lignes constituent un type d'objet verrouillable, les informations sur les verroux de niveau ligne sont stockées sur disque, et non en mémoire. Ainsi, les verroux de niveau ligne n'apparaissent normalement pas dans cette vue. Si une transaction attend un verrou de niveau ligne, elle apparaît sur la vue comme en attente de l'identifiant de la transaction actuellement détentrice de ce verrou de niveau ligne.

Les verrous consultatifs peuvent être acquis par des clés constituées soit d'une seule valeur bigint soit de deux valeurs integer. Une clé bigint est affichée avec sa moitié haute dans la colonne classid, sa partie basse dans la colonne objid et objsubid à 1. Les clés integer sont affichées avec la première clé dans la colonne classid, la deuxième clé dans la colonne objid et objsubid à 2. La signification réelle des clés est laissée à l'utilisateur. Les verrous consultatifs sont locaux à chaque base, la colonne database a donc un sens dans ce cas.

Lorsque la vue pg_locks est accédée, les structures de données du gestionnaire interne de verrous sont momentanément verrouillées et une copie est faite pour que la vue s'affiche. Ceci assure que la vue produit un ensemble consistant de résultats, tout en ne bloquant pas les opérations habituelles du gestionnaire de verrous plus longuement que nécessaire. Toutefois, si la vue est accédée trop fréquemment, cela peut avoir un impact sur les performances de la base de données.

pg_locks fournit une vue globale de tous les verrous du cluster, pas seulement de ceux de la base en cours d'utilisation. Bien que la colonne relation puisse être jointe avec pg_class.oid pour identifier les relations verrouillées, ceci ne fonctionne correctement qu'avec les relations de la base accédée (celles pour lesquelles la colonne database est l'OID de la base actuelle ou 0).

Si le collecteur de statistiques est activé, la colonne pid peut être jointe à la colonne procpid de la vue pg_stat_activity pour obtenir plus d'informations sur la session détenant ou attendant de détenir le verrou. De plus, si des transactions préparées sont utilisées, la colonne transaction peut être jointe à la colonne transaction de la vue pg_prepared_xacts pour obtenir plus d'informations sur les transactions préparées qui détiennent des verroux. (Une transaction préparée ne peut jamais être en attente d'un verrou mais elle continue à détenir les verroux qu'elle a acquis pendant son exécution.)