Can vertica doc team document the mechanics of lock timeouts ?

To clarify, what i am asking is to explain how lock timeouts work. The LockTimeout parameter in our cluster is set to 800, but the dc_lock_attempts table shows 3 different values for timeout_in_seconds : 8, 800 , 1800.
This information would be useful when troubleshooting lock timeout, and it is information an administrator would need to know. Based on conversation with support in the past , I know that certain timeout in dc_errors are benign because there are multiple attempts to get a table lock.
Thank you.


  • Options

    Colin, I have created a Jira for the documentation team to fix this. Thanks for your feedback. - Sarah

  • Options
    Jim_KnicelyJim_Knicely - Select Field - Administrator
    edited January 2018


    The dc_lock_attempts data collector table contains a history of lock attempts (resolved requests). Note the key words "resolved requests" in the description.

    The time out of 800 you see is probably your DB's current value of the LockTimeout config param:

    select current_value, default_value, description from configuration_parameters where parameter_name = 'LockTimeout';

    That param controls lock timeout for Tables and Projections.

    The 1800 time out is for the system locks (Global Catalog [Meta-data global across all nodes], Local Catalog [Meta-data local to a node] and Cluster Topology)

    Fyi ...

    Global Catalog Locks - For the catalog that is global across all nodes, a GCL (X) lock is taken in scenarios including:

    • DDL Commit
    • DML Commit
    • Refresh
    • Recovery
    • Segment Balancing
    • Inviting a node to join the cluster

    Local Catalog Locks - Only taken in X mode in scenarios including the following:

    • DML and DDL
    • Moveout
    • Mergeout

    Elastic Cluster Locks - Needed for scaling the cluster up or down to meet the needs of the database:

    • Needs segments to be balanced
    • EC lock (X) taken on a node while doing segment balancing
    • Only one node is doing segment balancing at a time.

    Finally, the 8 second time out is most likely for O locks on tables where you are modifying them (i.e. adding or dropping columns).

  • Options

    This is good ! Thanks for taking the time to write it Jim. I am sure other folks would benefit as well when they search for this type of info.

Leave a Comment

BoldItalicStrikethroughOrdered listUnordered list
Align leftAlign centerAlign rightToggle HTML viewToggle full pageToggle lights
Drop image/file