START TRANSACTION

%BEGTRANS (非推奨)

%BEGTRANS 文は、機能的には、引数なしの START TRANSACTION と同じです。%BEGTRANS は引数を取ることができないので、非推奨と見なされます。すべての新しい SQL プログラム・コードで START TRANSACTION を使用してください。

パラメータ設定

必要に応じて、START TRANSACTION を使用して、パラメータを設定することができます。指定したパラメータ設定は、即座に有効になります。ただし、START TRANSACTION で開始したトランザクションは、commitmode パラメータの設定に関係なく、明示的な COMMIT または ROLLBACK で終了する必要があります。パラメータ設定は、現在のプロセスの間または明示的にリセットされるまで、有効になります。トランザクションの最後に、自動的に既定値にリセットされることはありません。

単一の START TRANSACTION 文を使用して、commitmode パラメータまたは transactionmodes パラメータを設定できますが、両方を設定することはできません。両方を設定するには、SET TRANSACTION および START TRANSACTION または 2 つの START TRANSACTION 文を発行します。最初の START TRANSACTION は、トランザクションを開始します。

START TRANSACTION を発行した後に、トランザクション中に別の START TRANSACTION、SET TRANSACTION、またはメソッド呼び出しを発行して、これらのパラメータ設定を変更できます。commitmode パラメータを変更しても、現在のトランザクションを明示的な COMMIT または ROLLBACK で終了するという要件がなくなることはありません。

SET TRANSACTION 文を使用すると、トランザクションを開始せずに commitmode パラメータまたは transactionmodes パラメータを設定できます。また、これらのパラメータは、トランザクション内部または外部のメソッド呼び出しを使用しても設定できます。

%COMMITMODE

%COMMITMODE キーワードを使用すると、現在のプロセスでトランザクションの開始とコミットの自動化を指定できます。START TRANSACTION %COMMITMODE は、現在のプロセスの今後すべてのトランザクションのコミット・モードの設定を変更します。START TRANSACTION 文で開始されたトランザクションには効果がありません。現在のまたは設定されているコミット・モードに関係なく、START TRANSACTION は即座にトランザクションを開始し、このトランザクションは、明示的な COMMIT または ROLLBACK を発行して終了する必要があります。

使用可能な %COMMITMODE のオプションは以下のとおりです。

• IMPLICIT ： トランザクションの自動コミットをオンにする (最初のプロセスの既定)。プログラムがデータベース変更操作 (INSERT、UPDATE、DELETE、または TRUNCATE TABLE) を発行すると、SQL はトランザクションを自動的に開始します。操作が正常に完了し、SQL が変更を自動的にコミットするか、操作がすべての行では正常に完了できず、SQL が操作全体を自動的にロールバックするまで、トランザクションは継続されます。各データベース操作 (INSERT、UPDATE、DELETE、または TRUNCATE TABLE) は、個別のトランザクションを構成します。データベース操作の実行が成功すると、自動的にロールバックのジャーナルがクリアされ、ロックが解放され、$TLEVEL がデクリメントされます。COMMIT 文は必要ありません。

• EXPLICIT ： トランザクションの自動コミットをオフにする。プログラムが最初のデータベース変更操作 (INSERT、UPDATE、DELETE、または TRUNCATE TABLE) を発行すると、SQL はトランザクションを自動的に開始します。トランザクションは明示的に終了されるまで継続します。正常に終了したら、COMMIT 文を発行します。データベース変更操作が失敗したら、ROLLBACK 文を発行して、データベースをトランザクションが始まる前の時点に戻します。EXPLICIT モードでは、複数のデータベース変更操作で 1 つのトランザクションを構成できます。

• NONE ： トランザクション処理を自動化しない。トランザクションは、START TRANSACTION で明示的に呼び出されるまで開始されません。COMMIT 文または ROLLBACK 文を発行して、すべてのトランザクションを明示的に終了する必要があります。このため、データベース操作がトランザクションに含まれるかどうかと、トランザクション内のデータベース操作の数は、ユーザ定義です。

SetAutoCommit()Opens in a new tab メソッド呼び出しを使用することで、ObjectScript で %COMMITMODE を設定できます。使用可能なメソッドの値は、0 (NONE)、1 (IMPLICIT)、および 2 (EXPLICIT) です。

ISOLATION LEVEL

クエリを発行しているプロセスの ISOLATION LEVEL を指定します。ISOLATION LEVEL オプションを使用すると、進行中の変更に対してクエリが読み取りアクセスできるようにするかどうかを指定できます。別の同時プロセスがテーブルに対して挿入または更新を行っており、それらのテーブルへの変更がトランザクション内である場合、それらの変更は進行中で、ロールバックされる可能性があります。テーブルのクエリを行っているプロセスの ISOLATION LEVEL を設定することで、これらの進行中の変更をクエリ結果に含めるか排除するかを指定できます。

• READ UNCOMMITTED は、すべての変更分がクエリ・アクセスで即座に使用できることを示します。これには、その後ロールバックされる可能性のある変更が含まれます。READ UNCOMMITTED では、クエリは同時挿入または更新プロセスを待機せずに結果を返すため、ロック・タイムアウト・エラーにより失敗することはありません。ただし、READ UNCOMMITTED の結果にはコミットされていない値が含まれる場合があります。挿入または更新操作が部分的にしか完了していないため、これらの値は内部的に不整合となり、その後ロールバックされる可能性があります。クエリ・プロセスが明示的なトランザクション内にない場合、またはトランザクションで ISOLATION LEVEL が指定されない場合、READ COMMITTED が既定となります。READ UNCOMMITTED は、READ WRITE アクセスと互換性がありません。同じ文で両方を指定すると、SQLCODE -92 エラーが発生します。

