Función JetBeginTransaction

Se aplica a: Windows | Windows Server

Función JetBeginTransaction

La función JetBeginTransaction hace que una sesión escriba una transacción y cree un nuevo punto de retorno. Se puede llamar a esta función más de una vez en una sola sesión para provocar la creación de puntos de retorno adicionales. Estos puntos de guardado se pueden usar para mantener o descartar de forma selectiva los cambios en el estado de la base de datos.

    JET_ERR JET_API JetBeginTransaction(
      __in          JET_SESID sesid
    );

Parámetros

sesid

Sesión que se va a usar para esta llamada.

Valor devuelto

Esta función devuelve el tipo de datos JET_ERR con uno de los siguientes códigos de retorno. Para obtener más información sobre los posibles errores de ESE, vea Extensible Storage Engine Errors and Error Handling Parameters.

Código devuelto

Descripción

JET_errSuccess

La operación se ha completado correctamente.

JET_errClientRequestToStopJetService

No es posible completar la operación porque toda la actividad de la instancia asociada a la sesión ha dejado de funcionar como resultado de una llamada a JetStopService.

JET_errInstanceUnavailable

No es posible completar la operación porque la instancia asociada a la sesión ha encontrado un error irrecuperable que requiere que se revoque el acceso a todos los datos para proteger la integridad de esos datos.

Este error solo se devolverá en Windows XP y versiones posteriores.

JET_errNotInitialized

No es posible completar la operación porque la instancia asociada a la sesión aún no se ha inicializado.

JET_errRestoreInProgress

No es posible completar la operación porque hay una operación de restauración en curso en la instancia asociada a la sesión.

JET_errSessionSharingViolation

No se puede usar la misma sesión para más de un subproceso al mismo tiempo. Este error solo se devolverá en Windows XP y versiones posteriores.

JET_errTermInProgress

No es posible completar la operación porque se está cerrando la instancia asociada a la sesión.

JET_errTransTooDeep

No se puede iniciar una nueva transacción porque la sesión ya está en la profundidad de punto de retorno máxima permitida por el motor de base de datos.

Si se ejecuta correctamente, la sesión proporcionada estará dentro de una transacción. Si la sesión estaba previamente dentro de una transacción, se creará un nuevo punto de guardado.

En caso de error, el estado transaccional de la sesión permanecerá sin cambios. No se producirá ningún cambio en el estado de la base de datos.

Observaciones

El motor de base de datos proporciona un modelo de aislamiento de instantáneas para sus transacciones. Esto significa que, cuando una sesión entra por primera vez en un estado transaccional, la sesión verá toda la base de datos inmovilizada en el tiempo al inicio de la transacción. Una sesión no necesita leer ningún dato porque siempre puede tener acceso a la versión adecuada de esos datos. Esto significa que una sesión que está actualizando datos nunca bloqueará una sesión diferente de la lectura de esos datos.

Otra implicación del uso del aislamiento de instantáneas es el modelo de bloqueo que se usa para las actualizaciones. El motor de base de datos concederá un bloqueo de escritura en un fragmento de datos determinado a la primera sesión que lo solicite. Este bloqueo de escritura se libera cuando la transacción se confirma o anula por completo de modo que la sesión ya no esté en una transacción. Mientras una sesión contiene un bloqueo de escritura, cualquier otra sesión que solicite el mismo bloqueo de escritura no se bloqueará hasta que el bloqueo de escritura esté disponible. En su lugar, esa segunda sesión producirá un error inmediatamente con JET_errWriteConflict. Para resolver este conflicto, la segunda sesión debe anular (o confirmar) su transacción por completo, esperar un pequeño período de tiempo para que la primera sesión confirme o anule su transacción y, a continuación, vuelva a iniciarse.

En compatibilidad con el aislamiento de instantáneas, el motor de base de datos almacena todas las versiones de todos los datos modificados en la memoria desde el momento en que se inició la transacción activa más antigua en cualquier sesión. Esto tiene implicaciones importantes para la aplicación. Cualquier comportamiento que haga que un gran número de versiones se compilen en memoria puede hacer que la instancia agote su tamaño máximo de almacén de versiones (consulte JET_paramMaxVerPages en Parámetros del sistema para obtener más información). Este comportamiento incluye, pero no se limita a actualizaciones muy grandes en una sola transacción y transacciones de ejecución muy larga. Como resultado, es muy importante configurar correctamente el tamaño del almacén de versiones para la carga transaccional esperada de la aplicación. También es importante tener mucho cuidado para limitar el número de actualizaciones realizadas en una sola transacción. Además, es importante realizar transacciones lo más breves posible en escenarios de carga alta.

Se recomienda encarecidamente que la aplicación siempre esté en el contexto de una transacción al llamar a las API de ESE que recuperan o actualizan datos. Si esto no se hace, el motor de base de datos ajustará automáticamente cada llamada API de ESE de este tipo en una transacción en nombre de la aplicación. El costo de estas transacciones muy cortas puede sumar rápidamente en algunos casos.

El comportamiento predeterminado del motor es restringir el uso de una sesión al mismo subproceso desde el momento en que se realiza la primera llamada a JetBeginTransaction hasta el momento en que se realiza la llamada coincidente a JetCommitTransaction o JetRollback . Este comportamiento se puede cambiar para quitar esta restricción estableciendo un contexto de sesión personalizado mediante JetSetSessionContext y JetResetSessionContext.

El motor de base de datos también admite modificaciones del esquema transaccional. Por ejemplo, es posible iniciar una nueva transacción, crear una tabla, agregar algunas columnas, crear un índice o dos y, a continuación, anular la transacción. Los elementos de esquema que se acaban de agregar se quitarán de la base de datos. También es posible mezclar modificaciones de esquema y actualizaciones normales de la base de datos en la misma transacción.

Requisitos

Requisito Value

Cliente

Requiere Windows Vista, Windows XP o Windows 2000 Professional.

Server

Requiere Windows Server 2008, Windows Server 2003 o Windows 2000 Server.

Encabezado

Declarado en Esent.h.

Library

Use ESENT.lib.

DLL

Requiere ESENT.dll.

Consulte también

JET_ERR
JET_GRBIT
JET_SESID
JetCommitTransaction
JetGetSystemParameter
JetResetSessionContext
JetRollback
JetSetSessionContext
JetStopService
Parámetros del sistema