enumerazione JET_param

Parametri di sistema ESENT.

Spazio dei nomi:Microsoft.Isam.Esent.Interop
Assemblea: Microsoft.Isam.Esent.Interop (in Microsoft.Isam.Esent.Interop.dll)

Sintassi

'Declaration
Public Enumeration JET_param
'Usage
Dim instance As JET_param
public enum JET_param

Members

Nome del membro Descrizione
SystemPath Questo parametro indica il percorso relativo o assoluto del file system della cartella che conterrà il file di checkpoint per l'istanza. Il percorso deve essere terminato con un carattere barra rovesciata, che indica che il percorso di destinazione è una cartella.
TempPath Questo parametro indica il percorso relativo o assoluto del file system della cartella o del file che conterrà il database temporaneo per l'istanza. Se il percorso è di una cartella che conterrà il database temporaneo, deve essere terminato con un carattere barra rovesciata.
LogFilePath Questo parametro indica il percorso relativo o assoluto del file system della cartella che conterrà i log delle transazioni per l'istanza. Il percorso deve essere terminato con un carattere barra rovesciata, che indica che il percorso di destinazione è una cartella.
Basename Questo parametro imposta il prefisso di tre lettere utilizzato per molti dei file usati dal motore di database. Ad esempio, il file di checkpoint è denominato EDB. CHK per impostazione predefinita perché EDB è il nome di base predefinito.
EventSource Questo parametro fornisce una stringa specifica dell'applicazione che verrà aggiunta a tutti i messaggi del log eventi generati dal motore di database. Ciò consente una semplice correlazione dei messaggi del log eventi con l'applicazione di origine. Per impostazione predefinita, verrà usato il nome eseguibile dell'applicazione host.
MaxSessions Questo parametro riserva il numero richiesto di risorse di sessione da usare da un'istanza. Una risorsa sessione corrisponde direttamente a un tipo di dati JET_SESID. Questa impostazione influisce sul numero di sessioni che possono essere usate contemporaneamente.
MaxOpenTables Questo parametro riserva il numero richiesto di risorse albero B+ per l'uso da parte di un'istanza. Questa impostazione influisce sul numero di tabelle che possono essere usate contemporaneamente.
MaxCursors Questo parametro riserva il numero richiesto di risorse di cursore da usare da un'istanza. Una risorsa cursore corrisponde direttamente a un tipo di dati JET_TABLEID. Questa impostazione influisce sul numero di cursori che possono essere usati contemporaneamente. Non è possibile condividere una risorsa cursore da sessioni diverse in modo che questo parametro sia impostato su un valore sufficiente per consentire a ogni sessione di usare il numero di cursori necessario.
MaxVerPages Questo parametro riserva il numero richiesto di pagine dell'archivio versioni da usare da un'istanza.
MaxTemporaryTables Questo parametro riserva il numero richiesto di risorse di tabella temporanee da usare da un'istanza. Questa impostazione influisce sul numero di tabelle temporanee che possono essere usate contemporaneamente. Se questo parametro di sistema è impostato su zero, non verrà creato alcun database temporaneo e qualsiasi attività che richiede l'uso del database temporaneo avrà esito negativo. Questa impostazione può essere utile per evitare che l'I/O richiesto per creare il database temporaneo se è noto che non verrà usato.

L'uso di una tabella temporanea richiede anche una risorsa cursore.

LogFileSize Questo parametro configura le dimensioni dei file di log delle transazioni. Ogni file di log delle transazioni è una dimensione fissa. Le dimensioni sono uguali all'impostazione di questo parametro di sistema in unità di 1024 byte.
LogBuffers Questo parametro configura la quantità di memoria usata per memorizzare nella cache i record di log prima di essere scritti nel file di log delle transazioni. L'unità per questo parametro è la dimensione del settore del volume che contiene i file di log delle transazioni. La dimensione del settore è quasi sempre 512 byte, quindi è sicuro presupporre che le dimensioni per l'unità. Questo parametro ha un impatto sulle prestazioni. Quando il motore di database è in carico di aggiornamento elevato, questo buffer può diventare pieno molto rapidamente. Una dimensione della cache maggiore per il file di log delle transazioni è fondamentale per ottenere prestazioni di aggiornamento ottimali in una condizione di carico elevata. Il valore predefinito è noto come troppo piccolo per questo caso. Non impostare questo parametro su un numero di buffer di dimensioni maggiori (in byte) rispetto alla metà delle dimensioni di un file di log delle transazioni.
CircularLog Questo parametro configura la modalità di gestione dei file di log delle transazioni dal motore di database. Quando la registrazione circolare è disattivata, tutti i file di log delle transazioni generati vengono mantenuti su disco finché non sono più necessari perché è stato eseguito un backup completo del database. Quando la registrazione circolare è attiva, solo i file di log delle transazioni più giovani del checkpoint corrente vengono conservati su disco. Il vantaggio di questa modalità è che i backup non sono necessari per ritirare i file di log delle transazioni precedenti.
DbExtensionSize Questo parametro controlla la quantità di spazio aggiunta a un file di database ogni volta che deve crescere per gestire più dati. Le dimensioni sono contenute nelle pagine del database.
PageTempDBMin Questo parametro controlla le dimensioni iniziali del database temporaneo. Le dimensioni sono contenute nelle pagine del database. Una dimensione pari a zero indica che deve essere usata la dimensione predefinita di un database normale. Spesso è consigliabile configurare il database temporaneo per le piccole applicazioni per essere il più piccolo possibile. L'impostazione di questo parametro su SystemParameters.PageTempDBSmallest otterrà il database temporaneo più piccolo possibile.
CacheSizeMax Questo parametro configura le dimensioni massime della cache delle pagine del database. Le dimensioni sono contenute nelle pagine del database. Se questo parametro viene lasciato al valore predefinito, la dimensione massima della cache verrà impostata sulla dimensione della memoria fisica quando viene chiamato JetInit.
CheckpointDepthMax Questo parametro controlla il modo in cui le pagine del database vengono scaricate dalla cache della pagina del database per ridurre al minimo il tempo necessario per il ripristino da un arresto anomalo. Il parametro è una soglia in byte per il numero di file di log delle transazioni da riprodurre dopo un arresto anomalo. Se la registrazione circolare è abilitata usando JET_param. CircularLog controlla quindi anche la quantità approssimativa di file di log delle transazioni che verranno conservati su disco.
In sospesoIOMax Questo parametro controlla il numero di file di database I/Os in coda per disco nel sistema operativo host alla volta. Un valore più grande per questo parametro può contribuire in modo significativo alle prestazioni di un'applicazione di database di grandi dimensioni.
StartFlushThreshold Questo parametro controlla quando la cache della pagina del database inizia a rimuovere le pagine dalla cache per rendere disponibile spazio per le pagine non memorizzate nella cache. Quando il numero di buffer di pagine nella cache scende al di sotto di questa soglia, verrà avviato un processo in background per rifornire tale pool di buffer disponibili. Questa soglia è sempre relativa alla dimensione massima della cache impostata da JET_paramCacheSizeMax. Questa soglia deve essere sempre minore della soglia di arresto impostata da JET_paramStopFlushThreshold. L'altezza della distanza della soglia di inizio determina il tempo di risposta necessario per la cache delle pagine del database per produrre buffer disponibili prima che l'applicazione li richieda. Una soglia di inizio elevata darà più tempo al processo in background per reagire. Tuttavia, una soglia iniziale elevata implica una soglia di arresto superiore e che ridurrà le dimensioni effettive della cache delle pagine di database (Windows 2000) o per tutte le pagine (Windows XP e versioni successive).
StopFlushThreshold Questo parametro controlla quando la cache della pagina del database termina l'eliminazione delle pagine dalla cache per rendere disponibile spazio per le pagine non memorizzate nella cache. Quando il numero di buffer di pagine nella cache aumenta al di sopra di questa soglia, il processo in background avviato per rifornire tale pool di buffer disponibili viene arrestato. Questa soglia è sempre relativa alla dimensione massima della cache impostata da JET_paramCacheSizeMax. Questa soglia deve essere sempre maggiore della soglia iniziale impostata da JET_paramStartFlushThreshold. La distanza tra la soglia iniziale e la soglia di arresto influisce sull'efficienza con cui le pagine del database vengono scaricate dal processo in background. Un divario più grande renderà più probabile che le scritture nelle pagine adiacenti possano essere combinate. Tuttavia, una soglia di arresto elevata ridurrà le dimensioni effettive della cache della pagina del database per le pagine modificate (Windows 2000) o per tutte le pagine (Windows XP e versioni successive).
Ripristino Questo parametro è l'opzione master che controlla il ripristino di arresto anomalo del sistema per un'istanza di . Se questo parametro è impostato su "Attivato", verrà usato il ripristino dello stile ARIES per portare tutti i database nell'istanza a uno stato coerente in caso di arresto anomalo di un processo o di un computer. Se questo parametro è impostato su "Disattivato", tutti i database nell'istanza verranno gestiti senza il vantaggio del ripristino di arresto anomalo del sistema. Ciò significa che se l'istanza non viene arrestata correttamente usando JetTerm prima dell'uscita dal processo o l'arresto del computer, il contenuto di tutti i database in tale istanza sarà danneggiato.
EnableOnlineDefrag Questo parametro controlla il comportamento della deframmentazione online quando viene avviato usando JetDefragment(JET_SESID, JET_DBID, String, Int32, Int32, DefragGrbit) e JetDefragment2(JET_SESID, JET_DBID, String, Int32, Int32, JET_CALLBACK, DefragGrbit).
CacheSize Questo parametro può essere usato per controllare le dimensioni della cache delle pagine del database in fase di esecuzione. In genere, la cache ottimizza automaticamente le dimensioni come funzione dei livelli di attività del database e del computer. Se l'applicazione imposta questo parametro su zero, la cache ottimizza le proprie dimensioni in questo modo. Tuttavia, se l'applicazione imposta questo parametro su un valore diverso da zero, la cache si adatterà a tale dimensione di destinazione.
EnableIndexChecking Quando questo parametro è true, ogni database viene controllato in fase di jetAttachDatabase per gli indici sulle colonne chiave Unicode compilate usando una versione precedente della libreria NLS nel sistema operativo. Questa operazione deve essere eseguita perché il motore di database rende persistenti le chiavi di ordinamento generate da LCMapStringW e il valore di queste chiavi di ordinamento cambiano dal rilascio al rilascio. Se viene rilevato un indice primario in questo stato, JetAttachDatabase avrà sempre esito negativo con JET_err. PrimaryIndexCorrupted. Se vengono rilevati indici secondari in questo stato, esistono due possibili risultati. Se AttachDatabaseGrbit.DeleteCorruptIndexes è stato passato a JetAttachDatabase, questi indici verranno eliminati e JET_wrnCorruptIndexDeleted verranno restituiti da JetAttachDatabase. Questi indici dovranno essere ricreati dall'applicazione. Se AttachDatabaseGrbit.DeleteCorruptIndexes non è stato passato a JetAttachDatabase, la chiamata avrà esito negativo con JET_errSecondaryIndexCorrupted.
EventSourceKey Questo parametro può essere usato per controllare il registro eventi utilizzato dal motore di database per i messaggi del registro eventi. Per impostazione predefinita, tutti i messaggi del registro eventi verranno inviati al registro eventi dell'applicazione. Se il nome della chiave del Registro di sistema per un altro registro eventi è configurato, i messaggi del registro eventi verranno inseriti.
NoInformationEvent Quando questo parametro è true, i messaggi del registro eventi informativi che normalmente verrebbero generati dal motore di database verranno eliminati.
EventLoggingLevel Configura il livello di dettaglio dei messaggi del log eventi generati nel log eventi dal motore di database. I numeri più alti generano messaggi del log eventi più dettagliati.
DeleteOutOfRangeLogs Eliminare i file di log che non corrispondono (generazione saggia) durante il ripristino software.
CacheSizeMin Questo parametro configura le dimensioni minime della cache delle pagine del database. Le dimensioni sono contenute nelle pagine del database.
PreferredVerPages Questo parametro rappresenta una soglia relativa a MaxVerPages che controlla l'uso discrezionale delle pagine di versione dal motore di database. Se le dimensioni dell'archivio versioni superano questa soglia, tutte le informazioni usate solo per le attività in background facoltative, ad esempio il recupero dello spazio eliminato nel database, vengono sacrificate per mantenere spazio per le informazioni transazionali.
DatabasePageSize Questo parametro configura le dimensioni della pagina per il database. Le dimensioni della pagina sono l'unità di allocazione dello spazio più piccola possibile per un file di database. Anche le dimensioni della pagina del database sono molto importanti perché imposta il limite massimo per le dimensioni di un singolo record nel database.

