APPLOCK_MODE (Transact-SQL)

Sintassi

APPLOCK_MODE( 'database_principal' , 'resource_name' , 'lock_owner' )

Argomenti

• 'database_principal'
  Utente, ruolo o ruolo applicazione a cui è possibile concedere le autorizzazioni per gli oggetti nel database. Affinché la chiamata della funzione abbia esito positivo, è necessario che il chiamante sia un membro del ruolo predefinito del database database_principal, dbo o db_owner.

• 'resource_name'
  Nome di una risorsa di blocco specificato nell'applicazione client. L'applicazione deve garantire che il nome della risorsa sia univoco. Per il nome specificato viene eseguito internamente l'hashing in un valore che può essere archiviato in Gestione blocchi di SQL Server. resource_nameè nvarchar(255) senza alcun valore predefinito. resource_name viene confrontato a livello binario e pertanto supporta la distinzione tra maiuscole e minuscole indipendentemente dalle impostazioni delle regole di confronto del database corrente.

• 'lock_owner'
  Proprietario del blocco, ovvero il valore di lock_owner quando il blocco è stato richiesto. lock_owner è nvarchar(32) con valore Transaction (predefinito) o Session.

Tipi restituiti

nvarchar(32)

Valore restituito

Restituisce la modalità di blocco acquisita dal proprietario del blocco per una particolare risorsa di applicazione. I possibili valori della modalità di blocco sono i seguenti:

*Questa modalità di blocco risulta dalla combinazione di altre modalità di blocco e non può essere acquisita in modo esplicito tramite sp_getapplock.

Proprietà delle funzioni

Nondeterministic

Nonindexable

Nonparallelizable

Esempi

Si supponga che due utenti, l'utente A e l'utente B, eseguano la sequenza di istruzioni Transact-SQL riportata di seguito in sessioni separate.

L'utente A esegue:

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

L'utente B quindi esegue:

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

L'utente A quindi esegue:

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

L'utente B quindi esegue:

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

Gli utenti A e B eseguono quindi l'istruzione seguente:

COMMIT TRAN;
GO

Vedere anche

Riferimento