Funzione JetBackupInstance

Si applica a: Windows | Windows Server

Funzione JetBackupInstance

La funzione JetBackupInstance esegue un backup di streaming di un'istanza, inclusi tutti i database collegati, in una directory. Con più metodi di backup supportati dal motore, questa è la funzione più semplice e incapsulata.

Windows XP: JetBackupInstance è stato introdotto in Windows XP.

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

Parametri

instance

Istanza del database di cui eseguire il backup.

szBackupPath

Directory in cui è archiviato il backup. Se il percorso di backup è NULL per usare la funzione tronca i log, se possibile.

grbit

Gruppo di bit che specificano zero o più delle opzioni seguenti.

valore	Significato
JET_bitBackupAtomic	Crea un backup completo del database. In questo modo è possibile conservare un backup esistente nella stessa directory se il nuovo backup ha esito negativo.
JET_bitBackupIncremental	Crea un backup incrementale anziché un backup completo. Ciò significa che verrà eseguito il backup solo dei file di log creati dopo l'ultimo backup completo o incrementale.
JET_bitBackupSnapshot	Riservato a un uso futuro.

pfnStatus

Puntatore alla funzione di callback JET_PFNSTATUS , che fornisce informazioni di notifica sullo stato di avanzamento dell'operazione di backup.

Valore restituito

Questa funzione restituisce il tipo di dati JET_ERR con uno dei codici restituiti seguenti. Per altre informazioni sui possibili errori E edizione Standard, vedere Extensible Archiviazione Engine Errors and Error Handling Parameters.For more information about the possible E edizione Standard errors, see Extensible Archiviazione Engine Errors and Error Handling Parameters.

Codice restituito	Descrizione
JET_errSuccess	Operazione riuscita.
JET_errBackupInProgress	Un backup è già in corso per la stessa istanza. Più backup non sono consentiti contemporaneamente.
JET_errBackupNotAllowedYet	L'istanza non è ancora pronta per il backup durante l'inizializzazione.
JET_errClientRequestToStopJetService	Impossibile completare l'operazione perché tutte le attività nell'istanza associata alla sessione non sono più state completate a seguito di una chiamata a JetStopServiceInstance.
JET_errInstanceUnavailable	Impossibile completare l'operazione perché l'istanza associata alla sessione ha rilevato un errore irreversibile che richiede la revoca dell'accesso a tutti i dati per proteggere l'integrità dei dati. Windows XP: questo valore restituito viene introdotto in Windows XP.
JET_errInvalidBackup	Un backup incrementale non è consentito se è attiva la registrazione circolare.
JET_errInvalidGrbit	Le opzioni specificate non sono valide.
JET_errInvalidParameter	Un parametro non valido è stato passato all'API.
JET_errInvalidPath	Il percorso di destinazione non esiste.
JET_errLoggingDisabled	L'istanza è in esecuzione senza registrazione. Non è consentito alcun backup.
JET_errLogReadVerifyFailure	Errore di verifica checksum in un file di log.
JET_errLogWriteFail	La registrazione per l'istanza è temporanea o permanentemente disabilitata a causa di un errore imprevisto.
JET_errNotInitialized	Impossibile completare l'operazione perché l'istanza associata alla sessione non è ancora stata inizializzata.
Jet_errreadverifyfailure	Errore di verifica checksum in una pagina del database.
JET_errRestoreInProgress	Impossibile completare l'operazione perché è in corso un'operazione di ripristino nell'istanza associata alla sessione.
JET_errSessionSharingViolation	La stessa sessione non può essere usata contemporaneamente per più thread. Windows XP: questo valore restituito viene introdotto in Windows XP.
JET_errTermInProgress	Impossibile completare l'operazione perché l'istanza associata alla sessione viene arrestata.

Dopo che la funzione ha esito positivo, nella directory di backup saranno presenti tutti i file necessari per un ripristino fino al momento del backup. Se si tratta di un backup completo, i file saranno i file di database e i file di log necessari per portare il database a uno stato coerente. Se si tratta di un backup incrementale, solo i file di log verranno aggiunti alle directory, ma i file già esistenti (database e file di log) insieme ai nuovi file di log potranno essere ripristinati e riportare il database allo stato al momento del backup.

Come effetto collaterale del backup, i file di log che non sono più necessari verranno troncati.

Allo stesso tempo, le intestazioni del database verranno aggiornate con le informazioni in cui è stato eseguito l'ultimo backup.

In caso di errore, non ci saranno file nella destinazione della directory di backup, quindi non sarà possibile ripristinare. Allo stesso tempo, i file di log correnti non verranno troncati.

Osservazioni:

I diversi passaggi del backup avranno voci del registro eventi generate, inclusi i nomi di file, il troncamento del log e il risultato finale del backup.

Il backup incrementale è possibile solo dopo l'esecuzione di un backup completo. Inoltre, i backup incrementali sono possibili solo se la registrazione circolare è disattivata. È consigliabile che la directory di backup non contenga altri file, quindi quello coinvolto nel backup o aggiunto da un backup con esito positivo precedente.

La directory di backup deve esistere a meno che il parametro JET_paramCreatePathIfNotExist non sia impostato per l'istanza. Per informazioni, vedere Parametri di sistema.

Il backup eseguirà la verifica checksum in tutte le pagine del database usate e a partire da Windows Server 2003, anche nei file di log. In questo modo è possibile stimare l'integrità del database anche per le pagine che non vengono lette durante le normali operazioni. Se si verifica un tale danneggiamento, il backup avrà esito negativo.

Durante il backup, il file di log corrente verrà completato e verrà avviata una nuova generazione di log. Ciò consentirà di copiare i file di log necessari perché l'ultimo file necessario non sarà più in uso.

È consigliabile non usare il backup per scopi diversi dal backup e ripristinato a livello di motore. In questo modo si ridurrà al minimo la modifica di errori durante le operazioni di backup e ripristino.

Requisiti

Requisito	valore
Client	Richiede Windows Vista o Windows XP.
Server	Richiede Windows Server 2008 o Windows Server 2003.
Intestazione	Dichiarato in Esent.h.
Libreria	Usare E edizione Standard NT.lib.
DLL	Richiede E edizione Standard NT.dll.
Unicode	Implementato come JetBackupInstanceW (Unicode) e JetBackupInstanceA (ANSI).

Vedi anche

JET_ERR
JET_GRBIT
JET_INSTANCE
JET_PFNSTATUS
JetRestore
JetRestore2
JetRestoreInstance
JetStopServiceInstance
Parametri di sistema