APPLOCK_TEST (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. Al nombre especificado se le aplica internamente un algoritmo hash para obtener un valor que se pueda almacenar en el administrador de bloqueos de SQL Server. resource_namees de tipo nvarchar(255) y no tiene ningún valor predeterminado. resource_name se compara con un binario y distingue entre mayúsculas y 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 determinado recurso. lock_mode es de tipo nvarchar(32) y no tiene ningún valor predeterminado. Puede ser cualquiera de los siguientes valores: 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 (el 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 las funciones

Nondeterministic

Nonindexable

Nonparallelizable

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 AdventureWorks2008R2;
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 AdventureWorks2008R2;
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

A continuación, el usuario A y el usuario B ejecutan:

COMMIT TRAN;
GO

Vea también

Referencia