Função JetRestore2

Aplica-se a: Windows | Windows Server

Função JetRestore2

O JetRestore2 restaura e recupera um backup de streaming de uma instância, incluindo todos os bancos de dados anexados. Essa função é principalmente para compatibilidade com versões anteriores com o Windows 2000 e mecanismos de banco de dados anteriores, em que apenas uma instância de um banco de dados é permitida. Nesse caso, a instância ativa é a instância restaurada.

    JET_ERR JET_API JetRestore2(
      __in          JET_PCSTR sz,
      __in_opt      JET_PCSTR szDest,
      __in          JET_PFNSTATUS pfn
    );

Parâmetros

sz

A pasta em que o backup está localizado. O backup deveria ter sido gerado usando as APIs do JetBackup .

szDest

Nome da pasta em que os arquivos de banco de dados do conjunto de backup serão copiados e recuperados. Se isso for definido como NULL (que é o caso do JetRestore herdado), os arquivos de banco de dados serão copiados e recuperados para o local original.

pfn

O ponteiro opcional para a função que será chamada como informações de notificação sobre o progresso da operação de restauração.

Valor Retornado

Essa função retorna o tipo de dados JET_ERR com um dos seguintes códigos de retorno. Para obter mais informações sobre os possíveis erros do ESE, consulte Erros extensíveis do mecanismo de armazenamento e parâmetros de tratamento de erros.

Com êxito, os arquivos de banco de dados do conjunto de backup serão restaurados para o local e a recuperação será executada de modo que os bancos de dados estejam em um estado de consistência transacional limpo. A recuperação reproduzirá os arquivos de log do conjunto de backup e os arquivos de log do caminho de log se esses arquivos existirem. Essa recuperação resultará em alterações no arquivo de ponto de verificação, nos arquivos de log de transações e nos bancos de dados referenciados por esses arquivos de log de transações.

Em caso de falha, a instância permanece em um estado não inicializado. O estado dos arquivos de log de transações e todos os bancos de dados referenciados por esses arquivos de log de transações provavelmente foram alterados na tentativa de inicializar a restauração e recuperar os bancos de dados.

Comentários

O processo de recuperação reconstruirá os bancos de dados anexados à instância durante o backup e salvará as alterações nos arquivos de banco de dados. O resultado serão bancos de dados consistentes com a transação. Se possível, ele também salvará no banco de dados as alterações feitas desde que o backup foi feito até a alteração mais recente encontrada nos logs de transações. Isso seria possível se os logs de transação gerados desde que o backup foi feito ainda estejam presentes no diretório de log de transações. Observe que, se o log circular tiver sido habilitado para a instância, os logs de transação gerados serão reutilizados de modo que a recuperação possa salvar as alterações que ocorreram até o momento do backup. De qualquer forma, é possível que esse processo leve algum tempo se o número de arquivos de log de transações a serem reproduzidos nos bancos de dados for grande.

As funções JetRestore devem ser chamadas em uma instância antes que JetInit seja chamado para essa instância.

Como durante a recuperação um número significativo de páginas de banco de dados e logs de transações serão usados, há uma série inteira de erros que podem ser retornados por essas funções. Esses erros podem ser de falhas temporárias de alocação de recursos, como Jet_errOutOfMemory, a erros que representam corrupção física, como JET_errReadVerifyFailure, JET_errLogFileCorrupt ou JET_errBadPageLink. Esses erros são quase sempre causados por problemas de hardware e, portanto, não podem ser evitados. A má gestão de arquivos se manifestará com mais frequência como JET_errMissingLogFile ou JET_errAttachedDatabaseMismatch ou JET_errDatabaseSharingViolation ou JET_errInvalidLogSequence. Esses erros são evitáveis pelo aplicativo. O aplicativo deve ter cuidado para proteger o repositório desses arquivos contra manipulação por forças externas, como o usuário ou outros aplicativos. Se o aplicativo quiser destruir totalmente uma instância, todos os arquivos associados à instância deverão ser excluídos. Eles incluem o arquivo de ponto de verificação, os arquivos de log de transações e todos os arquivos de banco de dados anexados à instância.

As diferentes etapas da recuperação terão entradas do Log de Eventos geradas, incluindo o progresso da reprodução do log de transações e o resultado final da restauração.

Requisitos

Consulte Também

JET_ERR
JET_GRBIT
JET_INSTANCE
JetBackup
JetBackupInstance
JetCreateInstance
JetInit
JetRestore
JetRestoreInstance
JetSetSystemParameter