Skip to main content

Node.js によるトランザクションの管理とロック

Native SDK for Node.js は、インターシステムズのトランザクション・モデルを使用するトランザクション・メソッドとロック・メソッドを提供します。これについて、以下のセクションで説明します。

  • トランザクションの処理 — トランザクションの開始、入れ子、ロールバック、およびコミットの方法について説明します。

  • 並行処理の制御 — さまざまなロック・メソッドの使用法について説明します。

インターシステムズのトランザクション・モデルの詳細は、"インターシステムズ・アプリケーションの開発" の “トランザクション処理” を参照してください。

Node.js でのトランザクションの処理

Iris クラスは、トランザクション処理のための以下のメソッドを提供します。

  • Iris.tCommit() — 1 レベルのトランザクションをコミットします。

  • Iris.tStart() — トランザクションを開始します (このトランザクションは入れ子になっている場合あり)。

  • Iris.getTLevel() — 現在のトランザクション・レベルを示す int 値 (トランザクション内でない場合は 0) を返します。

  • Iris.increment() — ノードをロックすることなく、ノード値をインクリメントまたはデクリメントします。

  • Iris.tRollback() — セッション内の開いているトランザクションすべてをロールバックします。

  • Iris.tRollbackOne() — 現在のレベルのトランザクションのみをロールバックします。入れ子になったトランザクションである場合、それより上のレベルのトランザクションはロールバックされません。

以下の例では、3 レベルの入れ子のトランザクションを開始し、各トランザクション・レベルで異なるグローバル・ノードの値を保存します。3 つのノードはすべて出力され、それらに値があることが証明されます。その後、この例では、2 番目と 3 番目のレベルがロールバックされ、最初のレベルがコミットされます。3 つのノードはすべて再び出力され、依然として値があるのは最初のノードのみであることが証明されます。

トランザクションの制御 : 3 レベルの入れ子トランザクションの作成とロールバック

irisjs がクラス Iris の接続されたインスタンスであるとします (“Node.js での接続の作成” を参照してください)。

  const node = 'myGlobal';
  console.log('Set three values in three different transaction levels:');
  for (let i=1; i<4; i++) {
    irisjs.tStart();
    let lvl = irisjs.getTLevel()
    irisjs.set(('Value'+lvl), node, lvl);
    let val = '<valueless>'
    if (irisjs.isDefined(node,lvl)%10 > 0) val = irisjs.get(node,lvl);
    console.log('  ' + node + '(' + i + ') = ' + val + ' (tLevel is ' + lvl + ')');
  }
// Prints: Set three values in three different transaction levels:
//         myGlobal(1) = Value1 (tLevel is 1)
//         myGlobal(2) = Value2 (tLevel is 2)
//         myGlobal(3) = Value3 (tLevel is 3)

  console.log('Roll back two levels and commit the level 1 transaction:');
  let act = ['  tRollbackOne','  tRollbackOne','       tCommit'];
  for (let i=3; i>0; i--) {
    if (i>1) {irisjs.tRollbackOne();} else {irisjs.tCommit();}
    let val = '<valueless>'
    if (irisjs.isDefined(node,i)%10 > 0) val = irisjs.getString(node,i);
    console.log(act[3-i]+' (tLevel='+irisjs.getTLevel()+'): '+node+'('+i+') = '+val);
  }

// Prints: Roll back two levels and commit the level 1 transaction:
//           tRollbackOne (tLevel=2): myGlobal(3) = <valueless>
//           tRollbackOne (tLevel=1): myGlobal(2) = <valueless>
//                tCommit (tLevel=0): myGlobal(1) = Value1

Caution:

increment() を使用するトランザクションが (tRollback() または tRollbackOne() で) ロールバックされる場合、カウンタの値は無視されます。カウンタ変数はデクリメントされません。これは、結果として生じるカウンタの値が有効でない場合があるためです。 このようなロールバックは、同じカウンタを使用する他のトランザクションに重大な問題を引き起こす可能性があります。

Node.js による並行処理の制御

並行処理の制御は、InterSystems IRIS などのマルチプロセス・システムのきわめて重要な機能です。この機能により、データの特定の要素をロックして、複数のプロセスが同じ要素を同時に変更することによって起きるデータ破損を防ぐことができます。Native SDK トランザクション・モデルは、ObjectScript コマンドに対応する一連のロック・メソッドを提供します ("ObjectScript リファレンス" の “LOCK” を参照してください)。

クラス Iris の以下のメソッドを使用して、ロックを取得および解放します。

  • Iris.lock() — lockReference および *subscripts 引数で指定されたノードをロックします。このメソッドは、ロックを取得できない場合、事前に定義した間隔が経過するとタイムアウトします。

  • Iris.unlock() — lockReference および *subscripts 引数で指定されたノードのロックを解放します。

  • Iris.releaseAllLocks() — この接続で現在保持されているロックをすべて解放します。

パラメータ :

   lock(lockMode, timeout, lockReference, ...subscript)
   unlock(lockMode, lockReference, ...subscript)
   releaseAllLocks()
  • lockMode — 以前に保持されていたロックを処理する方法を指定する文字列。有効な引数は、共有ロックを表す S、エスカレート・ロックを表す E、共有とエスカレートの両方を表す SE です。既定値は空の文字列 (排他の非エスカレート) です。

  • timeout — ロックの取得を試行するときに待機する秒数。この秒数を経過するとタイムアウトになります。

  • lockReference — 曲折アクセント記号 (^) で始まり、その後にグローバル名が続く文字列 (例えば、単なる myGlobal ではなく ^myGlobal)。

    重要 : ほとんどのメソッドで使用される globalName パラメータとは異なり、lockReference パラメータには、先頭に曲折アクセント記号を付ける必要があります。 globalName ではなく lockReference を使用するのは、lock() および unlock() のみです。

  • subscripts — ロックまたはアンロックするノードを指定する 0 個以上の添え字。

これらのメソッドに加え、Connection.close() メソッドは、すべてのロックとその他の接続リソースを解放します。

Tip:

管理ポータルを使用して、ロックを検証できます。System Operation > View Locks に移動して、システムでロックされている項目のリストを表示します。

Note:

並行処理の制御に関する詳細な説明は、このドキュメントの対象ではありません。この内容に関する詳細は、以下の項目を参照してください。

FeedbackOpens in a new tab