Stöd för lokala transaktioner i SQL Server Native Client

gäller för:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics

En session avgränsar transaktionsomfattningen för en lokal transaktion med SQL Server Native Client OLE DB-leverantör. När SQL Server Native Client OLE DB-leverantören på uppdrag av en konsument skickar in en förfrågan till en ansluten instans av SQL Server, utgör förfrågan en arbetsenhet för SQL Server Native Client OLE DB-leverantören. Lokala transaktioner omsluter alltid en eller flera arbetsenheter på en enda SQL Server Native Client OLE DB-leverantörssession.

Med standardläget för autocommit i SQL Server Native Client OLE DB behandlar en enda arbetsenhet som omfattningen av en lokal transaktion. Endast en enhet deltar i den lokala transaktionen. När en session skapas påbörjar SQL Server Native Client OLE DB-leverantören en transaktion för sessionen. Efter att en arbetsenhet har slutförts framgångsrikt genomförs arbetet i arbetet. Vid misslyckande rullas allt påbörjat arbete tillbaka och felet rapporteras till konsumenten. I båda fallen startar SQL Server Native Client OLE DB-leverantören en ny lokal transaktion för sessionen så att allt arbete utförs inom en transaktion.

Konsumenten av SQL Server Native Client OLE DB-leverantör kan styra mer exakt kontroll över det lokala transaktionsområdet genom att använda ITransactionLocal-gränssnittet. När en konsumentsession initierar en transaktion behandlas alla sessionsarbetsenheter mellan transaktionens startpunkt och de slutliga Commit - eller Abort-metodanropen som en atomär enhet. SQL Server Native Client OLE DB-leverantören påbörjar implicit en transaktion när konsumenten ber om det. Om konsumenten inte begär retention återgår sessionen till föräldratransaktionsnivåbeteende, oftast autocommitt-läge.

SQL Server Native Client OLE DB-leverantören stöder ITransactionLocal::StartTransaction-parametrarna enligt följande.

För lokala transaktioner implementerar SQL Server Native Client OLE DB-leverantören ITransaction::Abort-parametrarna enligt följande.

För lokala transaktioner implementerar SQL Server Native Client OLE DB-leverantören ITransaction::Commit-parametrar enligt följande.

De SQL Server Native Client OLE DB-leverantörens raduppsättningar på sessionen bevaras i en lokal commit- eller avbrytoperation baserat på värdena för raduppsättningens egenskaper DBPROP_ABORTPRESERVE och DBPROP_COMMITPRESERVE. Som standard är dessa egenskaper både VARIANT_FALSE och alla raduppsättningar SQL Server Native Client OLE DB-leverantören på sessionen förloras efter en avbryt- eller commit-operation.

SQL Server Native Client OLE DB-leverantören implementerar inte ITransactionObject-gränssnittet. Ett konsumentförsök att hämta en referens på gränssnittet ger E_NOINTERFACE.

Detta exempel använder 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.  

Relaterat innehåll

• Transaktioner i SQL Server Native Client
• Att arbeta med Snapshot Isolation i SQL Server Native Client