APPLOCK_TEST (Transact-SQL)
Devuelve información acerca de si se puede conceder o no un bloqueo para un recurso de aplicación determinado para el propietario de un bloqueo específico, sin adquirir el bloqueo. APPLOCK_TEST es una función de bloqueo de aplicación que opera en la base de datos actual. El ámbito de los bloqueos de aplicación es la base de datos.
.gif "Icono de vínculo a temas")
Convenciones de sintaxis de Transact-SQL
Sintaxis
APPLOCK_TEST ( 'database_principal' , 'resource_name' , 'lock_mode' , 'lock_owner' )
Argumentos
' database_principal '
Es el usuario, el rol o el rol de aplicación al que se pueden conceder permisos para los objetos de la base de datos. El autor de la llamada de la función debe ser miembro de database_principal, dbo o del rol fijo de base de datos db_owner para poder llamar a la función correctamente.' resource_name '
Se trata de un nombre de recurso de bloqueo especificado por la aplicación cliente. La aplicación debe garantizar que el recurso es único. El nombre especificado se convierte internamente mediante un algoritmo hash en un valor que puede almacenarse en el administrador de bloqueos de SQL Server. resource_name* *es de tipo nvarchar(255) y no tiene valor predeterminado. resource_name se compara con un binario y distingue mayúsculas de minúsculas, independientemente de la configuración de intercalación de la base de datos actual.' lock_mode '
Es el modo de bloqueo que se va a obtener para un recurso determinado. lock_mode es de tipo nvarchar(32) y no tiene valor predeterminado. El valor puede ser: Shared, Update, IntentShared, IntentExclusive, Exclusive.' lock_owner '
Es el propietario del bloqueo, que es el valor de lock_owner cuando se solicitó el bloqueo. lock_owner es de tipo nvarchar(32). El valor puede ser Transaction (predeterminado) o Session. Si se especifica el valor predeterminado o Transaction explícitamente, debe ejecutarse APPLOCK_TEST desde una transacción.
Tipos de valor devueltos
smallint
Valor devuelto
Devuelve 0 cuando no se puede conceder el bloqueo al propietario especificado y devuelve 1 si se puede conceder el bloqueo.
Propiedades de la función
No determinista
No indizable
No paralelizable
Ejemplos
En el ejemplo siguiente, dos usuarios (Usuario A y Usuario B) con sesiones independientes ejecutan la siguiente secuencia de instrucciones Transact-SQL.
El Usuario A ejecuta:
USE AdventureWorks2012;
GO
BEGIN TRAN;
DECLARE @result int;
EXEC @result=sp_getapplock
@DbPrincipal='public',
@Resource='Form1',
@LockMode='Shared',
@LockOwner='Transaction';
SELECT APPLOCK_MODE('public', 'Form1', 'Transaction');
GO
Después, el Usuario B ejecuta:
Use AdventureWorks2012;
GO
BEGIN TRAN;
SELECT APPLOCK_MODE('public', 'Form1', 'Transaction');
--Result set: NoLock
SELECT APPLOCK_TEST('public', 'Form1', 'Shared', 'Transaction');
--Result set: 1 (Lock is grantable.)
SELECT APPLOCK_TEST('public', 'Form1', 'Exclusive', 'Transaction');
--Result set: 0 (Lock is not grantable.)
GO
Después, el Usuario A ejecuta:
EXEC sp_releaseapplock @Resource='Form1', @DbPrincipal='public';
GO
Después, el Usuario B ejecuta:
SELECT APPLOCK_TEST('public', 'Form1', 'Exclusive', 'Transaction');
--Result set: '1' (The lock is grantable.)
GO
Después, el Usuario A y el Usuario B ejecutan:
COMMIT TRAN;
GO