ロック機能
TiDB は、MySQL 8.0 で利用可能なユーザー レベルロック関数のほとんどをサポートします。
サポートされている関数
名前 | 説明 |
---|---|
GET_LOCK(lockName, timeout) | アドバイザリ ロックを取得します。1 パラメータlockName 64 文字以内でなければなりません。タイムアウトするまで最大timeout 秒間待機し、失敗を返します。 |
IS_FREE_LOCK(lockName) | ロックが空いているかどうかを確認します。 |
IS_USED_LOCK(lockName) | ロックが使用中かどうかを確認します。true の場合は、対応する接続 ID を返します。 |
RELEASE_ALL_LOCKS() | 現在のセッションによって保持されているすべてのロックを解除します。 |
RELEASE_LOCK(lockName) | 以前に取得したロックを解除します。1 パラメータlockName 64 文字を超えてはなりません。 |
MySQL 互換性
- TiDB で許可される最小タイムアウトは 1 秒、最大タイムアウトは 1 時間 (3600 秒) です。これは、0 秒と無制限のタイムアウト (
timeout=-1
) の両方が許可されている MySQL とは異なります。TiDB は、範囲外の値を最も近い許可された値に自動的に変換し、timeout=-1
3600 秒に変換します。 - TiDB は、ユーザー レベルのロックによって発生したデッドロックを自動的に検出しません。デッドロックされたセッションは最大 1 時間後にタイムアウトしますが、影響を受けるセッションの 1 つで
KILL
使用して手動で解決することもできます。また、ユーザー レベルのロックを常に同じ順序で取得することで、デッドロックを防ぐこともできます。 - ロックは、クラスタ内のすべての TiDB サーバーで有効になります。これは、ロックが単一のサーバーに対してローカルである MySQL クラスタおよびグループ レプリケーションとは異なります。
IS_USED_LOCK()
、別のセッションから呼び出され、ロックを保持しているプロセスの ID を返すことができない場合は1
を返します。