Apoyo a las transacciones locales

Una sesión delimita el ámbito de transacción para una transacción local del proveedor OLE DB de SQL Server Native Client. Cuando, en la dirección de un consumidor, el proveedor OLE DB de SQL Server Native Client envía una solicitud a una instancia conectada de SQL Server, la solicitud constituye una unidad de trabajo para el proveedor OLE DB de SQL Server Native Client. Las transacciones locales siempre encapsulan una o varias unidades de trabajo en una sola sesión de proveedor OLE DB de SQL Server Native Client.

Con el modo predeterminado de confirmación automática del proveedor OLE DB de SQL Server Native Client, una sola unidad de trabajo se trata como el ámbito de una transacción local. Solo una unidad participa en la transacción local. Cuando se crea una sesión, el proveedor OLE DB de SQL Server Native Client inicia una transacción para la sesión. Tras completar correctamente una unidad de trabajo, se confirma el trabajo. En caso de error, se revierte el trabajo iniciado y el error se notifica al consumidor. En cualquier caso, el proveedor OLE DB de SQL Server Native Client inicia una nueva transacción local para la sesión para que todo el trabajo se realice dentro de una transacción.

El consumidor del proveedor OLE DB de SQL Server Native Client puede dirigir un control más preciso sobre el ámbito de transacción local mediante la interfaz ITransactionLocal . Cuando una sesión de consumidor inicia una transacción, todas las unidades de trabajo de sesión entre el punto de inicio de la transacción y las llamadas de método Commit o Abort eventuales se tratan como una unidad atómica. El proveedor OLE DB de SQL Server Native Client inicia implícitamente una transacción cuando el consumidor lo dirige a hacerlo. Si el consumidor no solicita retención, la sesión se revierte al comportamiento de nivel de transacción principal, normalmente en modo de confirmación automática.

El proveedor OLE DB de SQL Server Native Client admite parámetros ITransactionLocal::StartTransaction como se indica a continuación.

En el caso de las transacciones locales, el proveedor OLE DB de SQL Server Native Client implementa los parámetros ITransaction::Abort como se indica a continuación.

En el caso de las transacciones locales, el proveedor OLE DB de SQL Server Native Client implementa los parámetros ITransaction::Commit como se indica a continuación.

Los conjuntos de filas del proveedor OLE DB de SQL Server Native Client en la sesión se conservan en una operación local de confirmación o anulación en función de los valores de las propiedades del conjunto de filas DBPROP_ABORTPRESERVE y DBPROP_COMMITPRESERVE. De forma predeterminada, estas propiedades son VARIANT_FALSE y todos los conjuntos de filas del proveedor OLE DB de SQL Server Native Client en la sesión se pierden después de una operación de anulación o confirmación.

El proveedor OLE DB de SQL Server Native Client no implementa la interfaz ITransactionObject . Un consumidor intenta recuperar una referencia en la interfaz devuelve E_NOINTERFACE.

En este ejemplo se usa 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.  

Véase también

Transacciones
Trabajar con aislamiento de instantáneas