mysql_xdevapi\CollectionFind
PHP マニュアル

CollectionFind::lockExclusive

Execute operation with EXCLUSIVE LOCK

説明

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

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

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

パラメータ

lock_waiting_option

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

  • MYSQLX_LOCK_DEFAULT

  • MYSQLX_LOCK_NOWAIT

  • MYSQLX_LOCK_SKIP_LOCKED

戻り値

後の処理に使える 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();
?>