第 7.6.9.1.1 节，“锁定服务 C 接口” 中描述的锁定服务例程无需安装，因为它们已内置到服务器中。映射到服务例程调用的可加载函数并非如此：函数必须在使用前安装。本节介绍如何执行此操作。有关可加载函数安装的一般信息，请参见 第 7.7.1 节，“安装和卸载可加载函数”。

锁定服务函数在由 plugin_dir 系统变量指定的目录中的插件库文件中实现。文件基本名称为 locking_service。文件名的后缀因平台而异（例如，对于 Unix 和类 Unix 系统为 .so，对于 Windows 为 .dll）。

要安装锁定服务函数，请使用 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 表，您应该会发现该会话持有六个具有相同 (ns, lock1) 标识符的不同锁。（有关详细信息，请参见 锁定服务监控。）

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

单个锁获取调用的锁是原子获取的，但原子性不跨调用保持。因此，对于以下语句，其中 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;

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

首先，启用元数据锁工具

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_TYPE 为 USER LEVEL LOCK 的锁。

锁命名空间、名称和模式分别显示在 OBJECT_SCHEMA、OBJECT_NAME 和 LOCK_TYPE 列中。读锁和写锁分别具有 LOCK_TYPE 值 SHARED 和 EXCLUSIVE。

对于已获取的锁，LOCK_STATUS 值为 GRANTED，对于正在等待的锁，LOCK_STATUS 值为 PENDING。如果您发现 PENDING，则意味着一个会话持有一个写锁，而另一个会话正在尝试获取具有相同标识符的锁。

锁定服务的 SQL 接口实现了本节中描述的可加载函数。有关使用示例，请参见 使用锁定服务函数接口。

这些函数具有以下共同特征

以下锁定服务函数可用