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 si trova in una cartella che conterrà il database temporaneo, deve essere terminata 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 usato per molti dei file usati dal motore di database. Ad esempio, il file del 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 registro eventi generati dal motore di database. In questo modo è possibile correlare facilmente i messaggi del registro 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 per l'uso da parte di un'istanza di . Una risorsa di sessione corrisponde direttamente a un tipo di dati JET_SESID. Questa impostazione influirà sul numero di sessioni che è possibile usare contemporaneamente.
MaxOpenTables	Questo parametro riserva il numero richiesto di risorse albero B+ per l'uso da parte di un'istanza di . Questa impostazione influirà sul numero di tabelle che possono essere usate contemporaneamente.
MaxCursors	Questo parametro riserva il numero richiesto di risorse di cursore per l'uso da parte di un'istanza di . Una risorsa cursore corrisponde direttamente a un tipo di dati JET_TABLEID. Questa impostazione influirà sul numero di cursori che possono essere usati contemporaneamente. Una risorsa cursore non può essere condivisa da sessioni diverse, pertanto questo parametro deve essere impostato su un valore sufficientemente grande in modo che ogni sessione possa usare il numero di cursori necessario.
MaxVerPages	Questo parametro riserva il numero richiesto di pagine dell'archivio versioni per l'uso da parte di un'istanza di .
MaxTemporaryTables	Questo parametro riserva il numero richiesto di risorse di tabella temporanee per l'uso da parte di un'istanza di . Questa impostazione influirà 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 l'I/O necessario 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 configurerà le dimensioni dei file di log delle transazioni. Ogni file di log delle transazioni è di dimensioni fisse. La dimensione è uguale all'impostazione di questo parametro di sistema in unità di misura di 1024 byte.
LogBuffers	Questo parametro configurerà la quantità di memoria usata per memorizzare nella cache i record di log prima che vengano 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. Le dimensioni del settore sono quasi sempre di 512 byte, quindi è possibile presupporre che le dimensioni per l'unità. Questo parametro ha un impatto sulle prestazioni. Quando il motore di database è sottoposto a un carico elevato di aggiornamento, questo buffer può diventare pieno molto rapidamente. Una dimensione della cache maggiore per il file di log delle transazioni è fondamentale per prestazioni di aggiornamento ottimali in condizioni di carico così elevate. Il valore predefinito è 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 consente di configurare 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 conservati su disco fino a quando non sono più necessari perché è stato eseguito un backup completo del database. Quando la registrazione circolare è attivata, solo i file di log delle transazioni più piccoli 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 contenere 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 è necessario utilizzare le dimensioni predefinite di un database normale. È spesso consigliabile che le applicazioni di piccole dimensioni configurino il database temporaneo in modo che siano il più piccolo possibile. L'impostazione di questo parametro su SystemParameters.PageTempDBSmallest consente di ottenere 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 sulle dimensioni della memoria fisica quando viene chiamato JetInit.
CheckpointDepthMax	Questo parametro controlla il modo in cui le pagine del database vengono scaricate dalla cache delle pagine 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 tramite JET_param. CircularLog quindi questo parametro controlla anche la quantità approssimativa di file di log delle transazioni che verranno conservati su disco.
OutstandingIOMax	Questo parametro controlla il numero di operazioni di I/O del file di database che possono essere accodate per disco nel sistema operativo host contemporaneamente. Un valore maggiore 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 delle pagine del database inizia a rimuovere le pagine dalla cache per liberare 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 ricostituire tale pool di buffer disponibili. Questa soglia è sempre relativa alla dimensione massima della cache impostata da JET_paramCacheSizeMax. Questa soglia deve essere sempre inferiore alla soglia di arresto impostata da JET_paramStopFlushThreshold. L'altezza della distanza della soglia di inizio determinerà il tempo di risposta che la cache delle pagine del database deve dover produrre buffer disponibili prima che l'applicazione li richieda. Una soglia di inizio elevata consentirà al processo in background di reagire più tempo. Tuttavia, una soglia di inizio elevata implica una soglia di arresto più elevata e ciò ridurrà le dimensioni effettive della cache delle pagine del database per le pagine modificate (Windows 2000) o per tutte le pagine (Windows XP e versioni successive).
StopFlushThreshold	Questo parametro controlla quando la cache delle pagine del database termina la rimozione delle pagine dalla cache per liberare spazio per le pagine non memorizzate nella cache. Quando il numero di buffer di pagine nella cache supera questa soglia, il processo in background avviato per rifornire il 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 di inizio impostata da JET_paramStartFlushThreshold. La distanza tra la soglia di inizio e la soglia di arresto influisce sull'efficienza con cui le pagine del database vengono scaricate dal processo in background. Un divario maggiore renderà più probabile che le scritture nelle pagine adiacenti possano essere combinate. Tuttavia, una soglia di arresto elevata ridurrà le dimensioni effettive della cache delle pagine 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 anomalo per un'istanza. Se questo parametro è impostato su "On", 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 "Off", tutti i database dell'istanza verranno gestiti senza il vantaggio del ripristino anomalo. Vale a dire che se l'istanza non viene arrestata in modo pulito usando JetTerm prima dell'uscita dal processo o l'arresto del computer, il contenuto di tutti i database in tale istanza verrà 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 adatta a tale dimensione di destinazione.
EnableIndexChecking	Quando questo parametro è true, ogni database viene controllato in JetAttachDatabase time 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 mantiene le chiavi di ordinamento generate da LCMapStringW e il valore di queste chiavi di ordinamento cambiano dalla versione alla versione. Se viene rilevato un indice primario in questo stato, JetAttachDatabase avrà sempre esito negativo con JET_err. PrimaryIndexCorrupted. Se gli indici secondari vengono rilevati in questo stato, esistono due possibili risultati. Se AttachDatabaseGrbit.DeleteCorruptIndexes è stato passato a JetAttachDatabase, questi indici verranno eliminati e JET_wrnCorruptIndexDeleted verrà restituito da JetAttachDatabase. Questi indici devono 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 usato dal motore di database per i messaggi del registro eventi. Per impostazione predefinita, tutti i messaggi del registro eventi verranno visualizzati nel 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 verranno generati dal motore di database verranno eliminati.
EventLoggingLevel	Configura il livello di dettaglio dei messaggi di eventlog generati nel log eventi dal motore di database. I numeri più elevati generano messaggi di eventlog più dettagliati.
DeleteOutOfRangeLogs	Eliminare i file di log che non corrispondono (generazione saggio) durante il ripristino temporanea.
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 la dimensione dell'archivio delle versioni supera questa soglia, tutte le informazioni usate solo per le attività in background facoltative, ad esempio il recupero dello spazio eliminato nel database, vengono invece sacrificate per mantenere lo spazio per le informazioni transazionali.
DatabasePageSize	Questo parametro configura le dimensioni della pagina per il database. La dimensione della pagina è la più piccola unità di allocazione dello spazio possibile per un file di database. Anche le dimensioni della pagina del database sono molto importanti perché imposta il limite superiore sulle dimensioni di un singolo record nel database. In questo momento è supportata una sola dimensione della 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, devono tutti accettare le dimensioni di una pagina del database.
Errortostring	Questo parametro può essere usato per convertire un JET_ERR in una stringa. Questa operazione deve essere usata 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). Questo parametro non può attualmente essere recuperato.
CleanupMismatchedLogFiles	Questo parametro controlla il risultato di JetInit quando il motore di database è configurato per iniziare a usare i file di log delle transazioni nel disco di 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 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 eccezioni non gestito di Windows. Ciò comporta la gestione dell'eccezione come errore dell'applicazione. La finalità consiste nel impedire che il codice dell'applicazione tenti di rilevare e ignorare un'eccezione generata dal motore di database. Ciò non può essere consentito perché il danneggiamento del database potrebbe verificarsi. Se l'applicazione desidera gestire correttamente queste eccezioni, la protezione può essere disabilitata impostando questo parametro su JET_ExceptionNone.
CreatePathIfNotExist	Quando questo parametro è impostato su true, verrà creata automaticamente qualsiasi cartella mancante in un percorso del file system in uso dal motore di database. 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, è possibile aprire un solo database usando JetOpenDatabase da una determinata sessione alla volta. Il database temporaneo è escluso da questa restrizione.
MaxInstances	Questo parametro controlla il numero massimo di istanze che possono essere create 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