APPLOCK_TEST (Transact-SQL)

[アーティクル]
07/05/2024

適用対象: SQL Server Azure SQL Database Azure SQL Managed Instance

この関数は、ロックを取得せずに指定されたロック所有者の特定のアプリケーションリソースのロックを許可できるかどうかについての情報を返します。 APPLOCK_TEST はアプリケーションロック関数であり、現在のデータベース上で動作します。データベースはアプリケーションロックのスコープです。

Transact-SQL 構文表記規則

構文

APPLOCK_TEST ( 'database_principal' , 'resource_name' , 'lock_mode' , 'lock_owner' )

引数

' database_principal '
データベース内のオブジェクトに対するアクセス許可を許可されるユーザー、ロール、またはアプリケーションロールです。関数を正常に呼び出すには、関数の呼び出し元が database_principal、dbo、または、db_owner 固定データベースロールのメンバーである必要があります。

' resource_name '
クライアントアプリケーションによって指定されたロックリソース名を指定します。アプリケーション側では、リソース名が一意になるよう管理されている必要があります。指定した名前は、SQL Server ロックマネージャーが内部的に保存できる値に内部的にハッシュされます。 resource_name は nvarchar (255) であり、既定値はありません。 resource_name はバイナリ比較し、現在のデータベースの照合順序の設定に関係なく大文字小文字を区別します。

' lock_mode '
特定のリソースに対して取得するロックモード。 lock_mode は nvarchar (32) であり、既定値はありません。 lock_mode は、Shared、Update、IntentShared、IntentExclusive、Exclusive のいずれかの値をとります。

' lock_owner '
ロックの所有者を指定します。これはロックが要求されたときの lock_owner 値です。 lock_owner は nvarchar (32), 、値には、いずれかを指定して トランザクション (既定値) または セッションです。既定値または Transaction を明示的に指定した場合、APPLOCK_TEST はトランザクション内から実行する必要があります。

戻り値の型

smallint

戻り値

指定された所有者にロックを許可できない場合は 0、ロックを許可できる場合は 1 です。

関数のプロパティ

非決定的

インデックス不可

並列不可

例

セッションが異なる 2 人のユーザー (ユーザー 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)

構文

引数

戻り値の型

戻り値

関数のプロパティ

例

関連項目

フィードバック

その他のリソース