JET_param-Enumeration

ESENT-Systemparameter.

Namespace:Microsoft.Isam.Esent.Interop
Versammlung: Microsoft.Isam.Esent.Interop (in Microsoft.Isam.Esent.Interop.dll)

Syntax

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

Members

Membername Beschreibung
SystemPath Dieser Parameter gibt den relativen oder absoluten Dateisystempfad des Ordners an, der die Prüfpunktdatei für die instance enthält. Der Pfad muss mit einem umgekehrten Schrägstrich beendet werden, der angibt, dass der Zielpfad ein Ordner ist.
TempPath Dieser Parameter gibt den relativen oder absoluten Dateisystempfad des Ordners oder der Datei an, der die temporäre Datenbank für die instance enthält. Wenn der Pfad zu einem Ordner gehört, der die temporäre Datenbank enthält, muss er mit einem umgekehrten Schrägstrich beendet werden.
LogFilePath Dieser Parameter gibt den relativen oder absoluten Dateisystempfad des Ordners an, der die Transaktionsprotokolle für die instance enthält. Der Pfad muss mit einem umgekehrten Schrägstrich beendet werden, der angibt, dass der Zielpfad ein Ordner ist.
BaseName Dieser Parameter legt das Präfix aus drei Buchstaben fest, das für viele der von der Datenbank-Engine verwendeten Dateien verwendet wird. Die Prüfpunktdatei heißt z. B. EDB. CHK standardmäßig, da EDB der Standardbasisname ist.
EventSource Dieser Parameter stellt eine anwendungsspezifische Zeichenfolge bereit, die allen Ereignisprotokollmeldungen hinzugefügt wird, die von der Datenbank-Engine ausgegeben werden. Dies ermöglicht eine einfache Korrelation von Ereignisprotokollmeldungen mit der Quellanwendung. Standardmäßig wird der ausführbare Name der Hostanwendung verwendet.
MaxSessions Dieser Parameter reserviert die angeforderte Anzahl von Sitzungsressourcen für die Verwendung durch eine instance. Eine Sitzungsressource entspricht direkt einem JET_SESID Datentyp. Diese Einstellung wirkt sich darauf aus, wie viele Sitzungen gleichzeitig verwendet werden können.
MaxOpenTables Dieser Parameter reserviert die angeforderte Anzahl von B+ Tree-Ressourcen für die Verwendung durch einen instance. Diese Einstellung wirkt sich darauf aus, wie viele Tabellen gleichzeitig verwendet werden können.
MaxCursors Dieser Parameter reserviert die angeforderte Anzahl von Cursorressourcen für die Verwendung durch einen instance. Eine Cursorressource entspricht direkt einem JET_TABLEID Datentyp. Diese Einstellung wirkt sich darauf aus, wie viele Cursor gleichzeitig verwendet werden können. Eine Cursorressource kann nicht von verschiedenen Sitzungen freigegeben werden, daher muss dieser Parameter auf einen ausreichend großen Wert festgelegt werden, damit jede Sitzung so viele Cursor verwenden kann, wie erforderlich sind.
MaxVerPages Dieser Parameter reserviert die angeforderte Anzahl von Versionsspeicherseiten für die Verwendung durch eine instance.
MaxTemporaryTables Dieser Parameter reserviert die angeforderte Anzahl temporärer Tabellenressourcen für die Verwendung durch einen instance. Diese Einstellung wirkt sich darauf aus, wie viele temporäre Tabellen gleichzeitig verwendet werden können. Wenn dieser Systemparameter auf 0 festgelegt ist, wird keine temporäre Datenbank erstellt, und jede Aktivität, die die Verwendung der temporären Datenbank erfordert, schlägt fehl. Diese Einstellung kann hilfreich sein, um die zum Erstellen der temporären Datenbank erforderlichen E/A-Vorgänge zu vermeiden, wenn bekannt ist, dass sie nicht verwendet wird.

Für die Verwendung einer temporären Tabelle ist auch eine Cursorressource erforderlich.

