InstanceParameters-Member

Geschützte Mitglieder einschließen
Geerbte Mitglieder einschließen

Diese Klasse stellt Eigenschaften zum Festlegen und Abrufen von Systemparametern für eine ESENT-Instanz bereit. Diese Klasse stellt statische Eigenschaften zum instanzbasierten Festlegen und Abrufen von ESENT-Systemparametern bereit.

Der InstanceParameters-Typ macht die folgenden Member verfügbar.

Konstruktoren

	Name	Beschreibung
	InstanceParameters	Hiermit wird eine neue Instanz der InstanceParameters-Klasse initialisiert.

TOP

Eigenschaften

	Name	Beschreibung
	AlternateDatabaseRecoveryDirectory	Diese Eigenschaft wird zum Abrufen oder Festlegen des relativen oder absoluten Dateisystempfads eines Ordners verwendet, in dem Wiederherstellungsvorgänge (z. B. nach einem Systemabsturz) die Datenbanken finden, auf die im Transaktionsprotokoll im angegebenen Ordner verwiesen wird.
	BaseName	Hiermit wird das aus drei Buchstaben bestehende Präfix abgerufen oder festgelegt, das für viele der von der Datenbank-Engine genutzten Dateien verwendet wird. Die Prüfpunktdatei wird beispielsweise standardmäßig als „EDB.CHK“ bezeichnet, da „EDB“ der Standardbasisname ist.
	CachedClosedTables	Mit dieser Eigenschaft wird ein Wert abgerufen oder festgelegt, der die Anzahl der B+-Strukturressourcen angibt, die von der Instanz zwischengespeichert wurden, nachdem die Tabellen, die sie darstellen, von der Anwendung geschlossen wurden. Hohe Werte führen bei diesem Parameter dazu, dass die Datenbank-Engine mehr Arbeitsspeicher verwendet, aber die Geschwindigkeit wird erhöht, sodass eine große Anzahl von Tabellen von der Anwendung beliebig geöffnet werden kann. Dies ist nützlich für Anwendungen mit einem Schema mit einer sehr großen Anzahl von Tabellen. Die Eigenschaft wird unter Windows Vista und höheren Versionen unterstützt. Unter Windows XP und Windows Server 2003 wird sie ignoriert.
	CachePriority	Hiermit wird die instanzbasierte Eigenschaft für relative Cacheprioritäten (Standard = 100) abgerufen oder festgelegt.
	CheckpointDepthMax	Mit dieser Eigenschaft wird der Grenzwert für die nach einem Absturz noch mal wiederzugebenden Transaktionsprotokolldateien in Bytes abgerufen oder festgelegt. Wenn die zirkuläre Protokollierung mithilfe von „CircularLog“ aktiviert ist, steuert dieser Parameter auch die ungefähre Menge an Transaktionsprotokolldateien, die auf dem Datenträger aufbewahrt werden.
	CircularLog	Hiermit wird ein Wert abgerufen oder festgelegt, der angibt, ob die zirkuläre Protokollierung aktiviert ist. Wenn die zirkuläre Protokollierung 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 ausgeführt wurde. Wenn die zirkuläre Protokollierung aktiviert ist, werden nur die Transaktionsprotokolldateien auf dem Datenträger aufbewahrt, die aktueller als der aktuelle Prüfpunkt sind. Der Vorteil dieses Modus besteht darin, dass Sicherungen nicht erforderlich sind, um alte Transaktionsprotokolldateien außer Betrieb zu nehmen.
	CleanupMismatchedLogFiles	Mit dieser Eigenschaft wird ein Wert abgerufen oder festgelegt, der angibt, ob „JetInit“ fehlschlägt, wenn die Datenbank-Engine für die Verwendung von Transaktionsprotokolldateien auf dem Datenträger konfiguriert ist, deren Größe sich von der Konfiguration unterscheidet. In der Regel kann JetInit(JET_INSTANCE) die Datenbanken erfolgreich wiederherstellen. Wenn unter Verwendung von LogFileSizeMismatchDatabasesConsistent angegeben werden soll, dass die Protokolldateigröße falsch konfiguriert ist, tritt aber ein Fehler auf. Wenn dieser Parameter jedoch auf „true“ festgelegt ist, löscht die Datenbank-Engine im Hintergrund alle alten Protokolldateien und startet eine neue Gruppe von Transaktionsprotokolldateien mithilfe der konfigurierten Protokolldateigröße. Dieser Parameter ist nützlich, wenn die Anwendung die Größe der Transaktionsprotokolldatei in Upgrade- und Wiederherstellungsszenarios transparent ändern möchte und die Vorgänge weiterhin transparent bleiben sollen.
	CreatePathIfNotExist	Hiermit wird ein Wert abgerufen oder festgelegt, der angibt, ob „ESENT“ im Hintergrund Ordner erstellt, die in den Dateisystempfaden fehlen.
	DbExtensionSize	Mit dieser Eigenschaft wird die Anzahl der Seiten abgerufen oder festgelegt, die einer Datenbankdatei immer dann hinzugefügt werden, wenn sie erweitert werden soll, um mehr Daten speichern zu können.
	DbScanIntervalMaxSec	Hiermit wird das maximale Intervall (in Sekunden) abgerufen oder festgelegt, in dem die Datenbanküberprüfung abgeschlossen werden muss.
	DbScanIntervalMinSec	Mit dieser Eigenschaft wird das minimale Intervall (in Sekunden) abgerufen oder festgelegt, in dem die Datenbanküberprüfung wiederholt wird.
	DbScanThrottle	Hiermit wird die Drosselung der Datenbankprüfung (in Millisekunden) abgerufen oder festgelegt.
	EnableDbScanInRecovery	Mit dieser Eigenschaft wird ein Wert abgerufen oder festgelegt, der angibt, ob während der Wiederherstellung eine Datenbankwartung durchgeführt werden soll.
	EnableDBScanSerialization	Hiermit wird ein Wert abgerufen oder festgelegt, der angibt, ob die Serialisierung der Datenbankwartung für Datenbanken aktiviert ist, die denselben Datenträger verwenden.
	EnableIndexChecking	Mit dieser Einstellung wird ein Wert abgerufen oder festgelegt, der angibt, ob JetAttachDatabase(JET_SESID, String, AttachDatabaseGrbit) nach Indizes sucht, die mit einer älteren Version der NLS-Bibliothek auf dem Betriebssystem erstellt wurden.
	EnableOnlineDefrag	Hiermit wird ein Wert abgerufen oder festgelegt, der angibt, ob die Onlinedefragmentierung aktiviert ist.
	EventSource	Mit dieser Eigenschaft wird eine anwendungsspezifische Zeichenfolge abgerufen oder festgelegt, 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 Name der ausführbaren Hostanwendung verwendet.
	EventSourceKey	Mit dieser Eigenschaft wird der Name des Ereignisprotokolls abgerufen oder festgelegt, das die Datenbank-Engine für ihre Ereignisprotokollmeldungen verwendet. Standardmäßig werden alle Ereignisprotokollmeldungen in das Anwendungsereignisprotokoll verschoben. Wenn der Registrierungsschlüsselname für ein anderes Ereignisprotokoll konfiguriert ist, werden stattdessen die Ereignisprotokollmeldungen dorthin verschoben.
	LogBuffers	Hiermit wird das Arbeitsspeichervolumen abgerufen oder festgelegt, das 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 Bytes, sodass Sie diese Größe für die Einheit erwarten können. Dieser Parameter wirkt sich auf die Leistung aus. Wenn die Datenbank-Engine aufgrund einer umfassenden Aktualisierung stark ausgelastet ist, kann dieser Puffer schnell vollständig ausgeschöpft sein. Ein höheres Cachevolumen für die Transaktionsprotokolldatei ist für eine gute Updateleistung unter einer solchen hohen Auslastung essenziell. Der Standardwert ist für diesen Fall zu klein. Legen Sie diesen Parameter nicht auf eine Pufferanzahl fest, die die Hälfte der Größe einer Transaktionsprotokolldatei überschreitet (in Bytes).
	LogFileDirectory	Mit dieser Eigenschaft wird der relative oder absolute Dateisystempfad des Ordners abgerufen oder festgelegt, der die Transaktionsprotokolle für diese Instanz enthält.
	LogFileSize	Hiermit wird die Größe der Transaktionsprotokolldateien abgerufen oder festgelegt. Dieser Parameter sollte in Einheiten von 1024 Bytes festgelegt werden (z. B. eine Einstellung von 2048 Bytes ergibt 2 MB Protokolldateien).
	MaxCursors	Mit diesem Parameter wird die Anzahl der Cursorressourcen abgerufen oder festgelegt, die für diese Instanz reserviert sind. Eine Cursorressource entspricht direkt einem JET_TABLEID-Element.
	MaxOpenTables	Hiermit wird die Anzahl der B+-Strukturressourcen abgerufen oder festgelegt, die für diese Instanz reserviert sind.
	MaxSessions	Mit dieser Eigenschaft wird die Anzahl der Sitzungsressourcen abgerufen oder festgelegt, die für diese Instanz reserviert sind. Eine Sitzungsressource entspricht direkt einem JET_SESID-Element.
	MaxTemporaryTables	Hiermit wird die Anzahl der temporären Tabellenressourcen abgerufen oder festgelegt, die von einer Instanz verwendet werden. 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 bei allen Aktivitäten, die die Verwendung der temporären Datenbank erfordern, tritt ein Fehler auf. Diese Einstellung kann hilfreich sein, um die zum Erstellen der temporären Datenbank erforderliche E/A zu vermeiden, wenn bekannt ist, dass sie nicht verwendet wird.
	MaxTransactionSize	Mit dieser Einstellung wird der Prozentsatz des Versionsspeichers abgerufen oder festgelegt, der von der ältesten Transaktion vor VersionStoreOutOfMemory (Standard = 100) verwendet werden kann.
	MaxVerPages	Hiermit wird die maximale Anzahl der Versionsspeicherseiten abgerufen oder festgelegt, die für diese Instanz reserviert sind.
	NoInformationEvent	Mit dieser Eigenschaft wird ein Wert abgerufen oder festgelegt, der angibt, ob informative Ereignisprotokollmeldungen unterdrückt werden, die normalerweise von der Datenbank-Engine generiert werden.
	OneDatabasePerSession	Hiermit wird ein Wert abgerufen oder festgelegt, der angibt, ob zu einem bestimmten Zeitpunkt nur eine Datenbank mit „JetOpenDatabase“ von einer bestimmten Sitzung geöffnet werden darf. Die temporäre Datenbank ist von dieser Einschränkung ausgenommen.
	PageTempDBMin	Mit dieser Eigenschaft wird die Anfangsgröße der temporären Datenbank abgerufen oder festgelegt. Die Größe wird in Datenbankseiten angegeben. Die Größe „0“ gibt an, dass die Standardgröße einer normalen Datenbank verwendet werden soll. Es ist empfehlenswert, die temporäre Datenbank für kleine Anwendungen so klein wie möglich zu konfigurieren. Wenn Sie diesen Parameter auf PageTempDBSmallest festlegen, wird die kleinste mögliche temporäre Datenbank bereitgestellt.
	PreferredVerPages	Hiermit wird die bevorzugte Anzahl von Versionsspeicherseiten abgerufen oder festgelegt, die für diese Instanz reserviert sind. Wenn die Größe des Versionsspeichers diesen Grenzwert überschreitet, werden alle Informationen, die nur für optionale Hintergrundaufgaben verwendet werden (z. B. für das erneute Beanspruchen von gelöschtem Speicherplatz in der Datenbank), stattdessen geopfert, um Platz für Transaktionsinformationen zu reservieren.
	PrereadIOMax	Mit dieser Einstellung wird die maximale Anzahl von E/A-Vorgängen abgerufen oder festgelegt, die für einen bestimmten Zweck durchgeführt werden.
	Wiederherstellung	Hiermit wird ein Wert abgerufen oder festgelegt, der angibt, ob die Wiederherstellung nach einem Systemabsturz aktiviert ist.
	SystemDirectory	Mit dieser Einstellung wird der relative oder absolute Dateisystempfad des Ordners abgerufen oder festgelegt, der die Prüfpunktdatei für diese Instanz enthält.
	TempDirectory	Hiermit wird der relative oder absolute Dateisystempfad des Ordners abgerufen, der die temporäre Datenbank für diese Instanz enthält.
	VersionStoreTaskQueueMax	Mit dieser Einstellung wird die Anzahl der Arbeitselemente für die im Hintergrund durchgeführten Bereinigungsvorgänge abgerufen oder festgelegt, die jederzeit in den Threadpool der Datenbank-Engine eingereiht werden können.
	WaypointLatency	Hiermit wird die Anzahl der Protokolle abgerufen oder festgelegt, für die „ESENT“ das Leeren von Datenbanken aufschiebt. Dies kann verwendet werden, um die Wiederherstellbarkeit der Datenbank zu erhöhen, wenn Fehler dazu führen, dass Protokolldateien verloren gehen. Dieser Ansatz wird unter Windows 7 und höher unterstützt. Unter Windows XP, Windows Server 2003, Windows Vista und Windows Server 2008 wird diese Einstellung ignoriert.

TOP

Methoden

	Name	Beschreibung
	Ist gleich	(Von Object geerbt)
	Finalisieren	(Von Object geerbt)
	GetHashCode	(Von Object geerbt)
	GetType	(Von Object geerbt)
	MemberwiseClone	(Von Object geerbt)
	ToString	Mit dieser Methode wird eine String-Klasse zurückgegeben, die die aktuelle InstanceParameters-Klasse darstellt. (Überschreibt Object.ToString().)

Oben

Siehe auch

Verweis

InstanceParameters-Klasse

Microsoft.Isam.Esent.Interop-Namespace