Share via

Функция JetBeginExternalBackup

  • Статья

Применимо к: Windows | Windows Server

Функция JetBeginExternalBackup

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

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

Резервная копия будет нечеткой, так как она будет согласована с одной точкой во времени в журнале транзакций, но управлять точной точкой во времени невозможно.

    JET_ERR JET_API JetBeginExternalBackup(
      __in          JET_GRBIT grbit
    );

Параметры

grbit

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

Значение

Значение

JET_bitBackupAtomic

Этот флаг является нерекомендуемой. Использование этого бита приведет к возврату JET_errInvalidgrbit.

JET_bitBackupIncremental

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

JET_bitBackupSnapshot

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

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

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

Код возврата

Описание

JET_errSuccess

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

JET_errBackupInProgress

Если внешняя резервная копия или snapshot уже выполняется, эта ошибка будет возвращена до вызова JetBeginExternalBackup (или одного из вариантов). ESE позволяет одновременно выполнять только одно оперативное резервное копирование.

JET_errBackupNotAllowedYet

Экземпляр или ядро СУБД находится на этапе восстановления или завершения работы.

JET_errCheckpointCorrupt

При полной резервной копии не удалось прочитать файл контрольной точки или не удалось проверить файл.

JET_errCheckpointFileNotFound

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

JET_errClientRequestToStopJetService

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

JET_errInstanceUnavailable

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

Windows XP: Это возвращаемое значение появилось в Windows XP.

JET_errInvalidBackup

Циклическое ведение журнала включено, и указанный тип резервной копии JET_bitBackupIncremental. Сведения о том, как управлять циклическим или некругим ведением журнала, см. в JET_paramCircularLog в журнале транзакций .

JET_errInvalidgrbit

Один или несколько элементов grbit были недопустимы.

JET_errLoggingDisabled

Восстановление или ведение журнала отключено. Вы не сможете выполнить оперативную архивацию, если ведение журнала отключено. Дополнительные сведения о ведении журнала и восстановлении см. в разделе JET_paramRecovery.

JET_errLogWriteFail

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

JET_errMissingFullBackup

Была указана добавочная резервная копия (с JET_bitBackupIncremental) и никогда не была полной резервной копией, выполненной для одной из подключенных баз данных для набора ведения журнала.

JET_errNotInitialized

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

JET_errOutOfMemory

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

JET_errRestoreInProgress

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

JET_errRunningInMultiInstanceMode

Операция завершилась сбоем, так как была предпринята попытка использовать подсистему в устаревшем режиме (режим совместимости с Windows 2000), где поддерживается только один экземпляр, если на самом деле уже существует несколько экземпляров.

JET_errTermInProgress

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

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

В случае сбоя функции сеанс резервного копирования не будет инициирован. Если выполняется еще один сеанс резервного копирования, он не будет отменен.

Комментарии

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

Общий порядок операций для полного резервного копирования состоит из следующих вызовов. Сначала вызывается JetBeginExternalBackup , чтобы запустить процесс резервного копирования. Затем вызывается JetGetAttachInfo , чтобы получить список баз данных, присоединенных к экземпляру, для которых необходимо создать резервную копию. Для каждой из этих баз данных вызывается JetOpenFile , за которым следует несколько вызовов JetReadFile , а затем вызов JetCloseFile. Затем вызывается JetGetLogInfo , чтобы получить список исправлений базы данных и файлов журналов для резервного копирования. Для каждого из этих файлов выполняется другая последовательность вызовов JetOpenFile, JetReadFile и JetCloseFile . Затем все нежелательные файлы журнала транзакций удаляются с помощью JetTruncateLog. Наконец, резервное копирование завершается вызовом JetEndExternalBackup.

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

Этот набор действий также можно изменить, чтобы разрешить последующие разностные резервные копии экземпляра. Чтобы выполнить разностное резервное копирование, не вызывайте JetTruncateLog в предыдущем полном или добавочном резервном копировании. Не вызывая JetTruncateLog, вы включаете разностные резервные копии по отношению к последней полной или добавочной резервной копии. Разностное резервное копирование возможно только в том случае, если циклическое ведение журнала не включено.

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

Требования

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

Клиент

Требуется Windows Vista, Windows XP или Windows 2000 Профессиональная.

Сервер

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

Верхняя часть

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

Библиотека

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

DLL

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

См. также:

JET_ERR
JET_GRBIT
JET_INSTANCE
JetAttachDatabase
JetBeginExternalBackupInstance
JetCloseFile
JetEndExternalBackup
JetEndExternalBackupInstance2
JetGetAttachInfo
JetGetLogInfo
JetOpenFile
JetReadFile
JetStopBackup
JetTruncateLog