7.3.17. lock_clear

7.3.17.1. 概要

バージョン 4.0.9 で追加.

lock_clear command clear the lock of the target object recursively. The target object is one of database, table and column.

注釈

This is a dangerous command. You must not use this command while other process or thread is doing a write operation to the target object. If you do it, your database may be broken and/or your process may be crashed.

7.3.17.2. 構文

truncate コマンドの引数は1つだけです:

必須の引数はありません:

lock_clear [target_name=null]

If target_name parameters is omitted, database is used for the target object. It means that all locks in the database are cleared.

7.3.17.3. 使い方

以下はデータベースの中のすべてのロックを解放する例です:

.. groonga-command
.. include:: ../../example/reference/commands/lock_clear/database.log
.. lock_clear

以下は Entry テーブルと Entry テーブルのカラムのロックを解放する例です:

.. groonga-command
.. include:: ../../example/reference/commands/lock_clear/table.log
.. table_create Entry TABLE_NO_KEY
.. column_create Entry body COLUMN_SCALAR Text
.. lock_clear Entry

以下は Site.title カラムのロックを解放する例です:

.. groonga-command
.. include:: ../../example/reference/commands/lock_clear/column.log
.. table_create Site TABLE_HASH_KEY ShortText
.. column_create Site title COLUMN_SCALAR ShortText
.. lock_clear Site.title

7.3.17.4. 引数

このセクションではすべての引数について説明します。

7.3.17.4.1. target_name

テーブル名またはカラム名を指定します。

If you don't specify it, database is used for the target object.

The default is none. It means that the target object is database.

7.3.17.5. 戻り値

[HEADER, SUCCEEDED_OR_NOT]

HEADER

HEADER については 出力形式 を参照してください。

SUCCEEDED_OR_NOT

コマンドの実行が成功するとtrueを返します。失敗するとエラーとしてfalseを返します。