ローカル トランザクションのサポート

セッションは、SQL Server Native Client OLE DB プロバイダーのローカル トランザクションのトランザクション スコープを区切ります。 コンシューマーの指示に応じて、SQL Server Native Client OLE DB プロバイダーが SQL Server の接続されたインスタンスに要求を送信すると、その要求は SQL Server Native Client OLE DB プロバイダーの作業単位を構成します。 ローカル トランザクションは、1 つの SQL Server Native Client OLE DB プロバイダー セッションで常に 1 つ以上の作業単位をラップします。

既定の SQL Server Native Client OLE DB プロバイダー自動コミット モードを使用すると、1 つの作業単位がローカル トランザクションのスコープとして扱われます。 ローカル トランザクションに参加するユニットは 1 つだけです。 セッションが作成されると、SQL Server Native Client OLE DB プロバイダーによってセッションのトランザクションが開始されます。 作業単位が正常に完了すると、作業はコミットされます。 エラーが発生すると、開始されたすべての作業がロールバックされ、エラーがコンシューマーに報告されます。 どちらの場合も、SQL Server Native Client OLE DB プロバイダーは、すべての作業がトランザクション内で実行されるように、セッションの新しいローカル トランザクションを開始します。

SQL Server Native Client OLE DB プロバイダー コンシューマーは、 ITransactionLocal インターフェイスを使用して、ローカル トランザクション スコープをより正確に制御できます。 コンシューマー セッションがトランザクションを開始すると、トランザクションの開始点と、最終的な Commit メソッドまたは Abort メソッド呼び出しの間のすべてのセッション作業単位がアトミック単位として扱われます。 SQL Server Native Client OLE DB プロバイダーは、コンシューマーがトランザクションを開始するように指示されると、暗黙的にトランザクションを開始します。 コンシューマーがリテンション期間を要求しない場合、セッションは親トランザクション レベルの動作 (最も一般的な自動コミット モード) に戻ります。

SQL Server Native Client OLE DB プロバイダーでは、次のように ITransactionLocal::StartTransaction パラメーターがサポートされています。

ローカル トランザクションの場合、SQL Server Native Client OLE DB プロバイダーは ITransaction::Abort パラメーターを次のように実装します。

ローカル トランザクションの場合、SQL Server Native Client OLE DB プロバイダーは ITransaction::Commit パラメーターを次のように実装します。

セッションの SQL Server Native Client OLE DB プロバイダー行セットは、DBPROP_ABORTPRESERVEおよびDBPROP_COMMITPRESERVE行セットのプロパティの値に基づいて、ローカルコミットまたは中止操作で保持されます。 既定では、これらのプロパティは両方ともVARIANT_FALSEであり、セッション上のすべての SQL Server Native Client OLE DB プロバイダー行セットは、中止またはコミット操作の後に失われます。

SQL Server Native Client OLE DB プロバイダーは 、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.  

こちらもご覧ください

トランザクション
スナップショット分離の使用