sp_releaseapplock (Transact-SQL)
適用於: SQL Server Azure SQL 資料庫 Azure SQL 受控執行個體
釋放應用程式資源的鎖定。
語法
sp_releaseapplock
[ [ @Resource = ] N'Resource' ]
[ , [ @LockOwner = ] 'LockOwner' ]
[ , [ @DbPrincipal = ] N'DbPrincipal' ]
[ ; ]
引數
[ @Resource = ] N'資源'
用戶端應用程式指定的鎖定資源名稱。 @Resource為 nvarchar(255),預設值為 NULL
。 @Resource是二進位比較,因此不論目前資料庫的定序設定為何,都會區分大小寫。
應用程式必須確保資源是唯一的。 指定的名稱會在內部哈希為可儲存在 SQL Server 鎖定管理員中的值。
[ @LockOwner = ] 'LockOwner'
鎖定的擁有者,這是 要求鎖定時@LockOwner 值。 @LockOwner為 varchar(32),預設值為 Transaction
。 值也可以是 Session
。 當@LockOwner值為 Transaction 時,預設或明確指定時,sp_getapplock
必須從交易內執行。
[ @DbPrincipal = ] N'DbPrincipal'
具有資料庫中物件許可權的使用者、角色或應用程式角色。 @DbPrincipal為 sysname,預設值為 public
。 函式的呼叫端必須是database_principal、dbo 或db_owner固定資料庫角色的成員,才能成功呼叫函式。
傳回碼值
>= 0
(成功),或 < 0
(失敗)。
值 | 結果 |
---|---|
0 |
已成功釋放鎖定。 |
-999 |
表示參數驗證或其他呼叫錯誤。 |
備註
當應用程式 sp_getapplock
呼叫相同鎖定資源的多次時, sp_releaseapplock
必須呼叫相同次數才能釋放鎖定。
當伺服器因任何原因關閉時,會釋放鎖定。
權限
需要 public 角色的成員資格。
範例
下列範例會釋放與資料庫中資源Form1
AdventureWorks2022
上目前交易相關聯的鎖定。
USE AdventureWorks2022;
GO
EXEC sp_getapplock @DbPrincipal = 'dbo',
@Resource = 'Form1',
@LockMode = 'Shared';
EXEC sp_releaseapplock @DbPrincipal = 'dbo',
@Resource = 'Form1';
GO