LogFileSize Mit diesem Parameter wird die Größe der Transaktionsprotokolldateien konfiguriert. Jede Transaktionsprotokolldatei hat eine feste Größe. Die Größe entspricht der Einstellung dieses Systemparameters in Einheiten von 1024 Bytes.
LogBuffers Mit diesem Parameter wird die Menge an Arbeitsspeicher konfiguriert, die zum Zwischenspeichern von Protokolldatensätzen verwendet wird, bevor sie in die Transaktionsprotokolldatei geschrieben werden. Die Einheit für diesen Parameter ist die Sektorgröße des Volumes, das die Transaktionsprotokolldateien enthält. Die Sektorgröße beträgt fast immer 512 Byte, daher ist es sicher, diese Größe für die Einheit anzunehmen. Dieser Parameter wirkt sich auf die Leistung aus. Wenn die Datenbank-Engine unter hoher Updatelast steht, kann dieser Puffer sehr schnell voll sein. Eine größere Cachegröße für die Transaktionsprotokolldatei ist wichtig für eine gute Updateleistung bei solch hoher Auslastung. Der Standardwert ist für diesen Fall bekanntlich zu klein. Legen Sie diesen Parameter nicht auf eine Anzahl von Puffern fest, die größer (in Bytes) als die Hälfte der Größe einer Transaktionsprotokolldatei sind.
CircularLog Mit diesem Parameter wird konfiguriert, wie Transaktionsprotokolldateien von der Datenbank-Engine verwaltet werden. Wenn die Zirkelprotokollierung deaktiviert ist, werden alle generierten Transaktionsprotokolldateien auf dem Datenträger aufbewahrt, bis sie nicht mehr benötigt werden, da eine vollständige Sicherung der Datenbank durchgeführt wurde. Wenn die zirkuläre Protokollierung aktiviert ist, werden nur Transaktionsprotokolldateien, die jünger als der aktuelle Prüfpunkt sind, auf dem Datenträger beibehalten. Der Vorteil dieses Modus besteht darin, dass sicherungen nicht erforderlich sind, um alte Transaktionsprotokolldateien außer Betrieb zu setzen.
DbExtensionSize Dieser Parameter steuert den Speicherplatz, der einer Datenbankdatei jedes Mal hinzugefügt wird, wenn sie vergrößert werden muss, um mehr Daten aufzunehmen. Die Größe ist auf Datenbankseiten.
PageTempDBMin Dieser Parameter steuert die Anfangsgröße der temporären Datenbank. Die Größe ist auf Datenbankseiten. Die Größe 0 gibt an, dass die Standardgröße einer normalen Datenbank verwendet werden soll. Es ist häufig wünschenswert, dass kleine Anwendungen die temporäre Datenbank so konfigurieren, dass sie so klein wie möglich ist. Wenn Sie diesen Parameter auf SystemParameters.PageTempDBSmallest festlegen, wird die kleinste temporäre Datenbank erreicht, die möglich ist.
CacheSizeMax Mit diesem Parameter wird die maximale Größe des Datenbankseitencaches konfiguriert. Die Größe ist auf Datenbankseiten. Wenn für diesen Parameter der Standardwert beibehalten wird, wird die maximale Größe des Caches auf die Größe des physischen Arbeitsspeichers festgelegt, wenn JetInit aufgerufen wird.
CheckpointDepthMax Dieser Parameter steuert, wie aggressiv Datenbankseiten aus dem Datenbankseitencache geleert werden, um die Dauer der Wiederherstellung nach einem Absturz zu minimieren. Der Parameter ist ein Schwellenwert in Bytes für die Anzahl der Transaktionsprotokolldateien, die nach einem Absturz wiedergegeben werden müssen. Wenn die Zirkelprotokollierung mithilfe von JET_param aktiviert ist. CircularLog steuert dann mit diesem Parameter auch die ungefähre Menge der Transaktionsprotokolldateien, die auf dem Datenträger aufbewahrt werden.
OutstandingIOMax Dieser Parameter steuert, wie viele Datenbankdatei-E/A-Vorgänge pro Datenträger im Hostbetriebssystem gleichzeitig in die Warteschlange gestellt werden können. Ein größerer Wert für diesen Parameter kann die Leistung einer großen Datenbankanwendung erheblich verbessern.
StartFlushThreshold Dieser Parameter steuert, wann der Datenbankseitencache mit dem Entfernen von Seiten aus dem Cache beginnt, um Platz für Seiten zu schaffen, die nicht zwischengespeichert werden. Wenn die Anzahl der Seitenpuffer im Cache unter diesen Schwellenwert fällt, wird ein Hintergrundprozess gestartet, um diesen Pool mit verfügbaren Puffern aufzufüllen. Dieser Schwellenwert ist immer relativ zur maximalen Cachegröße, wie von JET_paramCacheSizeMax festgelegt. Dieser Schwellenwert muss auch immer kleiner als der durch JET_paramStopFlushThreshold festgelegte Stoppschwellenwert sein. Die Entfernungshöhe des Startschwellenwerts bestimmt die Antwortzeit, die der Datenbankseitencache haben muss, um verfügbare Puffer zu erzeugen, bevor die Anwendung sie benötigt. Ein hoher Startschwellenwert gibt dem Hintergrundprozess mehr Zeit zum Reagieren. Ein hoher Startschwellenwert impliziert jedoch einen höheren Stoppschwellenwert, der die effektive Größe des Datenbankseitencaches für geänderte Seiten (Windows 2000) oder für alle Seiten (Windows XP und höher) reduziert.
StopFlushThreshold Dieser Parameter steuert, wann der Datenbankseitencache das Entfernen von Seiten aus dem Cache beendet, um Platz für Seiten zu schaffen, die nicht zwischengespeichert werden. Wenn die Anzahl der Seitenpuffer im Cache diesen Schwellenwert übersteigt, wird der Hintergrundprozess beendet, der gestartet wurde, um diesen Pool mit verfügbaren Puffern aufzufüllen. Dieser Schwellenwert ist immer relativ zur maximalen Cachegröße, wie von JET_paramCacheSizeMax festgelegt. Dieser Schwellenwert muss auch immer größer sein als der von JET_paramStartFlushThreshold festgelegte Startschwellenwert. Der Abstand zwischen dem Startschwellenwert und dem Stoppschwellenwert wirkt sich auf die Effizienz aus, mit der Datenbankseiten durch den Hintergrundprozess geleert werden. Eine größere Lücke macht es wahrscheinlicher, dass Schreibvorgänge auf benachbarte Seiten kombiniert werden. Ein hoher Stoppschwellenwert verringert jedoch die effektive Größe des Datenbankseitencaches für geänderte Seiten (Windows 2000) oder für alle Seiten (Windows XP und höher).
Wiederherstellung Dieser Parameter ist der master Switch, der die Absturzwiederherstellung für eine instance steuert. Wenn dieser Parameter auf "Ein" festgelegt ist, wird die Wiederherstellung im ARIES-Format verwendet, um alle Datenbanken im instance im Falle eines Prozess- oder Computerabsturzes in einen konsistenten Zustand zu versetzen. Wenn dieser Parameter auf "Off" festgelegt ist, werden alle Datenbanken im instance ohne den Vorteil der Absturzwiederherstellung verwaltet. Das heißt, wenn der instance nicht sauber mithilfe von JetTerm heruntergefahren wird, bevor der Prozess beendet oder der Computer heruntergefahren wird, wird der Inhalt aller Datenbanken in diesem instance beschädigt.
EnableOnlineDefrag Dieser Parameter steuert das Verhalten der Onlinedefragmentierung, wenn es mit JetDefragment(JET_SESID, JET_DBID, String, Int32, Int32, DefragGrbit) und JetDefragment2(JET_SESID, JET_DBID, String, Int32, Int32, JET_CALLBACK, DefragGrbit) initiiert wird.
CacheSize Dieser Parameter kann verwendet werden, um die Größe des Datenbankseitencaches zur Laufzeit zu steuern. Normalerweise optimiert der Cache seine Größe automatisch in Abhängigkeit von Datenbank- und Computeraktivitätsebenen. Wenn die Anwendung diesen Parameter auf 0 (null) festlegt, optimiert der Cache seine eigene Größe auf diese Weise. Wenn die Anwendung diesen Parameter jedoch auf einen Wert ungleich 0 (null) festlegt, passt sich der Cache an diese Zielgröße an.
EnableIndexChecking Wenn dieser Parameter true ist, wird jede Datenbank zum JetAttachDatabase-Zeitpunkt auf Indizes für Unicode-Schlüsselspalten überprüft, die mit einer älteren Version der NLS-Bibliothek im Betriebssystem erstellt wurden. Dies muss geschehen, da die Datenbank-Engine die von LCMapStringW generierten Sortierschlüssel beibehalten und der Wert dieser Sortierschlüssel von Release zu Release geändert wird. Wenn erkannt wird, dass sich ein primärer Index in diesem Zustand befindet, schlägt JetAttachDatabase immer mit JET_err fehl. PrimaryIndexCorrupted. Wenn sekundäre Indizes erkannt werden, dass sie sich in diesem Zustand befinden, gibt es zwei mögliche Ergebnisse. Wenn AttachDatabaseGrbit.DeleteCorruptIndexes an JetAttachDatabase übergeben wurde, werden diese Indizes gelöscht und JET_wrnCorruptIndexDeleted von JetAttachDatabase zurückgegeben. Diese Indizes müssen von Ihrer Anwendung neu erstellt werden. Wenn AttachDatabaseGrbit.DeleteCorruptIndexes nicht an JetAttachDatabase übergeben wurde, schlägt der Aufruf mit JET_errSecondaryIndexCorrupted fehl.
EventSourceKey Dieser Parameter kann verwendet werden, um zu steuern, welches Ereignisprotokoll die Datenbank-Engine für ihre Ereignisprotokollmeldungen verwendet. Standardmäßig werden alle Ereignisprotokollmeldungen in das Anwendungsereignisprotokoll weitergeleitet. Wenn der Registrierungsschlüsselname für ein anderes Ereignisprotokoll konfiguriert ist, werden stattdessen die Ereignisprotokollmeldungen dorthin weitergeleitet.
NoInformationEvent Wenn dieser Parameter true ist, werden informationsbasierte Ereignisprotokollmeldungen unterdrückt, die normalerweise von der Datenbank-Engine generiert würden.
EventLoggingLevel Konfiguriert die Detailebene der Ereignisprotokollmeldungen, die von der Datenbank-Engine an das Eventlog ausgegeben werden. Höhere Zahlen führen zu ausführlicheren Ereignisprotokollmeldungen.
DeleteOutOfRangeLogs Löschen Sie die Protokolldateien, die während der vorläufigen Wiederherstellung nicht übereinstimmen (generierungsmäßig).
CacheSizeMin Mit diesem Parameter wird die Mindestgröße des Datenbankseitencaches konfiguriert. Die Größe ist auf Datenbankseiten.
PreferredVerPages Dieser Parameter stellt einen Schwellenwert relativ zu MaxVerPages dar, der die freie Verwendung von Versionsseiten durch die Datenbank-Engine steuert. Wenn die Größe des Versionsspeichers diesen Schwellenwert überschreitet, werden alle Informationen, die nur für optionale Hintergrundaufgaben verwendet werden, z. B. das Freigeben von gelöschtem Speicherplatz in der Datenbank, stattdessen geopfert, um Platz für Transaktionsinformationen zu erhalten.
DatabasePageSize Mit diesem Parameter wird die Seitengröße für die Datenbank konfiguriert. Die Seitengröße ist die kleinste Einheit der Speicherplatzzuweisung, die für eine Datenbankdatei möglich ist. Die Größe der Datenbankseite ist ebenfalls sehr wichtig, da sie die Obergrenze für die Größe eines einzelnen Datensatzes in der Datenbank festlegt.

