Función JetBackup

Se aplica a: Windows | Windows Server

Función JetBackup

La función JetBackup crea una copia de seguridad de la base de datos mientras la base de datos está en línea. Esta función es principalmente para la compatibilidad con versiones anteriores con los motores de base de datos de Windows 2000 y anteriores, donde solo se permite una instancia de una base de datos. En este caso, la instancia activa es la instancia de la que se realiza una copia de seguridad.

    JET_ERR JET_API JetBackup(
      __in          JET_PCSTR szBackupPath,
      __in          JET_GRBIT grbit,
      __in          JET_PFNSTATUS pfnStatus
    );

Parámetros

szBackupPath

Directorio donde se almacena la copia de seguridad. Si la ruta de acceso de copia de seguridad es NULL, la función truncará los registros, si es posible.

grbit

Un grupo de bits que especifica cero o más de las siguientes opciones.

Valor	Significado
JET_bitBackupAtomic	Crea una copia de seguridad completa de la base de datos. Esto permite conservar una copia de seguridad existente en el mismo directorio si se produce un error en la nueva copia de seguridad.
JET_bitBackupIncremental	Crea una copia de seguridad incremental en lugar de una copia de seguridad completa. Esto significa que solo se realizará una copia de seguridad de los archivos de registro desde la última copia de seguridad completa o incremental.

pfnStatus

Puntero a la JET_PFNSTATUS función de devolución de llamada, que proporciona información de notificación sobre el progreso de la operación de copia de seguridad.

Valor devuelto

La función devuelve uno de los códigos de error JET_ERR . A continuación se muestran los que se devuelven con más frecuencia. (Para obtener una lista completa de los errores de esta API, consulte Códigos de error del motor de almacenamiento extensible).

Código devuelto	Descripción
JET_errSuccess	La operación se ha completado correctamente.
JET_errBackupInProgress	Ya hay una copia de seguridad en curso para la misma instancia. No se permiten varias copias de seguridad al mismo tiempo.
JET_errBackupNotAllowedYet	La instancia aún no está lista para la copia de seguridad, ya que se está inicializando.
JET_errClientRequestToStopJetService	La operación no se puede completar 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	La operación no se puede completar 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. Windows XP: Este valor devuelto se introduce en Windows XP.
JET_errInvalidBackup	No se permite una copia de seguridad incremental si el registro circular está activado.
JET_errInvalidGrbit	Las opciones especificadas no son válidas.
JET_errInvalidParameter	Se pasó un parámetro no válido a la API.
JET_errInvalidPath	La ruta de acceso de destino no existe.
JET_errLoggingDisabled	La instancia se ejecuta sin registro. No se permite ninguna copia de seguridad.
JET_errLogReadVerifyFailure	Error de comprobación de suma de comprobación en un archivo de registro.
JET_errLogWriteFail	El registro de la instancia es temporal o permanentemente deshabilitado debido a un error inesperado.
JET_errNotInitialized	La operación no se puede completar porque la instancia asociada a la sesión aún no se ha inicializado.
JET_errReadVerifyFailure	Error de comprobación de suma de comprobación en una página de base de datos.
JET_errRestoreInProgress	La operación no se puede completar 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. Windows XP: Este valor devuelto se introduce en Windows XP.
JET_errTermInProgress	La operación no se puede completar porque la instancia asociada a la sesión se está cerrando.

Si la función se realiza correctamente, todos los archivos necesarios para una restauración hasta el momento de la copia de seguridad se incluirán en el directorio de copia de seguridad. Si se trata de una copia de seguridad completa, los archivos serán los archivos de base de datos y los archivos de registro necesarios para llevar la base de datos a un estado coherente. Si se trata de una copia de seguridad incremental, solo se agregarán los archivos de registro a los directorios, pero los archivos ya existentes (bases de datos y archivos de registro), junto con los nuevos archivos de registro, podrán restaurarse para devolver la base de datos al estado en el que se encontraba en el momento en que se inició la copia de seguridad.

Como efecto secundario de la copia de seguridad, los archivos de registro que ya no son necesarios se truncarán.

Al mismo tiempo, los encabezados de base de datos se actualizarán con la información cuando se haya realizado la última copia de seguridad.

Si se produce un error en la función, no habrá ningún archivo en el destino del directorio de copia de seguridad, por lo que no será posible realizar ninguna restauración. Al mismo tiempo, los archivos de registro actuales no se truncarán.

Observaciones

Los distintos pasos de la copia de seguridad tendrán entradas del registro de eventos generadas, incluidos los nombres de archivo, el truncamiento del registro y el resultado final de la copia de seguridad.

Las copias de seguridad incrementales solo son posibles después de realizar una copia de seguridad completa. Además, las copias de seguridad incrementales solo son posibles si el registro circular está desactivado. Se recomienda que el directorio de copia de seguridad no contenga ningún archivo distinto del utilizado en la copia de seguridad o agregado por una copia de seguridad correcta anterior.

El directorio de copia de seguridad debe existir a menos que se establezca el parámetro JET_paramCreatePathIfNotExist para la instancia. Para obtener información, vea Parámetros del sistema.

La copia de seguridad realizará una comprobación de suma de comprobación en todas las páginas de base de datos usadas y, a partir de Windows Server 2003, también en los archivos de registro. Esto ofrece la oportunidad de calcular el estado de la base de datos, incluso para las páginas que no se leen durante las operaciones normales. Si se detecta algún daño, se producirá un error en la copia de seguridad.

Durante la copia de seguridad, se finalizará el archivo de registro actual y se generará un nuevo registro. De este modo, todos los archivos de registro necesarios pueden ser copias, ya que el registro actual ya no estará en uso.

Se recomienda encarecidamente que la copia de seguridad no se use para ningún propósito que no sea la copia de seguridad y la restauración en el nivel de motor. Esto minimizará la posibilidad de obtener errores durante las operaciones de copia de seguridad y restauración.

Requisitos

Requisito	Value
Cliente	Requiere Windows Vista, Windows XP o Windows 2000 Professional.
Servidor	Requiere Windows Server 2008, Windows Server 2003 o Windows 2000 Server.
Encabezado	Declarado en Esent.h.
Library	Use ESENT.lib.
Archivo DLL	Requiere ESENT.dll.
Unicode	Se implementa como JetBackupW (Unicode) y JetBackupA (ANSI).

Consulte también

Archivos extensibles del motor de almacenamiento
JET_ERR
JET_GRBIT
JET_INSTANCE
JET_PFNSTATUS
JetRestore
JetRestore2
JetRestoreInstance
JetStopService
Parámetros del sistema