APPLOCK_TEST (Transact-SQL)

Sintaxe

APPLOCK_TEST ( 'database_principal' , 'resource_name' , 'lock_mode' , 'lock_owner' )

Argumentos

• 'database_principal'
  É o usuário, a função ou a função de aplicativo que pode receber permissões para objetos no banco de dados. O chamador da função deve ser um membro de database_principal, dbo ou a função de banco de dados fixa db_owner para chamar a função com êxito.

• 'resource_name'
  É um nome de recurso de bloqueio especificado pelo aplicativo cliente. O aplicativo deve garantir que o recurso seja exclusivo. É feito hash internamente do nome especificado para um valor que pode ser armazenado no gerenciador de bloqueios do SQL Server. resource_nameé nvarchar(255), sem padrão. resource_name é comparado com binário e diferencia maiúsculas e minúsculas, independentemente das configurações de agrupamento do banco de dados atual.

• 'lock_mode'
  É o modo de bloqueio que será obtido para um recurso específico. lock_mode é nvarchar(32) e não tem valor padrão. O valor pode ser qualquer um dos seguintes: Shared, Update, IntentShared, IntentExclusive, Exclusive.

• 'lock_owner'
  É o proprietário do bloqueio, que é o valor de lock_owner quando o bloqueio foi solicitado. lock_owner é nvarchar(32). O valor pode ser Transaction (o padrão) ou Session. Se o padrão ou Transaction for especificado explicitamente, APPLOCK_TEST deverá ser executado a partir de uma transação.

Tipos de retorno

smallint

Valor de retorno

Retorna 0 quando o bloqueio não puder ser concedido ao proprietário especificado e retorna 1 se o bloqueio puder ser concedido.

Propriedades da função

Não-determinístico

Não-indexável

Não-paralelizável

Exemplos

No exemplo a seguir, dois usuários (Usuário A e Usuário B) com sessões separadas executam a seguinte seqüência de instruções Transact-SQL.

O Usuário A executa:

USE AdventureWorks;
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

Então, o Usuário B executa:

Use AdventureWorks;
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

Então, o Usuário A executa:

EXEC sp_releaseapplock @Resource='Form1', @DbPrincipal='public';
GO

Então, o Usuário B executa:

SELECT APPLOCK_TEST('public', 'Form1', 'Exclusive', 'Transaction');
--Result set: '1' (The lock is grantable.)
GO

Então, o Usuário A e o Usuário B ambos executam:

COMMIT TRAN;
GO

Consulte também

Referência