Función JetBackupInstance

Se aplica a: Windows | Windows Server

Función JetBackupInstance

La función JetBackupInstance realiza una copia de seguridad de streaming de una instancia, incluidas todas las bases de datos adjuntas, en un directorio. Con varios métodos de copia de seguridad admitidos por el motor, esta es la función más sencilla y encapsulada.

Windows XP: JetBackupInstance se presenta en Windows XP.

    JET_ERR JET_API JetBackupInstance(
      __in          JET_INSTANCE instance,
      __in          JET_PCSTR szBackupPath,
      __in          JET_GRBIT grbit,
      __in          JET_PFNSTATUS pfnStatus
    );

Parámetros

instance

Instancia de la base de datos de la que se va a realizar una copia de seguridad.

szBackupPath

Directorio en el que se almacena la copia de seguridad. Si la ruta de acceso de la copia de seguridad es NULL para usar la función, se truncarán 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 creados desde la última copia de seguridad completa o incremental.
JET_bitBackupSnapshot	Reservado para uso futuro.

pfnStatus

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

Valor devuelto

Esta función devuelve el tipo de datos JET_ERR con uno de los códigos de retorno siguientes. Para obtener más información sobre los posibles errores del ESE, consulte Errores del motor de almacenamiento extensible y Parámetros de control de errores.

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 en la instancia asociada con la sesión cesó como resultado de una llamada a JetStopServiceInstance.
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. 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 ha pasado un parámetro no válido a la API.
JET_errInvalidPath	La ruta de acceso de destino no existe.
JET_errLoggingDisabled	La instancia se está ejecutando sin registro. No se permite ninguna copia de seguridad.
JET_errLogReadVerifyFailure	Se ha producido un error de comprobación de suma de comprobación en un archivo de registro.
JET_errLogWriteFail	El registro de la instancia está deshabilitado temporal o permanentemente debido a un error inesperado.
JET_errNotInitialized	No es posible completar la operación porque la instancia asociada a la sesión aún no se ha inicializado.
JET_errReadVerifyFailure	Se ha producido un error de comprobación de la suma de comprobación en una página de base de datos.
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. Windows XP: este valor devuelto se introduce en Windows XP.
JET_errTermInProgress	No es posible completar la operación porque la instancia asociada a la sesión se está cerrando.

Después de que la función se devuelva correctamente, en el directorio de copia de seguridad, todos los archivos necesarios para una restauración hasta el momento de la copia de seguridad estarán presentes. 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 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 y devolver la base de datos al estado en el momento de 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 la base de datos se actualizarán con la información cuando se haya realizado la última copia de seguridad.

Si se produce un error, 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.

Comentarios

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.

La copia de seguridad incremental solo es posible después de realizar una copia de seguridad completa. Además, las copias de seguridad incrementales solo son posibles si se desactiva el registro circular. Se recomienda que el directorio de copia de seguridad no contenga otros archivos además del involucrado en la copia de seguridad o el que se haya agregado en una copia de seguridad anterior completada correctamente.

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

La copia de seguridad realizará la comprobación de la 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 iniciará una nueva generación de registros. Esto permitirá copiar los archivos de registro necesarios porque el último necesario ya no estará en uso.

Se recomienda encarecidamente que la copia de seguridad no se use para otros fines distintos de la copia de seguridad y se restaure en el nivel de motor. Esto minimizará el cambio de obtención de errores durante las operaciones de copia de seguridad y restauración.

Requisitos

Requisito	Valor
Client	Requiere Windows Vista o Windows XP.
Server	Requiere Windows Server 2008 o Windows Server 2003.
Encabezado	Declarado en Esent.h.
Library	Use ESENT.lib.
Archivo DLL	Requiere ESENT.dll.
Unicode	Se ha implementado como JetBackupInstanceW (Unicode) y JetBackupInstanceA (ANSI).

Consulte también

JET_ERR
JET_GRBIT
JET_INSTANCE
JET_PFNSTATUS
JetRestore
JetRestore2
JetRestoreInstance
JetStopServiceInstance
Parámetros del sistema