GET_LOCK

Syntax

GET_LOCK(str,timeout)

Description

Essaie d'obtenir un verrou avec un nom donné par la chaîne << fixed >> str << / fixed >>, en utilisant un timeout de << fixed >> timeout << / fixed >> secondes. Renvoie << fixed >> 1 << / fixed >> si le verrou a été obtenu avec succès, << fixed >> 0 << / fixed >> si la tentative a expiré (par exemple, parce qu'un autre client a déjà verrouillé le nom) , ou << fixed >> NULL << / fixed >> si une erreur est survenue (comme un manque de mémoire ou si le thread a été tué avec mysqladmin kill).

Si vous avez un verrou obtenu avec << fixed >> GET_LOCK () << / fixed >>, il est libéré lorsque vous exécutez RELEASE_LOCK (), exécutez un nouveau << fixed >> GET_LOCK () < </ fixed >>, ou votre connexion se termine (normalement ou anormalement). Les verrous obtenus avec << fixed >> GET_LOCK () << / fixed >> n'interagissent pas avec les transactions. C'est-à-dire que la validation d'une transaction ne libère aucun de ces verrous obtenus pendant la transaction.

Notes

str est insensible à la casse pour GET_LOCK() et fonctions connexes. Sistr est une chaîne vide ouNULL, GET_LOCK() renvoie NULL et ne fait rien timeout est arrondi à l'entier le plus proche.

Si le metadata_lock_info plugin est installé, les verrous acquis avec cette fonction sont visibles dans la table Information Schema METADATA_LOCK_INFO.

Cette fonction peut être utilisée pour implémenter des verrous d'application ou pour simuler des enregistrements de verrous. Les noms sont verrouillés sur l'ensemble du serveur. Si un nom a été verrouillé par un client, << fixed >> GET_LOCK () << / fixed >> bloque toute requête d'un autre client pour un verrou avec le même nom. Cela permet aux clients qui sont d'accord sur un nom de verrou donné, d'utiliser le nom pour effectuer un verrouillage de conseil coopératif. Mais sachez que cela permet également à un client qui ne fait pas partie de l'ensemble des clients verrouiller par un nom, soit par inadvertance ou délibérément, et empêcher ainsi l'un des clients coopérants de verrouiller ce nom. Une façon de réduire la probabilité est d'utiliser des noms de verrous spécifiques à la base de données ou à l'application. Par exemple, utilisez les noms de verrous de la forme << fixed >> db_name.str << / fixed >> ou << fixe >> app_name.str << / fixed >>.

Les instructions utilisant la fonction GET_LOCK () ne sont pas safe for replication.

Exemples

SELECT GET_LOCK('lock1',10)\G
*************************** 1. row ***************************
GET_LOCK('lock1',10): 1

SELECT IS_FREE_LOCK('lock2')\G
*************************** 1. row ***************************
IS_FREE_LOCK('lock2'): 1

SELECT GET_LOCK('lock2',10)\G
*************************** 1. row ***************************
GET_LOCK('lock2',10): 1

SELECT RELEASE_LOCK('lock2')\G
*************************** 1. row ***************************
RELEASE_LOCK('lock2'): 1

SELECT RELEASE_LOCK('lock1')\G
*************************** 1. row ***************************
RELEASE_LOCK('lock1'): NULL

See also

• RELEASE_LOCK()
• IS_FREE_LOCK()
• IS_USED_LOCK()