Condividi tramite

  • Articolo

APPLOCK_TEST (Transact-SQL)

Restituisce le informazioni relative alla possibilità o meno di concedere un blocco per una risorsa dell'applicazione specifica a un proprietario di blocchi specifico senza acquisire il blocco stesso. APPLOCK_TEST è una funzione di blocco a livello di applicazione e viene eseguita nel database corrente. L'ambito dei blocchi a livello di applicazione è il database.

Icona di collegamento a un argomentoConvenzioni della sintassi Transact-SQL

Sintassi

APPLOCK_TEST ( 'database_principal' , 'resource_name' , 'lock_mode' , '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 della risorsa di blocco specificato nell'applicazione client. L'applicazione deve garantire che la risorsa sia univoca. Per il nome specificato viene eseguito internamente l'hashing in un valore che è possibile archiviare in Gestione blocchi di SQL Server. resource_nameè di tipo nvarchar(255) e non prevede alcun valore predefinito. resource_name viene confrontato a livello binario e fa distinzione tra maiuscole e minuscole, indipendentemente dalle impostazioni delle regole di confronto definite nel database corrente.

  • 'lock_mode'
    Modalità di blocco da acquisire per una particolare risorsa. lock_mode è di tipo nvarchar(32) e non prevede alcun valore predefinito. Il valore può essere uno dei seguenti, ovvero Shared, Update, IntentShared, IntentExclusive, Exclusive.

  • 'lock_owner'
    Proprietario del blocco, ovvero il valore di lock_owner quando è stato richiesto il blocco. lock_owner è di tipo nvarchar(32). Il valore può essere Transaction (predefinito) o Session. Se si specifica in modo esplicito il valore predefinito o Transaction, è necessario eseguire APPLOCK_TEST in una transazione.

Tipi restituiti

smallint

Valore restituito

Restituisce 0 se il blocco non può essere concesso al proprietario specificato. In caso contrario restituisce 1.

Proprietà delle funzioni

Nondeterministic

Nonindexable

Nonparallelizable

Esempi

Nell'esempio seguente due utenti, A e B, con sessioni separate eseguono la sequenza di istruzioni Transact-SQL riportata di seguito.

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