LOCK TABLE

説明

このステートメントは、指定されたパターンに基づいて1つまたは複数のテーブル、テーブルのパーティション、またはサブパーティションをロックします。

ロックされたテーブルは、トランザクションがコミットされるか、ロールバックされるか、またはロック前のセーブポイントまでロールバックされるまで、ロック状態を維持します。

構文

LOCK TABLE [ schema. ]table_name

  [ partition_extension_clause]
    [, [ schema. ] table_name
      [ partition_extension_clause ]
     ]...
  IN lock_mode MODE
  [ NOWAIT
   | WAIT integer
  ] ;

partition_extension_clause:

    PARTITION (partition_name, ...)
  | SUBPARTITION (subpartition_name, ...)

構文の説明

例

以下の例は、パーティションテーブルを作成し、そのパーティションにロック操作を実行する方法です。

1. パーティションテーブル test を作成します。ここで、SUBPARTITION TEMPLATE によって生成されるサブパーティション名は、パーティション名 + 's' + サブパーティションテンプレート名となります。例えば、p0 パーティションにはサブパーティション p0ssp0、p0ssp1、p0ssp2 があります。

   CREATE TABLE TEST(col1 INT, col2 INT)
   PARTITION BY RANGE (col1)
   SUBPARTITION BY RANGE (col2)
     SUBPARTITION TEMPLATE
       (
       SUBPARTITION sp0 VALUES LESS THAN (3),
       SUBPARTITION sp1 VALUES LESS THAN (6),
       SUBPARTITION sp2 VALUES LESS THAN (9)
       )
   (
     PARTITION p0 VALUES LESS THAN (100),
     PARTITION p1 VALUES LESS THAN (200),
     PARTITION p2 VALUES LESS THAN (300)
   );
   

2. テーブル全体 test に排他ロックをかけます。

   obclient> LOCK TABLE test IN EXCLUSIVE MODE;
   Query OK, 0 rows affected
   

3. テーブル test のパーティション p1 に排他ロックをかけます。

   obclient> LOCK TABLE test PARTITION (p1) IN EXCLUSIVE MODE;
   Query OK, 0 rows affected
   

4. テーブル test のサブパーティション p1ssp1 に排他ロックをかけます。

   obclient> LOCK TABLE test SUBPARTITION (p1ssp1) IN EXCLUSIVE MODE;
   Query OK, 0 rows affected
   

5. テーブル test の複数のパーティションに排他ロックをかけます。

   obclient> LOCK TABLE test PARTITION (p1，p2) IN EXCLUSIVE MODE;
   Query OK, 0 rows affected
   

6. テーブル test の複数のサブパーティションに排他ロックをかけます。

   obclient> LOCK TABLE test SUBPARTITION (p0ssp1，p1ssp2) IN EXCLUSIVE MODE;
   Query OK, 0 rows affected
   

7. テーブル test の複数のパーティションとサブパーティションに排他ロックをかけます。

   obclient> LOCK TABLE test PARTITION (p1, p2), test SUBPARTITION (p0ssp0, p0ssp1) IN EXCLUSIVE MODE;
   Query OK, 0 rows affected
   

8. テーブル test に存在しないパーティションに排他ロックをかけます。以下の例では、p3 パーティションは存在しませんが、p0 パーティションもロックに失敗し、ステートメント全体がロールバックされます。

   obclient> LOCK TABLE test PARTITION (p0, p3) IN EXCLUSIVE MODE;
   OBE-02149: Specified partition does not exist
   

9. 2つのクライアントでそれぞれテーブル test にロックをかけます。ロックを保持しているクライアントには排他ロック、ロックを要求しているクライアントには共有ロックがかかります。 LOCK TABLE ステートメントで WAIT N/NOWAIT キーワードが設定されていない場合、タイムアウト時間はステートメントのタイムアウト時間とトランザクションのタイムアウト時間の最小値になります。この例では、1秒後にロック競合エラーが報告されます。

   # conn1
   obclient> START TRANSACTION;
   Query OK, 0 rows affected
   obclient> LOCK TABLE test IN EXCLUSIVE MODE;
   Query OK, 0 rows affected
   
   # conn2
   obclient> START TRANSACTION;
   Query OK, 0 rows affected
   obclient> SET ob_trx_timeout = 10000000000; # 10000秒
   Query OK, 0 rows affected
   obclient> SET ob_query_timeout = 1000000;   # 1秒
   Query OK, 0 rows affected
   
   # ロックを要求するクライアントは1秒後にロック競合エラーを報告します
   obclient> LOCK TABLE test IN SHARE MODE;
   OBE-30006: resource busy; acquire with WAIT timeout expired
   

10. 2つのクライアントでそれぞれテーブル test にテーブルロックをかけます。ロックを保持しているクライアントには排他ロック、ロックを要求しているクライアントには共有ロックがかかり、NOWAIT キーワードを使用します。 LOCK TABLE ステートメントで NOWAIT キーワードが設定されている場合、テーブルロックの競合が発生すると即座にエラーが報告され、「NOWAIT」というメッセージがエラー情報に表示されます。このエラー情報は、ステートメントで WAIT N/NOWAIT キーワードが設定されていない場合とは異なります。

    # conn1
    obclient> START TRANSACTION;
    Query OK, 0 rows affected
    obclient> LOCK TABLE test IN EXCLUSIVE MODE;
    Query OK, 0 rows affected
    
    # conn2
    obclient> START TRANSACTION;
    Query OK, 0 rows affected
    obclient> LOCK TABLE test IN SHARE MODE NOWAIT;
    OBE-00054: resource busy and acquire with NOWAIT specified or timeout expired
    

11. 2つのクライアントでそれぞれテーブル test にテーブルロックをかけます。ロックを保持しているクライアントには排他ロック、ロックを要求しているクライアントには共有ロックがかかり、WAIT N キーワードを使用します。 LOCK TABLE ステートメントで WAIT N キーワードが設定されている場合、テーブルロックの競合が発生するとN秒待機します。N秒経過してもロックが解除されない場合、エラーが報告され、「timeout expired」というメッセージがエラー情報に表示されます。このエラー情報は、ステートメントで WAIT N/NOWAIT キーワードが設定されていない場合とは異なります。

    # conn1
    obclient> START TRANSACTION;
    Query OK, 0 rows affected
    obclient> LOCK TABLE test IN EXCLUSIVE MODE;
    Query OK, 0 rows affected
    
    # conn2
    obclient> START TRANSACTION;
    Query OK, 0 rows affected
    
    # ロックを要求するクライアントは1秒後にロック競合エラーを報告します
    obclient> LOCK TABLE test IN SHARE MODE WAIT 1;
    OBE-00054: resource busy and acquire with NOWAIT specified or timeout expired