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.

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.

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

Vedi anche

JET_ERR
JET_GRBIT
JET_INSTANCE
JET_PFNSTATUS
JetRestore
JetRestore2
JetRestoreInstance
JetStopServiceInstance
Parametri di sistema