Derzeit wird pro Prozess nur eine Datenbankseitengröße unterstützt. Wenn Sie sich also in einem einzelnen Prozess befinden, der verschiedene Anwendungen enthält, die die Datenbank-Engine verwenden, müssen sich alle auf eine Datenbankseitengröße einigen.

Errortostring Dieser Parameter kann verwendet werden, um eine JET_ERR in eine Zeichenfolge zu konvertieren. Dies sollte nur mit JetGetSystemParameter verwendet werden.
RuntimeCallback Konfiguriert die Engine mit einem JET_CALLBACK Delegaten. Dieser Rückruf kann aus folgenden Gründen aufgerufen werden: FreeCursorLS, FreeTableLS oder Null. Weitere Informationen finden Sie unter JetSetLS(JET_SESID, JET_TABLEID, JET_LS, LsGrbit). Dieser Parameter kann derzeit nicht abgerufen werden.
CleanupMismatchedLogFiles Dieser Parameter steuert das Ergebnis von JetInit, wenn die Datenbank-Engine so konfiguriert ist, dass transaktionsprotokollierte Dateien auf Datenträgern verwendet werden, die eine andere Größe als die konfigurierte Größe aufweisen. Normalerweise wird JetInit(JET_INSTANCE) die Datenbanken erfolgreich wiederherstellen, schlägt jedoch mit LogFileSizeMismatchDatabasesConsistent fehl, um anzugeben, dass die Protokolldateigröße falsch konfiguriert ist. Wenn dieser Parameter jedoch auf true festgelegt ist, löscht die Datenbank-Engine im Hintergrund alle alten Protokolldateien und startet einen neuen Satz von Transaktionsprotokolldateien unter Verwendung der konfigurierten Protokolldateigröße. Dieser Parameter ist nützlich, wenn die Anwendung die Größe der Transaktionsprotokolldatei transparent ändern möchte, aber dennoch transparent in Upgrade- und Wiederherstellungsszenarien funktioniert.
ExceptionAction Dieser Parameter steuert, was geschieht, wenn eine Ausnahme von der Datenbank-Engine oder dem Code ausgelöst wird, der von der Datenbank-Engine aufgerufen wird. Wenn diese Einstellung auf JET_ExceptionMsgBox festgelegt ist, wird jede Ausnahme für den Windows-Ausnahmefilter ausgelöst. Dies führt dazu, dass die Ausnahme als Anwendungsfehler behandelt wird. Die Absicht besteht darin, zu verhindern, dass Anwendungscode fälschlicherweise versucht, eine von der Datenbank-Engine generierte Ausnahme abzufangen und zu ignorieren. Dies kann nicht zulässig sein, da eine Datenbankbeschädigung auftreten kann. Wenn die Anwendung diese Ausnahmen ordnungsgemäß behandeln möchte, kann der Schutz deaktiviert werden, indem dieser Parameter auf JET_ExceptionNone festgelegt wird.
CreatePathIfNotExist Wenn dieser Parameter auf TRUE festgelegt ist, werden alle Ordner, die in einem von der Datenbank-Engine verwendeten Dateisystempfad fehlen, automatisch erstellt. Andernfalls schlägt der Vorgang, der den fehlenden Dateisystempfad verwendet, mit JET_err fehl. InvalidPath.
OneDatabasePerSession Wenn dieser Parameter true ist, darf nur eine Datenbank gleichzeitig mit JetOpenDatabase von einer bestimmten Sitzung geöffnet werden. Die temporäre Datenbank ist von dieser Einschränkung ausgeschlossen.
MaxInstances Dieser Parameter steuert die maximale Anzahl von Instanzen, die in einem einzelnen Prozess erstellt werden können.
VersionStoreTaskQueueMax Dieser Parameter steuert die Anzahl der Arbeitselemente für die Hintergrundbereinigung, die jederzeit im Threadpool der Datenbank-Engine in die Warteschlange eingereiht werden können.

Siehe auch

Verweis

Microsoft.Isam.Esent.Interop-Namespace