无需安装第 5.5.6.1.1 节“锁定服务 C 接口” 中描述的锁定服务例程 ，因为它们内置于服务器中。对于映射到对服务例程的调用的可加载函数，情况并非如此：这些函数必须在使用前安装。本节描述如何做到这一点。有关可加载函数安装的一般信息，请参阅 第 5.6.1 节，“安装和卸载可加载函数”。

锁定服务功能在位于 plugin_dir系统变量命名的目录中的插件库文件中实现。文件基名是locking_service. 文件名后缀因平台而异（例如， .so对于 Unix 和类 Unix 系统， .dll对于 Windows）。

要安装锁定服务功能，请使用 CREATE FUNCTION语句，.so根据需要调整平台的后缀：

CREATE FUNCTION service_get_read_locks RETURNS INT
  SONAME 'locking_service.so';
CREATE FUNCTION service_get_write_locks RETURNS INT
  SONAME 'locking_service.so';
CREATE FUNCTION service_release_locks RETURNS INT
  SONAME 'locking_service.so';

如果在复制源服务器上使用这些功能，请将它们也安装在所有副本服务器上以避免复制问题。

安装后，这些功能将保持安装状态，直到卸载为止。要删除它们，请使用以下 DROP FUNCTION语句：

DROP FUNCTION service_get_read_locks;
DROP FUNCTION service_get_write_locks;
DROP FUNCTION service_release_locks;

在使用锁定服务功能之前，请按照 安装或卸载锁定服务功能界面中的说明进行安装。

要获取一个或多个读锁，请调用此函数：

mysql> SELECT service_get_read_locks('mynamespace', 'rlock1', 'rlock2', 10);
+---------------------------------------------------------------+
| service_get_read_locks('mynamespace', 'rlock1', 'rlock2', 10) |
+---------------------------------------------------------------+
|                                                             1 |
+---------------------------------------------------------------+

第一个参数是锁命名空间。最后一个参数是一个整数超时，指示在放弃之前等待获取锁的秒数。中间的参数是锁名。

对于刚刚显示的示例，该函数获取具有锁标识符(mynamespace, rlock1) 和的锁(mynamespace, rlock2)。

要获取写锁而不是读锁，请调用此函数：

mysql> SELECT service_get_write_locks('mynamespace', 'wlock1', 'wlock2', 10);
+----------------------------------------------------------------+
| service_get_write_locks('mynamespace', 'wlock1', 'wlock2', 10) |
+----------------------------------------------------------------+
|                                                              1 |
+----------------------------------------------------------------+

在这种情况下，锁标识符是 (mynamespace, wlock1)和 (mynamespace, wlock2)。

要释放命名空间的所有锁，请使用此函数：

mysql> SELECT service_release_locks('mynamespace');
+--------------------------------------+
| service_release_locks('mynamespace') |
+--------------------------------------+
|                                    1 |
+--------------------------------------+

每个锁定函数返回非零表示成功。如果函数失败，则会发生错误。例如，由于锁名不能为空，会出现如下错误：

mysql> SELECT service_get_read_locks('mynamespace', '', 10);
ERROR 3131 (42000): Incorrect locking service lock name ''.

一个会话可以为同一个锁标识符获取多个锁。只要不同的会话没有标识符的写锁，该会话就可以获取任意数量的读锁或写锁。标识符的每个锁定请求都会获取一个新锁定。以下语句获取具有相同标识符的三个写锁，然后为相同标识符获取三个读锁：

SELECT service_get_write_locks('ns', 'lock1', 'lock1', 'lock1', 0);
SELECT service_get_read_locks('ns', 'lock1', 'lock1', 'lock1', 0);

如果 metadata_locks此时检查 Performance Schema 表，您会发现该会话持有六个具有相同 (ns, lock1)标识符的不同锁。（详见 锁定服务监控。）

因为该会话在 上持有至少一个写锁 (ns, lock1)，所以没有其他会话可以为其获取锁，无论是读锁还是写锁。如果会话只持有标识符的读锁，则其他会话可以为其获取读锁，但不能获取写锁。

单个锁获取调用的锁是原子获取的，但原子性并不适用于所有调用。因此，对于如下语句，where service_get_write_locks()在结果集的每一行调用一次，原子性对每个单独的调用都成立，但对整个语句不成立：

SELECT service_get_write_locks('ns', 'lock1', 'lock2', 0) FROM t1 WHERE ... ;

INSERT INTO ... SELECT service_get_write_locks('ns', t1.col_name, 0) FROM t1;

metadata_locks锁定服务是使用 MySQL 服务器元数据锁框架实现的，因此您可以通过检查 Performance Schema表 来监控获取或等待的锁定服务锁。

首先，启用元数据锁定工具：

mysql> UPDATE performance_schema.setup_instruments SET ENABLED = 'YES'
    -> WHERE NAME = 'wait/lock/metadata/sql/mdl';

然后获取一些锁并检查 metadata_locks表的内容：

mysql> SELECT service_get_write_locks('mynamespace', 'lock1', 0);
+----------------------------------------------------+
| service_get_write_locks('mynamespace', 'lock1', 0) |
+----------------------------------------------------+
|                                                  1 |
+----------------------------------------------------+
mysql> SELECT service_get_read_locks('mynamespace', 'lock2', 0);
+---------------------------------------------------+
| service_get_read_locks('mynamespace', 'lock2', 0) |
+---------------------------------------------------+
|                                                 1 |
+---------------------------------------------------+
mysql> SELECT OBJECT_TYPE, OBJECT_SCHEMA, OBJECT_NAME, LOCK_TYPE, LOCK_STATUS
    -> FROM performance_schema.metadata_locks
    -> WHERE OBJECT_TYPE = 'LOCKING SERVICE'\G
*************************** 1. row ***************************
  OBJECT_TYPE: LOCKING SERVICE
OBJECT_SCHEMA: mynamespace
  OBJECT_NAME: lock1
    LOCK_TYPE: EXCLUSIVE
  LOCK_STATUS: GRANTED
*************************** 2. row ***************************
  OBJECT_TYPE: LOCKING SERVICE
OBJECT_SCHEMA: mynamespace
  OBJECT_NAME: lock2
    LOCK_TYPE: SHARED
  LOCK_STATUS: GRANTED

锁定服务锁的OBJECT_TYPE 值为LOCKING SERVICE。例如，这不同于使用 GET_LOCK()函数获取的锁，后者具有OBJECT_TYPEof USER LEVEL LOCK。

The lock namespace, name, and mode appear in the OBJECT_SCHEMA, OBJECT_NAME, and LOCK_TYPE columns. Read and write locks have LOCK_TYPE values of SHARED and EXCLUSIVE, respectively.

The LOCK_STATUS value is GRANTED for an acquired lock, PENDING for a lock that is being waited for. You see PENDING if one session holds a write lock and another session is attempting to acquire a lock having the same identifier.

The SQL interface to the locking service implements the loadable functions described in this section. For usage examples, see Using the Locking Service Function Interface.

The functions share these characteristics:

These locking service functions are available: