Funzione JetDefragment2

Si applica a: Windows | Windows Server

Funzione JetDefragment2

La funzione JetDefragment2 avvia e arresta le attività di deframmentazione del database che migliorano l'organizzazione dei dati all'interno di un database, con un parametro di callback disponibile per segnalare lo stato di avanzamento della deframmentazione. Questa operazione viene eseguita per limitare l'aumento della crescita del database usando l'allocazione del disco esistente in modo più efficiente all'interno del database. Può anche ridurre il working set assicurandosi che i dati siano più strettamente compressi. Infine, può migliorare le prestazioni dell'applicazione accelerando le operazioni comuni tramite un'organizzazione dei dati migliore.

Windows XP:JetDefragment2 è stato introdotto in Windows XP.

JetDefragment2 contiene anche un parametro di funzione di callback usato per segnalare lo stato di avanzamento del processo di deframmentazione.

La deframmentazione del database è un'operazione online e non interrompe attività regolari del database, ad esempio operazioni di query o aggiornamenti dei dati. JetDefragment2 non crea anche una copia di tutti i dati esistenti. Al contrario, deframmenta un database sul posto. Infine, JetDefragment2 recupera lo spazio interno del database per il riutilizzo, ma non rilascia spazio in eccesso nel file system del sistema operativo.

Il formato risultante dei dati può essere molto più efficiente, ma in genere non è ottimale. La deframmentazione è limitata al rilascio di pagine di database per il riutilizzo che contengono dati già eliminati logicamente. La deframmentazione rende disponibili anche le pagine di database per il riutilizzo in alcuni casi combinando i dati di due pagine quando possono essere incluse in una singola pagina.

Questa operazione è diversa da JetCompact , che crea una copia di un database di sola lettura in un formato estremamente ottimale.

JET_ERR JET_API JetDefragment2(
  __in          JET_SESID sesid,
  __in          JET_DBID dbid,
  __in          JET_PCSTR szTableName,
  __out_opt     unsigned long* pcPasses,
  __out_opt     unsigned long* pcSeconds,
  __in          JET_CALLBACK callback,
  __in          JET_GRBIT grbit
);

Parametri

sesid

Sessione da utilizzare per questa chiamata.

dbid

Database da deframmentare.

szTableName

A volte szTableName è obbligatorio e talvolta è vietato:

grbit	szTableName
JET_bitDefragmentBTreeBatch	Deve essere NULL.
JET_bitDefragmentBTree	Specifica il nome della tabella/BTree da deframmentare.
Altro	Deve essere NULL.

La deframmentazione viene eseguita per l'intero database descritto dall'ID del database specificato.

pcPasses

Quando si avvia un'attività di deframmentazione online, questo parametro di input facoltativo imposta il numero massimo di passaggi di deframmentazione. Quando si arresta un'attività di deframmentazione online, questo buffer di output facoltativo viene impostato sul numero di passaggi eseguiti.

Quando questo parametro è impostato su NULL, il numero di passaggi di deframmentazione online è illimitato.

pcSeconds

Quando si avvia un'attività di deframmentazione online, questo parametro di input facoltativo imposta il tempo massimo per la deframmentazione. Quando si arresta un'attività di deframmentazione online, questo buffer di output facoltativo viene impostato sul periodo di tempo utilizzato per la deframmentazione.

Quando questo parametro è impostato su NULL o se pcSeconds punta a un valore negativo, il tempo massimo per la deframmentazione è illimitato.

callback

Funzione di callback che effettua la deframmentazione chiama regolarmente per segnalare lo stato di avanzamento.

grbit	szTableName
JET_bitDefragmentBTreeBatch	Deve essere NULL.
JET_bitDefragmentBTree	Deve essere NULL.
Altro	Facoltativa.

grbit

Un gruppo di bit che specifica zero o più delle opzioni seguenti.

Valore	Significato
JET_bitDefragmentAvailSpaceTreesOnly	Questa opzione viene usata per deframmentare la parte di spazio disponibile dell'allocazione dello spazio del database ESE. Lo spazio del database è suddiviso in due tipi, spazio di proprietà e spazio disponibile. Lo spazio di proprietà viene allocato a una tabella o a un indice, mentre lo spazio disponibile è pronto per l'uso rispettivamente all'interno della tabella o dell'indice. Lo spazio disponibile è molto più dinamico nel comportamento e richiede una deframmentazione online maggiore rispetto allo spazio di proprietà, alla tabella o ai dati dell'indice.
JET_bitDefragmentBatchStart	Questa opzione viene usata per avviare una nuova attività di deframmentazione.
JET_bitDefragmentBatchStop	Questa opzione viene usata per arrestare un'attività di deframmentazione avviata esistente.
JET_bitDefragmentBTree	Questa opzione viene usata per deframmentare un albero B, specificato da szTableName.
JET_bitDefragmentBTreeBatch	Questa opzione viene usata per chiamare OLD2 sull'intero database.

