LOCKS

Monitors lock grants and requests for all nodes.

Monitors lock grants and requests for all nodes. A table call with no results indicates that no locks are in use.

Column Name Data Type Description
NODE_NAMES VARCHAR

Nodes on which lock interaction occurs.

Node Rollup:

NODE_NAMES are separated by commas. A transaction can have the same lock in the same mode in the same scope on multiple nodes. However, the transaction gets only one (1) line in the table.

OBJECT_NAME VARCHAR Name of object being locked; can be a table or an internal structure (projection, global catalog, or local catalog).
OBJECT_ID INTEGER Unique numeric ID assigned by the Vertica catalog that identifies the object being locked.
TRANSACTION_ID VARCHAR Identification of transaction within the session, if any; otherwise NULL. Useful for creating joins to other system tables.
TRANSACTION_DESCRIPTION VARCHAR Identification of transaction and associated description. Typically this query caused the transaction's creation.
LOCK_MODE VARCHAR Intended operation of the transaction. For a list of lock modes and compatibility, see Lock modes.
LOCK_SCOPE VARCHAR

Expected duration of the lock after it is granted. Before the lock is granted, Vertica lists the scope as REQUESTED.

Once a lock has been granted, the following scopes are possible:

  • STATEMENT_LOCALPLAN

  • STATEMENT_COMPILE

  • STATEMENT_EXECUTE

  • TRANSACTION_POSTCOMMIT

  • TRANSACTION

All scopes, other than TRANSACTION, are transient and are used only as part of normal query processing.

REQUEST_TIMESTAMP TIMESTAMP Time when the transaction began waiting on the lock.
GRANT_TIMESTAMP TIMESTAMP

Time the transaction acquired or upgraded the lock:

  • Return values are NULL until the grant occurs.

  • If the grant occurs immediately, values might be the same as REQUEST_TIMESTAMP.

See also