ローカル トランザクションのサポート
適用対象: 
SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)
OLE DB Driver for SQL Server ローカル トランザクションのトランザクション スコープは、セッションで区切られます。 コンシューマーの指示により、OLE DB Driver for SQL Server から SQL Server の接続済みインスタンスに要求を送信するとき、この要求が OLE DB Driver for SQL Server の 1 作業単位になります。 ローカル トランザクションは常に、OLE DB Driver for SQL Server の 1 セッションで 1 つ以上の作業単位をラップします。
OLE DB Driver for SQL Server の既定の自動コミット モードを使用すると、1 つの作業単位がローカル トランザクションのスコープとして扱われます。 ローカル トランザクションに参加するのは、1 単位のみです。 セッションが作成されると、OLE DB Driver for SQL Server によってそのセッションのトランザクションが開始されます。 作業単位の処理が正常に完了すると、その作業がコミットされます。 失敗すると、開始された作業がすべてロールバックされ、エラーがコンシューマーに報告されます。 いずれの場合も、OLE DB Driver for SQL Server は、同じセッションの新しいローカル トランザクションを開始し、すべての作業が 1 トランザクション内で実行されるようにします。
OLE DB Driver for SQL Server のコンシューマーは、ITransactionLocal インターフェイスを使用することで、より正確にローカル トランザクションのスコープを制御できます。 コンシューマーのセッションがトランザクションを開始すると、トランザクションの開始時点から、最終的に Commit または Abort メソッドが呼び出されるまでのセッションの作業単位すべてが、1 つのアトミックな単位として扱われます。 コンシューマーからの指示されたとき、OLE DB Driver for SQL Server により暗黙的にトランザクションが開始されます。 コンシューマーがモードの保持を要求しないと、セッションは親のトランザクション レベルの動作 (通常は、自動コミット モード) に戻ります。
OLE DB Driver for SQL Server では、次のように ITransactionLocal::StartTransaction パラメーターがサポートされています。
| パラメーター | 説明 |
|---|---|
| isoLevel[in] | このトランザクションで使用する分離レベルを指定します。 ローカル トランザクションでは、OLE DB Driver for SQL Server によって次がサポートされます。 ISOLATIONLEVEL_UNSPECIFIED ISOLATIONLEVEL_CHAOS ISOLATIONLEVEL_READUNCOMMITTED ISOLATIONLEVEL_READCOMMITTED ISOLATIONLEVEL_REPEATABLEREAD ISOLATIONLEVEL_CURSORSTABILITY ISOLATIONLEVEL_REPEATABLEREAD ISOLATIONLEVEL_SERIALIZABLE ISOLATIONLEVEL_ISOLATED ISOLATIONLEVEL_SNAPSHOT 注: SQL Server 2005 (9.x) 以降では、データベースのバージョン管理が有効でも無効でも、ISOLATIONLEVEL_SNAPSHOT は isoLevel の引数として有効です。 ただし、ユーザーがステートメントを実行する際に、バージョン管理が有効か、データベースが読み取り専用の場合は、エラーが発生します。 また、SQL Server 2005 (9.x) より前のバージョンの SQL Server に接続している場合に、isoLevel に ISOLATIONLEVEL_SNAPSHOT を指定すると、XACT_E_ISOLATIONLEVEL エラーが発生します。 |
| isoFlags[in] | 0 以外の値を指定すると、OLE DB Driver for SQL Server からはエラーが返されます。 |
| pOtherOptions[in] | NULL 以外の場合、OLE DB Driver for SQL Server では、インターフェイスからのオプション オブジェクトが要求されます。 このオプション オブジェクトの ulTimeout メンバーが 0 以外の場合、OLE DB Driver for SQL Server からは XACT_E_NOTIMEOUT が返されます。 OLE DB Driver for SQL Server では、szDescription メンバーの値は無視されます。 |
| pulTransactionLevel[out] | NULL 以外の場合、OLE DB Driver for SQL Server からは、トランザクションの入れ子のレベルが返されます。 |
ローカル トランザクションの場合、OLE DB Driver for SQL Server では、ITransaction::Abort パラメーターを次のように実装します。
| パラメーター | 説明 |
|---|---|
| pboidReason[in] | 設定しても無視されます。 NULL を指定しても問題ありません。 |
| fRetaining[in] | TRUE のときは、セッションの新しいトランザクションが暗黙的に開始されます。 このトランザクションは、コンシューマーがコミットまたは終了する必要があります。 FALSE のときは、OLE DB Driver for SQL Server のセッションのモードが自動コミット モードに戻ります。 |
| fAsync[in] | OLE DB Driver for SQL Server では、非同期アボートがサポートされていません。 この値が FALSE 以外の場合、OLE DB Driver for SQL Server からは XACT_E_NOTSUPPORTED が返されます。 |
ローカル トランザクションの場合、OLE DB Driver for SQL Server では、ITransaction::Commit パラメーターを次のように実装します。
| パラメーター | 説明 |
|---|---|
| fRetaining[in] | TRUE のときは、セッションの新しいトランザクションが暗黙的に開始されます。 このトランザクションは、コンシューマーがコミットまたは終了する必要があります。 FALSE のときは、OLE DB Driver for SQL Server のセッションのモードが自動コミット モードに戻ります。 |
| grfTC[in] | OLE DB Driver for SQL Server では、非同期応答と 1 フェーズの応答がサポートされていません。 XACTTC_SYNC 以外の値を指定すると、OLE DB Driver for SQL Server からは XACT_E_NOTSUPPORTED が返されます。 |
| grfRM[in] | 0 を指定する必要があります。 |
セッションの OLE DB Driver for SQL Server の行セットは、行セット プロパティ DBPROP_ABORTPRESERVE と DBPROP_COMMITPRESERVE の値に基づいて、ローカル コミット操作時またはアボート操作時に保存されます。 既定では、これらのプロパティの値はどちらも VARIANT_FALSE で、セッションのすべての OLE DB Driver for SQL Server の行セットはすべて、アボート操作またはコミット操作が行われると失われます。
OLE DB Driver for SQL Server では、ITransactionObject インターフェイスが実装されません。 このインターフェイスへの参照を取得しようとすると、コンシューマーは E_NOINTERFACE を返します。
次の例では、ITransactionLocal を使用します。
// Interfaces used in the example.
IDBCreateSession* pIDBCreateSession = NULL;
ITransaction* pITransaction = NULL;
IDBCreateCommand* pIDBCreateCommand = NULL;
IRowset* pIRowset = NULL;
HRESULT hr;
// Get the command creation and local transaction interfaces for the
// session.
if (FAILED(hr = pIDBCreateSession->CreateSession(NULL,
IID_IDBCreateCommand, (IUnknown**) &pIDBCreateCommand)))
{
// Process error from session creation. Release any references and
// return.
}
if (FAILED(hr = pIDBCreateCommand->QueryInterface(IID_ITransactionLocal,
(void**) &pITransaction)))
{
// Process error. Release any references and return.
}
// Start the local transaction.
if (FAILED(hr = ((ITransactionLocal*) pITransaction)->StartTransaction(
ISOLATIONLEVEL_REPEATABLEREAD, 0, NULL, NULL)))
{
// Process error from StartTransaction. Release any references and
// return.
}
// Get data into a rowset, then update the data. Functions are not
// illustrated in this example.
if (FAILED(hr = ExecuteCommand(pIDBCreateCommand, &pIRowset)))
{
// Release any references and return.
}
// If rowset data update fails, then terminate the transaction, else
// commit. The example doesn't retain the rowset.
if (FAILED(hr = UpdateDataInRowset(pIRowset, bDelayedUpdate)))
{
// Get error from update, then terminate.
pITransaction->Abort(NULL, FALSE, FALSE);
}
else
{
if (FAILED(hr = pITransaction->Commit(FALSE, XACTTC_SYNC, 0)))
{
// Get error from failed commit.
}
}
if (FAILED(hr))
{
// Update of data or commit failed. Release any references and
// return.
}
// Release any references and continue.