APPLOCK_MODE(Transact-SQL)

적용 대상: SQL Server Azure SQL 데이터베이스 Azure SQL Managed Instance

이 기능은 특정 애플리케이션 리소스에 대해 잠금 소유자가 보유한 잠금 모드를 반환합니다. 애플리케이션 잠금 함수로 APPLOCK_MODE는 현재 데이터베이스에서 작동합니다. 데이터베이스는 애플리케이션 잠금의 범위입니다.

Transact-SQL 구문 표기 규칙

구문

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

인수

'database_principal'
데이터베이스의 개체에 대한 사용 권한이 부여될 수 있는 사용자, 역할 또는 애플리케이션 역할입니다. 함수를 성공적으로 호출하려면 함수 호출자가 database_principal, dbo 또는 db_owner 고정 데이터베이스 역할의 멤버여야 합니다.

'resource_name'
클라이언트 애플리케이션이 지정한 잠금 리소스의 이름입니다. 애플리케이션은 고유한 리소스 이름인지 확인해야 합니다. 지정된 이름은 SQL Server 잠금 관리자가 내부적으로 저장할 수 있는 값으로 내부적으로 해시됩니다. resource_name은 nvarchar(255)이며 기본값은 없습니다. resource_name은 이진 비교되며 현재 데이터베이스의 데이터 정렬 설정에 관계없이 대/소문자를 구분합니다.

'lock_owner'
잠금의 소유자이며 잠금이 요청되었을 때의 lock_owner 값입니다. lock_owner는 nvarchar (32)이고 값은 Transaction(기본값) 또는 Session이 될 수 있습니다.

반환 형식

nvarchar(32)

반환 값

특정 애플리케이션 리소스에 대해 잠금 소유자가 보유한 잠금 모드를 반환합니다. 잠금 모드는 다음 값 중 하나일 수 있습니다.

NoLock
Update
*SharedIntentExclusive

IntentShared
IntentExclusive
*UpdateIntentExclusive

공유
전용

*이 잠금 모드는 다른 잠금 모드의 조합이며 sp_getapplock은 명시적으로 설정할 수 없습니다.

함수 속성

비결정적

Nonindexable

Nonparallelizable

예제

별도의 세션을 갖는 두 명의 사용자(사용자 A와 사용자 B)가 다음의 Transact-SQL 명령문 시퀀스를 실행합니다.

사용자 A가 다음을 실행합니다.

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

사용자 B가 다음을 실행합니다.

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

사용자 A가 다음을 실행합니다.

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

그런 다음 사용자 B는 다음을 실행합니다.

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

사용자 A와 사용자 B가 다음을 실행합니다.

COMMIT TRAN;  
GO  

참고 항목

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