Al momento è supportata una sola dimensione di pagina del database per ogni processo. Ciò significa che se si è in un singolo processo che contiene applicazioni diverse che usano il motore di database, tutti devono concordare le dimensioni di una pagina del database.

Errortostring Questo parametro può essere usato per convertire un JET_ERR in una stringa. Deve essere usato solo con JetGetSystemParameter.
RuntimeCallback Configura il motore con un delegato JET_CALLBACK . Questo callback può essere chiamato per i motivi seguenti: FreeCursorLS, FreeTableLS o Null. Per altre informazioni, vedere JetSetLS(JET_SESID, JET_TABLEID, JET_LS, LsGrbit). Impossibile recuperare questo parametro.
CleanupMismatchedLogFiles Questo parametro controlla il risultato di JetInit quando il motore di database è configurato per iniziare a usare i file di log delle transazioni su disco con dimensioni diverse rispetto a quelle configurate. In genere , JetInit(JET_INSTANCE) recupererà correttamente i database, ma avrà esito negativo con LogFileSizeMismatchDatabasesConsistent per indicare che le dimensioni del file di log non sono configurate correttamente. Tuttavia, quando questo parametro è impostato su true, il motore di database eliminerà automaticamente tutti i file di log precedenti, avviare un nuovo set di file di log delle transazioni usando le dimensioni del file di log configurate. Questo parametro è utile quando l'applicazione desidera modificare in modo trasparente le dimensioni del file di log delle transazioni, ma funziona ancora in modo trasparente negli scenari di aggiornamento e ripristino.
ExceptionAction Questo parametro controlla cosa accade quando viene generata un'eccezione dal motore di database o dal codice chiamato dal motore di database. Se impostato su JET_ExceptionMsgBox, qualsiasi eccezione verrà generata nel filtro delle eccezioni non gestite Windows. Ciò comporterà la gestione dell'eccezione come errore dell'applicazione. Lo scopo è impedire che il codice dell'applicazione tenti erroneamente di intercettare e ignorare un'eccezione generata dal motore di database. Ciò non può essere consentito perché potrebbe verificarsi un danneggiamento del database. Se l'applicazione vuole gestire correttamente queste eccezioni, la protezione può essere disabilitata impostando questo parametro su JET_ExceptionNone.
CreatePathIfNotExist Quando questo parametro è impostato su true, tutte le cartelle mancanti in un percorso del file system in uso dal motore di database verranno create automaticamente. In caso contrario, l'operazione che usa il percorso del file system mancante avrà esito negativo con JET_err. InvalidPath.
OneDatabasePerSession Quando questo parametro è true, è consentito aprire un solo database usando JetOpenDatabase da una determinata sessione contemporaneamente. Il database temporaneo viene escluso da questa restrizione.
MaxInstances Questo parametro controlla il numero massimo di istanze che è possibile creare in un singolo processo.
VersionStoreTaskQueueMax Questo parametro controlla il numero di elementi di lavoro di pulizia in background che possono essere accodati al pool di thread del motore di database in qualsiasi momento.

Vedi anche

Riferimento

Spazio dei nomi Microsoft.Isam.Esent.Interop