Поделиться через

Функция JetBackupInstance

  • Статья

Область применения: Windows | Windows Server

Функция JetBackupInstance

Функция JetBackupInstance выполняет потоковую резервную копию экземпляра, включая все подключенные базы данных в каталог. С несколькими методами резервного копирования, поддерживаемыми подсистемой, это самая простая и наиболее инкапсулируемая функция.

Windows XP: JetBackupInstance представлен в Windows XP.

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

Параметры

instance

Экземпляр базы данных для резервного копирования.

szBackupPath

Каталог, в котором хранится резервная копия. Если путь резервного копирования имеет значение NULL для использования функции, при возможности усечение журналов будет усечено.

гбит

Группа битов, указывающая ноль или более следующих параметров.

Значение

Значение

JET_bitBackupAtomic

Создает полную резервную копию базы данных. Это позволяет сохранить существующую резервную копию в том же каталоге, если новая резервная копия завершается ошибкой.

JET_bitBackupIncremental

Создает добавочную резервную копию, а не полную резервную копию. Это означает, что резервное копирование будет создано только с момента последнего полного или добавочного резервного копирования.

JET_bitBackupSnapshot

Зарезервировано для последующего использования.

pfnStatus

Указатель на функцию обратного вызова JET_PFNSTATUS , которая предоставляет сведения о ходе выполнения операции резервного копирования.

Возвращаемое значение

Эта функция возвращает тип данных JET_ERR с одним из следующих кодов возврата. Дополнительные сведения о возможных ошибках ESE см. в разделе Расширяемые служба хранилища ошибки ядра и параметры обработки ошибок.

Код возврата

Description

JET_errSuccess

Операция успешно завершена.

JET_errBackupInProgress

Резервная копия уже выполняется для того же экземпляра. Одновременно несколько резервных копий запрещены.

JET_errBackupNotAllowedYet

Экземпляр еще не готов к резервному копированию, так как он инициализируется.

JET_errClientRequestToStopJetService

Операция не может завершиться, так как все действия в экземпляре, связанном с сеансом, прекратились в результате вызова JetStopServiceInstance.

JET_errInstanceUnavailable

Операция не может завершиться, так как экземпляр, связанный с сеансом, столкнулся с неустранимой ошибкой, требующей отмены доступа ко всем данным для защиты целостности этих данных.

Windows XP: это возвращаемое значение представлено в Windows XP.

JET_errInvalidBackup

Добавочное резервное копирование не допускается, если циклическое ведение журнала включено.

JET_errInvalidGrbit

Указанные параметры недопустимы.

JET_errInvalidParameter

Недопустимый параметр был передан в API.

JET_errInvalidPath

Конечный путь не существует.

JET_errLoggingDisabled

Экземпляр выполняется без ведения журнала. Резервное копирование запрещено.

JET_errLogReadVerifyFailure

В файле журнала возникла ошибка проверки проверка sum.

JET_errLogWriteFail

Ведение журнала для экземпляра является временным или окончательно отключенным из-за непредвиденной ошибки.

JET_errNotInitialized

Операция не может завершиться, так как экземпляр, связанный с сеансом, еще не инициализирован.

JET_errReadVerifyFailure

На странице базы данных произошла ошибка проверки проверка сумма.

JET_errRestoreInProgress

Операция не может завершиться, так как операция восстановления выполняется в экземпляре, связанном с сеансом.

JET_errSessionSharingViolation

Один и тот же сеанс нельзя использовать для нескольких потоков одновременно.

Windows XP: это возвращаемое значение представлено в Windows XP.

JET_errTermInProgress

Операция не может завершиться, так как экземпляр, связанный с сеансом, завершается.

После успешного выполнения функции в каталоге резервных копий будут присутствовать все файлы, необходимые для восстановления до момента резервного копирования. Если это полная резервная копия, файлы базы данных будут файлами базы данных и файлами журналов, необходимыми для обеспечения согласованного состояния базы данных. Если это добавочная резервная копия, в каталоги будут добавлены только файлы журналов, но уже существующие файлы (базы данных и файлы журналов) вместе с новыми файлами журнала смогут восстановиться и вернуть базу данных в состояние в момент резервного копирования.

В качестве побочных эффектов резервной копии файлы журнала, которые больше не нужны, будут усечены.

В то же время заголовки базы данных будут обновлены с информацией, когда произошла последняя резервная копия.

При сбое файлы не будут находиться в месте назначения каталога резервного копирования, поэтому восстановление не будет возможным. В то же время текущие файлы журнала не будут усечены.

Замечания

В различных шагах резервной копии будут созданы записи журнала событий, включая имена файлов, усечение журнала и окончательный результат резервной копии.

Добавочное резервное копирование возможно только после создания полной резервной копии. Кроме того, добавочные резервные копии возможны только в том случае, если циклическое ведение журнала отключено. Рекомендуется, чтобы каталог резервного копирования не содержал другие файлы, а затем тот, который участвует в резервной копии или добавлен предыдущей успешной резервной копии.

Каталог резервного копирования должен существовать, если для экземпляра не задан параметр JET_paramCreatePathIfNotExist . Дополнительные сведения см. в разделе "Системные параметры".

Резервная копия также будет выполнять проверку проверка sum на всех используемых страницах базы данных и начиная с Windows Server 2003 в файлах журнала. Это дает возможность оценить работоспособность базы данных даже для страниц, которые не считываются во время обычных операций. Если будет обнаружена такая коррупция, резервная копия завершится ошибкой.

Во время резервного копирования текущий файл журнала будет завершен, и мы создадим новое поколение журналов. Это позволит копировать необходимые файлы журналов, так как последний необходимый больше не будет использоваться.

Настоятельно рекомендуется не использовать резервную копию для других целей, отличных от резервного копирования и восстановления на уровне ядра. Это приведет к минимизации изменений при получении ошибок во время операций резервного копирования и восстановления.

Requirements

Требование Значение

Клиент

Требуется Windows Vista или Windows XP.

Сервер

Требуется Windows Server 2008 или Windows Server 2003.

Верхний колонтитул

Объявлен в Esent.h.

Библиотека

Используйте ESENT.lib.

DLL

Требуется ESENT.dll.

Юникод

Реализован как JetBackupInstanceW (Юникод) и JetBackupInstanceA (ANSI).

См. также

JET_ERR
JET_GRBIT
JET_INSTANCE
JET_PFNSTATUS
JetRestore
JetRestore2
JetRestoreInstance
JetStopServiceInstance
Системные параметры