sp_releaseapplock (Transact-SQL)
Снимает блокировку ресурса приложения.
.gif "Значок ссылки на раздел")
Синтаксические обозначения Transact-SQL
Синтаксис
sp_releaseapplock [ @Resource = ] 'resource_name'
[ , [ @LockOwner = ] 'lock_owner' ]
[ , [ @DbPrincipal = ] 'database_principal' ]
[ ; ]
Аргументы
[ @Resource= ] 'resource_name'
Имя ресурса блокировки, указанное клиентским приложением. Приложение должно убедиться в уникальности ресурса. Указанное имя внутренне хэшируется в значение, которое может быть сохранено в диспетчере блокировок SQL Server. Аргумент resource_name имеет тип nvarchar(255) и не имеет значения по умолчанию. Аргумент resource_name сравнивается в двоичном режиме и поэтому рассматривается с учетом регистра независимо от настроек параметров сортировки текущей базы данных.[ @LockOwner= ] 'lock_owner'
Владелец блокировки, которая имеет значение lock_owner на момент запроса блокировки. Аргумент lock_owner имеет тип nvarchar(32). Значением может быть Transaction (по умолчанию) или Session. Если аргумент lock_owner имеет значение Transaction, по умолчанию или заданное явно, процедура sp_getapplock должна выполняться внутри транзакции.[ @DbPrincipal= ] 'database_principal'
Пользователь, роль или роль приложения, которые имеют разрешения на объект базы данных. Для успешного вызова этой функции необходимо быть членом предопределенной роли базы данных database_principal, dbo или db_owner. Значение по умолчанию: public.
Значения кодов возврата
>= 0 (успешное завершение) или < 0 (неуспешное завершение)
Значение |
Результат |
|---|---|
0 |
Блокировка успешно снята. |
-999 |
Сигнализирует об ошибке проверки параметра или о другой ошибке вызова процедуры. |
Замечания
Если приложение вызывает процедуру sp_getapplock несколько раз для одного и того же блокируемого ресурса, процедура sp_releaseapplock должна вызываться столько же раз для снятия блокировки.
При отключении сервера вне зависимости от причины отключения освобождаются все блокировки.
Разрешения
Необходимо членство в роли public.
Примеры
В следующем примере освобождается блокировка ресурса Form1, связанная с текущей транзакцией в базе данных AdventureWorks2012.
USE AdventureWorks2012;
GO
EXEC sp_getapplock @DbPrincipal = 'dbo', @Resource = 'Form1',
@LockMode = 'Shared';
EXEC sp_releaseapplock @DbPrincipal = 'dbo', @Resource = 'Form1';
GO