• READ VERIFIED は、その他のトランザクションのコミットされていないデータがすぐに使用可能であり、ロックが実行されないことを示しています。これには、その後ロールバックされる可能性のある変更が含まれます。ただし、READ UNCOMMITTED とは異なり、READ VERIFIED トランザクションは、クエリ条件を満たさない出力となるコミットされていないデータや新たにコミットされたデータによって無効にされる可能性があるすべての条件を再確認します。この条件の再確認のため、READ VERIFIED は READ UNCOMMITTED よりも正確ですが、効率性は劣ります。READ VERIFIED は、条件による確認が行われるデータに対する同期更新が行われる可能性がある場合のみ使用してください。READ VERIFIED は、READ WRITE アクセスと互換性がありません。同じ文で両方を指定しようとすると、SQLCODE -92 エラーになります。

• READ COMMITTED は、コミットされた変更分のみがクエリ・アクセスで使用できることを示します。これにより、実行されている変更のグループではなく、後にロールバックできる変更のグループの間で、クエリをデータベース内で一貫性のある状態で実行できます。要求されたデータは変更されているが、コミット (またはロールバック) されていない場合、クエリはトランザクションが完了するまで待機します。このデータが使用可能になるまで待機している間にロック・タイムアウトが発生した場合、SQLCODE -114 エラーが発行されます。

READ UNCOMMITTED と READ VERIFIED の違い

以下の例では、READ UNCOMMITTED と READ VERIFIED の違いが示されています。

SELECT Name,SSN FROM Sample.Person WHERE Name >= 'M' 

クエリ・オプティマイザは、まず、Name インデックスから >= 'M' の条件を満たす名前を含むすべての RowID を収集する選択を行う場合があります。収集後、出力用の Name フィールドと SSN フィールドを取得するために、Person テーブルへのアクセスが行われます (一度に 1 つの RowID)。同時に実行されている更新トランザクションにより、クエリによるインデックスからの RowID の収集とテーブルへの行単位のアクセスの間に、'Smith' から 'Abel' までの RowID 72 の Person の Name フィールドが変更される可能性があります。この場合、インデックスからの RowID の収集に Name >= 'M' の条件を満たさなくなった行の RowID が含まれます。

READ UNCOMMITTED のクエリ処理は、Name >= 'M' の条件がインデックスによって満たされていることを前提としており、インデックスから収集された RowID ごとにテーブル内にある Name を出力します。したがって、この例では、条件を満たさない 'Abel' の Name が含まれる行が出力されます。

READ VERIFIED のクエリ処理は、インデックスによってこれまで満たされていた条件に属する出力 (Name) 用のテーブルからフィールドを取得していることを示し、インデックスが検証された時点からフィールド値が変更されている場合に条件を再確認します。再確認時、行が条件を満たさなくなったことを示し、出力からそれを除外します。 出力で必要となる値のみ条件の再確認が行われます。この例において、SELECT SSN FROM Person WHERE Name >= 'M' は、RowID 72 の行を出力します。

有効な ISOLATION LEVEL

SET TRANSACTION (トランザクションを開始しない)、START TRANSACTION (分離モードを設定してトランザクションを開始)、または SetIsolationMode() メソッド呼び出しを使用して、プロセスの ISOLATION LEVEL を設定できます。

指定された ISOLATION LEVEL は、SET TRANSACTION、START TRANSACTION、または SetIsolationMode() メソッド呼び出しによって明示的にリセットされるまで有効です。COMMIT または ROLLBACK はデータの変更にのみ有効で、データ・クエリの変更には有効でないため、COMMIT または ROLLBACK の操作は ISOLATION LEVEL の設定に影響を与えません。

クエリの開始時に有効になっている ISOLATION LEVEL は、クエリ中も有効なままになります。

現在のプロセスの ISOLATION LEVEL を判別するには、GetIsolationMode()Opens in a new tab メソッド呼び出しを使用します。また、現在のプロセスの分離モードを設定するには、SetIsolationMode()Opens in a new tab メソッド呼び出しを使用します。これらのメソッドでは、READ UNCOMMITTED (既定) を 0、READ COMMITTED を 1、READ VERIFIED を 3 に指定します。他の数値を指定すると、分離モードが変更されません。分離モードを現在の分離モードに設定すると、エラーまたは変更は発生しません。これらのメソッドの使用法を以下の例に示します。

   WRITE $SYSTEM.SQL.GetIsolationMode()," default",!
   &sql(START TRANSACTION ISOLATION LEVEL READ COMMITTED,READ WRITE)
   WRITE $SYSTEM.SQL.GetIsolationMode()," after START TRANSACTION",!
   DO $SYSTEM.SQL.SetIsolationMode(0,.stat)
   IF stat=1 {
     WRITE $SYSTEM.SQL.GetIsolationMode()," after SetIsolationMode(0) call",! }
   ELSE { WRITE "SetIsolationMode() error" }
   &sql(COMMIT)

分離モードとアクセス・モードは、常に互換性がある必要があります。以下の例のように、アクセス・モードを変更する場合は、分離モードを変更します。

   WRITE $SYSTEM.SQL.GetIsolationMode()," default",!
   &sql(SET TRANSACTION ISOLATION LEVEL READ COMMITTED,READ WRITE)
   WRITE $SYSTEM.SQL.GetIsolationMode()," after SET TRANSACTION",!
   &sql(START TRANSACTION READ ONLY)
   WRITE $SYSTEM.SQL.GetIsolationMode()," after changing access mode",!
   &sql(COMMIT)