セクション5.6.8.1.1「ロックサービス C インタフェース」 で説明されているロックサービスルーチンはサーバーに組み込まれているため、インストールする必要はありません。 サービスルーチンへのコールにマップされるユーザー定義関数 (UDF) にも同じことは当てはまりません: UDF は使用する前にインストールする必要があります。 このセクションでは、その方法について説明します。 UDF のインストールに関する一般情報については、セクション5.7.1「ユーザー定義関数のインストールおよびアンインストール」 を参照してください。

ロックサービス UDF は、plugin_dir システム変数で指定されたディレクトリにあるプラグインライブラリファイルに実装されます。 ファイルベース名は locking_service です。 ファイル名の接尾辞は、プラットフォームごとに異なります (たとえば、.so for Unix and Unix-like systems, .dll for Windows)。

ロックサービス UDF をインストールするには、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';

UDF がソースレプリケーションサーバーで使用されている場合は、レプリケーションの問題を回避するために、それらをすべてのレプリカサーバーにインストールします。

いったんインストールされると、UDF はアンインストールされるまでインストールされたままです。 これらを削除するには、DROP FUNCTION ステートメントを使用します:

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

ロックサービス UDF を使用する前に、UDF ロックインターフェイスのインストールまたはアンインストール で提供されている手順に従ってそれらをインストールします。

1 つ以上の読み取りロックを取得するには、次の関数を呼び出します:

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 ''.

セッションは、同じロック識別子に対して複数のロックを取得できます。 別のセッションに識別子の書込みロックがないかぎり、セッションは任意の数の読取りロックまたは書込みロックを取得できます。 識別子に対する各ロックリクエストは、新しいロックを取得します。 次のステートメントは、同じ識別子を持つ 3 つの書込みロックを取得してから、同じ識別子に対して 3 つの読取りロックを取得します:

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

この時点でパフォーマンススキーマ metadata_locks テーブルを調べると、同じ (ns, lock1) 識別子を持つ 6 つの個別ロックがセッションに保持されていることがわかります。 (詳細は、ロックサービスの監視 を参照してください。)

セッションは (ns, lock1) で少なくとも 1 つの書込みロックを保持するため、他のセッションは読取りまたは書込みのいずれのロックも取得できません。 セッションが識別子の読取りロックのみを保持している場合、他のセッションはその識別子の読取りロックを取得できますが、書込みロックは取得できません。

単一ロック取得コールのロックはアトミックに取得されますが、アトミック性はコール間で保持されません。 したがって、service_get_write_locks() が結果セットの行ごとに 1 回コールされる次のようなステートメントの場合、アトミック性は個々のコールに対して保持されますが、ステートメント全体に対しては保持されません:

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 Server メタデータロックフレームワークを使用して実装されるため、パフォーマンススキーマ 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 です。 これは、たとえば、USER LEVEL LOCK の OBJECT_TYPE を持つ GET_LOCK() 関数で取得されたロックとは異なります。

ロックネームスペース、名前およびモードは、OBJECT_SCHEMA、OBJECT_NAME および LOCK_TYPE カラムに表示されます。 読取りロックおよび書込みロックには、それぞれ SHARED および EXCLUSIVE の LOCK_TYPE 値があります。

LOCK_STATUS 値は、取得したロックの場合は GRANTED、待機中のロックの場合は PENDING です。 あるセッションが書込みロックを保持していて、別のセッションが同じ識別子を持つロックを取得しようとすると、PENDING が表示されます。

ロックサービスへの SQL インタフェースは、このセクションで説明するユーザー定義関数を実装します。 使用例については、UDF ロックインターフェイスの使用 を参照してください。

これらの関数は、次の特性を共有します:

次のロックサービス UDF を使用できます: