Ondersteuning voor lokale transacties

Van toepassing op:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform Systeem (PDW)SQL-database in Microsoft Fabric

OLE DB-stuurprogramma downloaden

Een sessie begrenst de transactiescope voor een OLE DB-driver voor SQL Server-lokale transacties. Wanneer de OLE DB Driver voor SQL Server op aanwijzing van een consument een verzoek indient bij een verbonden instantie van SQL Server, vormt het verzoek een eenheid van werk voor de OLE DB Driver voor SQL Server. Lokale transacties omvatten altijd één of meer eenheden werk op één OLE DB-driver voor SQL Server-sessies.

Met behulp van de standaard OLE DB Driver voor SQL Server autocommit-modus wordt één eenheid werk behandeld als de scope van een lokale transactie. Slechts één eenheid neemt deel aan de lokale transactie. Wanneer een sessie wordt aangemaakt, start de OLE DB-driver voor SQL Server een transactie voor de sessie. Na succesvolle voltooiing van een werkunit wordt het werk uitgevoerd. Bij een storing wordt elk begonnen werk teruggedraaid en wordt de fout aan de consument gemeld. In beide gevallen start de OLE DB Driver voor SQL Server een nieuwe lokale transactie voor de sessie, zodat al het werk binnen een transactie wordt uitgevoerd.

De OLE DB-driver voor SQL Server-consument kan nauwkeuriger controle uitoefenen over de lokale transactiescope door gebruik te maken van de ITransactionLocal-interface . Wanneer een consumentensessie een transactie initieert, worden alle sessiewerkunits tussen het transactiestartpunt en de uiteindelijke commit- of abort-methodeaanroepen behandeld als een atomaire eenheid. De OLE DB Driver voor SQL Server start impliciet een transactie wanneer de consument daartoe wordt opgedragen. Als de consument geen retentie aanvraagt, keert de sessie terug naar ouderlijk transactieniveau, meestal autocommit-modus.

De OLE DB-driver voor SQL Server ondersteunt ITransactionLocal::StartTransaction-parameters als volgt.

Voor lokale transacties implementeert de OLE DB Driver voor SQL Server de parameters ITransaction::Abort als volgt.

Voor lokale transacties implementeert de OLE DB Driver voor SQL Server de parameters ITransaction::Commit als volgt.

De OLE DB-driver voor SQL Server-rijsets in de sessie worden bewaard bij een lokale commit- of abort-operatie op basis van de waarden van de rijseteigenschappen DBPROP_ABORTPRESERVE en DBPROP_COMMITPRESERVE. Standaard zijn deze eigenschappen zowel VARIANT_FALSE en alle OLE DB-driveren voor SQL Server-rijsets in de sessie gaan verloren na een abort- of commit-operatie.

De OLE DB-driver voor SQL Server implementeert de ITransactionObject-interface niet. Een poging van de consument om een referentie op de interface op te halen levert E_NOINTERFACE op.

Dit voorbeeld gebruikt 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.  

Zie ook

Transacties
Werken met snapshot isolatie