MySQL - Distributed GET_LOCK

Distributed global locking using mysql get_lock(), ensures releasing orphaned lock.


Eliminate SPOF of background jobs or scheduled/cron job


A process that allowed to run only once on a given time however the process is deployed on multiple hosts as part of different micro-services, ie. scheduled jobs


Tries to obtain a lock with a name given by the string str, using a timeout of timeout seconds. A negative timeout value means infinite timeout. The lock is exclusive. While held by one session, other sessions cannot obtain a lock of the same name.

Returns 1 if the lock was obtained successfully, 0 if the attempt timed out (for example, because another client has previously locked the name), or NULL if an error occurred (such as running out of memory or the thread was killed with mysqladmin kill).

A lock obtained with GET_LOCK() is released explicitly by executing RELEASE_LOCK() or implicitly when your session terminates (either normally or abnormally). Locks obtained with GET_LOCK() are not released when transactions commit or roll back.

Sample Java snippets

import java.sql.DriverManager;
import java.sql.Connection;
import java.sql.PreparedStatement;
import java.sql.ResultSet;
import java.sql.SQLException;
Connection connection = DriverManager.getConnection("jdbc:mysql://localhost/" + dbName, "root", "");
PreparedStatement sth = connection.prepareStatement("SELECT GET_LOCK(?, ?)")
sth.setString(1, "distributed_lock");
sth.setInt(2, 2);

ResultSet resultSet = sth.executeQuery();;
Integer status = resultSet.getInt(1);

if (resultSet.wasNull()) {
   throw new Exception("Can not obtain lock");
if (status == 0) {
  throw new Exception("Already locked `distributed_lock`");
if (status == 1) {
    //successfully get lock.. do something here ...

Reference – MySQL GET_LOCK