Поддержка локальных транзакций в собственном клиенте SQL Server

Применимо: SQL Server База данных SQL Azure Управляемый экземпляр SQL Azure azure Synapse Analytics Analytics Platform System (PDW)

Область транзакций разделителя сеанса для локальной транзакции поставщика OLE DB собственного клиента SQL Server. Когда в направлении потребителя поставщик OLE DB собственного клиента SQL Server отправляет запрос в подключенный экземпляр SQL Server, запрос представляет собой единицу работы для поставщика OLE DB собственного клиента SQL Server. Локальные транзакции всегда упаковывают одну или несколько единиц работы в одном сеансе поставщика OLE DB собственного клиента SQL Server.

С помощью режима автокомментирования поставщика OLE DB для собственного клиента SQL Server по умолчанию одна единица работы рассматривается как область локальной транзакции. В локальной транзакции участвует только одна единица работы. При создании сеанса поставщик OLE DB собственного клиента SQL Server начинает транзакцию для сеанса. При успешном завершении единицы работы выполненная работа фиксируется. При сбое выполняется откат всей начатой работы; потребителю сообщается об ошибке. В любом случае поставщик OLE DB собственного клиента SQL Server начинает новую локальную транзакцию для сеанса, чтобы все операции выполнялись в рамках транзакции.

Потребитель поставщика OLE DB собственного клиента SQL Server может направлять более точный контроль над областью локальной транзакции с помощью интерфейса ITransactionLocal . Если сеанс потребителя инициирует транзакцию, все рабочие единицы сеанса между точкой начала транзакции и последующими неизбежными вызовами методов Commit или Abort рассматриваются как единая операция. Поставщик OLE DB собственного клиента SQL Server неявно начинает транзакцию при перенаправлении на это потребителем. Если потребитель не запрашивает хранения, сеанс восстанавливает режим родительской транзакции. Как правило, это режим автозавершения.

Поставщик OLE DB собственного клиента SQL Server поддерживает параметры ITransactionLocal::StartTransaction следующим образом.

Для локальных транзакций поставщик OLE DB собственного клиента SQL Server реализует параметры ITransaction::Abort следующим образом.

Для локальных транзакций поставщик OLE DB собственного клиента SQL Server реализует параметры ITransaction::Commit следующим образом.

Наборы строк поставщика OLE DB для собственного клиента SQL Server сохраняются в локальной операции фиксации или прерывания на основе значений свойств набора строк DBPROP_ABORTPRESERVE и DBPROP_COMMITPRESERVE. По умолчанию эти свойства являются как VARIANT_FALSE, так и все наборы строк поставщика OLE DB собственного клиента SQL Server в сеансе теряются после операции прерывания или фиксации.

Поставщик OLE DB собственного клиента 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.  

См. также

Транзакции
Работа с изоляцией моментального снимка