REQUEST ステートメントは、ロックIDまたはLockハンドルを指定して、指定されたロックモードのロックを取得するために使用されます。
構文
DBMS_LOCK.REQUEST(
id IN INTEGER ||
lockhandle IN VARCHAR2,
lockmode IN INTEGER DEFAULT X_MODE,
timeout IN INTEGER DEFAULT MAXWAIT,
release_on_commit IN BOOLEAN DEFAULT FALSE)
RETURN INTEGER;
パラメータの説明
| パラメータ |
説明 |
| id || lockhandle |
ロックIDまたはLockハンドル。 |
| lockmode |
取得するロックモード。 |
| timeout |
ロック競合が発生した場合に待機する時間（単位：秒）。タイムアウト後、1を返します。 |
| release_on_commit |
TRUE に設定すると、トランザクションのコミットまたはロールバック時にロックが解放されます。それ以外の場合は、ユーザーが手動で解放するか、セッションが切断されるまで保持されます。現在のバージョンでは、このパラメータは TRUE および FALSE をサポートしています。デフォルトは FALSE です。relase_on_commit = TRUE の場合、RELEASEサブルーチンを使用してロックを解放することは現在サポートされていません。 |
戻り値
| 返り値 |
説明 |
| 0 |
成功 |
| 1 |
タイムアウト |
| 2 |
デッドロック |
| 3 |
パラメータエラー |
| 4 |
すでにロックがかけられている |
| 5 |
無効なLockハンドル |
例
obclient> DELIMITER /
obclient> DECLARE
my_lockname VARCHAR2(100) :='test01';
my_lockhandle VARCHAR2(200);
my_lock_output NUMBER;
BEGIN
DBMS_LOCK.ALLOCATE_UNIQUE(lockname => my_lockname,lockhandle => my_lockhandle);
my_lock_output := DBMS_LOCK.REQUEST(my_lockhandle,6, 60, FALSE);
END;/
Query OK, 1 row affected
