APPLOCK_MODE (Transact-SQL)

Restituisce la modalità di blocco acquisita dal proprietario del blocco per una particolare risorsa di applicazione. APPLOCK_MODE è una funzione di blocco a livello di applicazione e viene eseguita sul database corrente. L'ambito dei blocchi a livello di applicazione è il database.

Convenzioni della sintassi 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. Il chiamante della funzione deve essere membro del ruolo predefinito del database database_principal, dbo o db_owner per eseguire correttamente la chiamata alla funzione.

'resource_name'

Nome della 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 è possibile archiviare in Gestione blocchi di Microsoft SQL Server. resource_name è di tipo nvarchar(255) e non prevede alcun valore predefinito. Per resource_name viene eseguito un confronto binario ed è quindi supportata la distinzione tra maiuscole e minuscole indipendentemente dalle impostazioni delle regole di confronto del database corrente.

'lock_owner'

Proprietario del blocco, che corrisponde al valore lock_owner specificato quando è stato richiesto il blocco. lock_owner è di tipo nvarchar(32). I possibili valori sono Transaction (predefinito) e 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:

NoLock	Update	*SharedIntentExclusive
IntentShared	IntentExclusive	*UpdateIntentExclusive
Shared	Exclusive

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

Funzione Properties

Non deterministica

Nonindexable

Nonparallelizable

Esempi

Due utenti (Utente A e Utente B) con sessioni separate eseguono la seguente sequenza di istruzioni Transact-SQL.

Utente A esegue:

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

Utente B esegue quindi:

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

Utente A esegue quindi:

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

Utente B esegue quindi:

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

Utente A e Utente B eseguono entrambi:

COMMIT TRAN;
GO

Vedere anche

Riferimento

APPLOCK_TEST (Transact-SQL)
sp_getapplock (Transact-SQL)
sp_releaseapplock (Transact-SQL)

Guida in linea e informazioni

Assistenza su SQL Server 2005