CollectionFind::lockExclusive

(No version information available, might only be in Git)

CollectionFind::lockExclusive — Execute operation with EXCLUSIVE LOCK

説明

public function mysql_xdevapi\CollectionFind::lockExclusive(int $lock_waiting_option = ?): mysql_xdevapi\CollectionFind

ドキュメントを排他ロックします。ドキュメントがロックされている間、他のトランザクションはドキュメントを更新できませんし、 SELECT ... LOCK IN SHARE MODE を使ったり、トランザクション分離レベルにあるデータの読み取りができません。一貫性のある読み取りはあらゆるロックを無視します。

並列処理の問題を避けるために、この機能は mysql_xdevapi\Collection::modify() コマンドから直接使うのが有用です。基本的に、このコマンドは行ロックを通してアクセスを直列化します。

パラメータ

lock_waiting_option

オプションで指定できる、ロック待ちのオプション。デフォルトは MYSQLX_LOCK_DEFAULT です。有効な値は以下のとおりです:

戻り値

後の処理に使える CollectionFind オブジェクトを返します。

例

例1 mysql_xdevapi\CollectionFind::lockExclusive() の例

<?php
$session = mysql_xdevapi\getSession("mysqlx://user:password@localhost");

$schema     = $session->getSchema("addressbook");
$collection = $schema->createCollection("people");

$session->startTransaction();

$result = $collection
  ->find("age > 50")
  ->lockExclusive()
  ->execute();

// ... do an operation on the object

// Complete the transaction and unlock the document
$session->commit();
?>

関連キーワード:

CollectionFind mysql xdevapi lockExclusive ロック operation session Execute ドキュメント lock waiting option トランザクション読み取り schema collection limit lockShared information available 排他分離レベル一貫性並列