Valore restituito

Questa funzione restituisce il tipo di dati JET_ERR con uno dei codici restituiti seguenti. Per altre informazioni sui possibili errori ESE, vedere Errori del motore di archiviazione estendibile e parametri di gestione degli errori.

Codice restituito	Descrizione
JET_errSuccess	Operazione riuscita.
JET_errClientRequestToStopJetService	Non è possibile completare l'operazione perché tutte le attività sull'istanza associata alla sessione sono cessate a seguito di una chiamata a JetStopService.
JET_errDatabaseFileReadOnly	Il database scelto per la deframmentazione è di sola lettura e non può essere aggiornato in alcun modo, inclusa la deframmentazione.
JET_errDistributedTransactionAlreadyPreparedToCommit	La sessione specificata è pronta a eseguire il commit e non può iniziare nuovi aggiornamenti fino a quando non viene eseguito il commit o il rollback della transazione corrente.
JET_errInstanceUnavailable	Non è possibile 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. Questo errore verrà restituito solo da Windows XP e versioni successive.
JET_errInvalidDatabaseId	L'ID del database specificato non corrisponde a un database noto nell'istanza di .
JET_errNotInitialized	Non è possibile completare l'operazione perché l'istanza associata alla sessione non è ancora stata inizializzata.
JET_errRestoreInProgress	Non è possibile 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. Questo errore verrà restituito solo da Windows XP e versioni successive.
JET_errTermInProgress	Non è possibile completare l'operazione perché l'istanza associata alla sessione viene arrestata.
JET_errTransReadOnly	La sessione specificata ha privilegi di sola lettura e non può avviare un'attività che può eseguire un aggiornamento, inclusa la deframmentazione.
JET_errVersionStoreOutOfMemory	Questo errore si verifica quando le dimensioni configurate dell'archivio versioni non sono sufficienti per contenere tutti gli aggiornamenti in sospeso.
JET_wrnDefragAlreadyRunning	L'opzione JET_bitDefragmentBatchStart è stata passata, ma un'attività di deframmentazione è già in esecuzione nel database specificato.
JET_wrnDefragNotRunning	L'opzione JET_bitDefragmentBatchStop è stata passata, ma attualmente non è in esecuzione alcuna attività di deframmentazione.

In caso di esito positivo, viene eseguita l'azione richiesta di avviare un'attività di deframmentazione per i dati specificati con le opzioni specificate oppure l'azione di arresto di un'attività di deframmentazione esistente.

In caso di errore, l'azione richiesta di avviare o arrestare un processo di deframmentazione online non viene eseguita. Non si verificano altri effetti collaterali.

Commenti

La deframmentazione online è controllata sia da un'impostazione di parametro che da questa API. Il valore del parametro di sistema predefinito è JET_OnlineDefragAll, il che significa che la deframmentazione è abilitata per tutte le strutture di dati supportate. Tuttavia, usando JetSetSystemParameter, è possibile disabilitare la deframmentazione online o abilitarla in modo selettivo solo per alberi dello spazio del database, solo database, solo file di streaming o qualsiasi combinazione di queste opzioni. Se l'impostazione di sistema per la deframmentazione on-line è un'impostazione obsoleta, JetDefragment2 considererà l'impostazione come JET_OnlineDefragAll.

È possibile eseguire al massimo un'attività per ogni database. L'attività viene eseguita come thread nel processo che ospita ESE.

La sessione utilizzata per avviare l'attività di deframmentazione online può essere usata successivamente per le operazioni di database mentre l'attività di deframmentazione continua, perché l'attività di deframmentazione alloca la propria sessione. La sessione specificata viene usata solo per controllare le autorizzazioni associate alla sessione di avvio dell'attività e non viene effettivamente usata per le operazioni di deframmentazione stesse.

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 ESENT.lib.
DLL	Richiede ESENT.dll.
Unicode	Implementato come JetDefragment2W (Unicode) e JetDefragment2A (ANSI).

Vedere anche

JET_ERR
JET_SESID
JetCompact
JetDefragment
JetSetSystemParameter
JetStopService