Membres InstanceParameters

Inclure les membres protégés
Inclure les membres hérités

Cette classe fournit des propriétés pour définir et obtenir des paramètres système sur une instance ESENT. Cette classe fournit des propriétés statiques pour définir et obtenir des paramètres système ESENT par instance.

Le type InstanceParameters expose les membres suivants.

Constructeurs

	Nom	Description
	InstanceParameters	Initialise une nouvelle instance de la classe InstanceParameters.

TOP

Propriétés

	Nom	Description
	AlternateDatabaseRecoveryDirectory	Obtient ou définit le chemin du système de fichiers relatif ou absolu d’un dossier où la récupération sur incident ou une opération de restauration peut trouver les bases de données référencées dans le journal des transactions dans le dossier spécifié.
	BaseName	Obtient ou définit le préfixe de trois lettres utilisé pour la plupart des fichiers dont se sert le moteur de base de données. Par exemple, le fichier de point de contrôle est appelé EDB.CHK par défaut, car EDB est le nom de base par défaut.
	CachedClosedTables	Obtient ou définit une valeur indiquant le nombre de ressources de l’arborescence B+ mises en cache par l’instance une fois que les tables qu’elles représentent ont été fermées par l’application. Les grandes valeurs pour ce paramètre entraînent l’utilisation de plus de mémoire par le moteur de base de données, mais augmentent la vitesse avec laquelle un grand nombre de tables peuvent être ouvertes de manière aléatoire par l’application. C’est utile pour les applications qui ont un schéma avec un très grand nombre de tables. Pris en charge sur Windows Vista et versions ultérieures. Ignoré sur Windows XP et Windows Server 2003.
	CachePriority	Obtient ou définit la propriété par instance pour les priorités de cache relatives (valeur par défaut = 100).
	CheckpointDepthMax	Obtient ou définit le seuil en octets pour le nombre de fichiers journaux de transactions à relire après un incident. Si la journalisation circulaire est activée avec CircularLog, ce paramètre contrôle également la quantité approximative de fichiers journaux de transactions à conserver sur le disque.
	CircularLog	Obtient ou définit une valeur indiquant si la journalisation circulaire est activée. Quand la journalisation circulaire est désactivée, tous les fichiers journaux de transactions générés sont conservés sur le disque jusqu’à ce qu’ils ne soient plus nécessaires parce qu’une sauvegarde complète de la base de données a été effectuée. Quand la journalisation circulaire est activée, seuls les fichiers journaux de transactions plus récents que le point de contrôle actuel sont conservés sur le disque. L’avantage de ce mode est que les sauvegardes ne sont pas nécessaires pour mettre hors service les anciens fichiers journaux de transactions.
	CleanupMismatchedLogFiles	Obtient ou définit une valeur indiquant si JetInit échoue quand le moteur de base de données est configuré pour commencer à utiliser des fichiers journaux de transactions sur le disque dont la taille est différente de celle configurée. Normalement, JetInit(JET_INSTANCE) récupère correctement les bases de données, mais échoue avec LogFileSizeMismatchDatabasesConsistent pour indiquer que la taille du fichier journal est mal configurée. Toutefois, quand ce paramètre est défini sur true, le moteur de base de données supprime en mode silencieux tous les anciens fichiers journaux et commence un nouvel ensemble de fichiers journaux de transactions avec la taille de fichier journal configurée. Ce paramètre est utile quand l’application souhaite changer de manière transparente la taille de son fichier journal de transactions, tout en continuant à fonctionner de manière transparente dans les scénarios de mise à niveau et de restauration.
	CreatePathIfNotExist	Obtient ou définit une valeur indiquant si ESENT crée en mode silencieux des dossiers qui sont manquants dans ses chemins de système de fichiers.
	DbExtensionSize	Obtient ou définit le nombre de pages ajoutées à un fichier de base de données chaque fois qu’il doit grossir pour accueillir davantage de données.
	DbScanIntervalMaxSec	Obtient ou définit l’intervalle maximal pour autoriser la fin de l’analyse de base de données, en secondes.
	DbScanIntervalMinSec	Obtient ou définit l’intervalle minimal pour répéter l’analyse de la base de données, en secondes.
	DbScanThrottle	Obtient ou définit la limitation de l’analyse de base de données, en millisecondes.
	EnableDbScanInRecovery	Obtient ou définit une valeur indiquant si la maintenance de base de données doit s’exécuter pendant la récupération.
	EnableDBScanSerialization	Obtient ou définit une valeur indiquant si la sérialisation de la maintenance de base de données est activée pour les bases de données partageant le même disque.
	EnableIndexChecking	Obtient ou définit une valeur indiquant si JetAttachDatabase(JET_SESID, String, AttachDatabaseGrbit) recherche les index qui ont été générés avec une version antérieure de la bibliothèque NLS dans le système d’exploitation.
	EnableOnlineDefrag	Obtient ou définit une valeur indiquant si la défragmentation en ligne est activée.
	EventSource	Obtient ou définit une chaîne propre à l’application à ajouter à tous les messages du journal des événements qui sont émis par le moteur de base de données. Cela permet de mettre facilement en corrélation les messages du journal des événements avec l’application source. Par défaut, le nom de l’exécutable de l’application hôte est utilisé.
	EventSourceKey	Obtient ou définit le nom du journal des événements que le moteur de base de données utilise pour ses messages de journal des événements. Par défaut, tous les messages du journal des événements sont envoyés au journal des événements de l’application. Si le nom de clé de Registre d’un autre journal des événements est configuré, les messages du journal des événements y sont envoyés.
	LogBuffers	Obtient ou définit la quantité de mémoire utilisée pour mettre en cache les enregistrements de journal avant qu’ils ne soient écrits dans le fichier journal de transactions. L’unité de ce paramètre est la taille de secteur du volume qui contient les fichiers journaux de transactions. Comme la taille de secteur est presque toujours de 512 octets, on peut sans problème supposer cette taille pour l’unité. Ce paramètre a un impact sur les performances. Quand le moteur de base de données est soumis à une charge de mise à jour importante, cette mémoire tampon peut se remplir très rapidement. Une plus grande taille de cache pour le fichier journal de transactions est essentielle pour avoir de bonnes performances de mise à jour dans ces conditions de charge élevée. La valeur par défaut est connue pour être trop petite dans ce cas. Ne définissez pas ce paramètre sur un nombre de mémoires tampon supérieur (en octets) à la moitié de la taille d’un fichier journal de transactions.
	LogFileDirectory	Obtient ou définit le chemin du système de fichiers relatif ou absolu du dossier qui doit contenir les journaux de transactions de l’instance.
	LogFileSize	Obtient ou définit la taille des fichiers journaux de transactions. Ce paramètre doit être défini en unités de 1 024 octets (par exemple, la définition du paramètre sur 2 048 donne des fichiers journaux de 2 Mo).
	MaxCursors	Obtient ou définit le nombre de ressources de curseur réservées pour cette instance. Une ressource de curseur correspond directement à un JET_TABLEID.
	MaxOpenTables	Obtient ou définit le nombre de ressources d’arborescence B+ réservées pour cette instance.
	MaxSessions	Obtient ou définit le nombre de ressources de session réservées pour cette instance. Une ressource de session correspond directement à un JET_SESID.
	MaxTemporaryTables	Obtient ou définit le nombre de ressources de table temporaire que doit utiliser une instance. Ce paramètre affecte le nombre de tables temporaires qui peuvent être utilisées en même temps. Si ce paramètre système est défini sur zéro, aucune base de données temporaire n’est créée et toute activité nécessitant l’utilisation de la base de données temporaire échoue. Ce paramètre peut être utile afin d’éviter les E/S nécessaires pour créer la base de données temporaire si nous savons qu’elle ne sera pas utilisée.
	MaxTransactionSize	Obtient ou définit le pourcentage de magasin de versions qui peut être utilisé par la transaction la plus ancienne avant VersionStoreOutOfMemory (valeur par défaut = 100).
	MaxVerPages	Obtient ou définit le nombre maximal de pages de magasin de versions réservées pour cette instance.
	NoInformationEvent	Obtient ou définit une valeur indiquant si les messages de journal des événements d’information normalement générés par le moteur de base de données doivent être supprimés.
	OneDatabasePerSession	Obtient ou définit une valeur indiquant si une seule base de données peut être ouverte avec JetOpenDatabase par une session donnée à la fois. La base de données temporaire est exclue de cette restriction.
	PageTempDBMin	Obtient ou définit la taille initiale de la base de données temporaire. La taille se trouve dans les pages de la base de données. La taille zéro indique que la taille par défaut d’une base de données ordinaire doit être utilisée. Il est souvent souhaitable que les petites applications configurent la plus petite base de données temporaire possible. La définition de ce paramètre sur PageTempDBSmallest permet d’obtenir la plus petite base de données temporaire possible.
	PreferredVerPages	Obtient ou définit le nombre par défaut de pages de magasin de versions réservées pour cette instance. Si la taille du magasin de versions dépasse ce seuil, toutes les informations utilisées uniquement pour les tâches facultatives en arrière-plan, comme la revendication d’espace supprimé dans la base de données, sont sacrifiées pour garder de l’espace pour les informations transactionnelles.
	PrereadIOMax	Obtient ou définit le nombre maximal d’opérations d’E/S distribuées dans un but donné.
	Récupération	Obtient ou définit une valeur indiquant si la récupération sur incident est activée.
	SystemDirectory	Obtient ou définit le chemin du système de fichiers relatif ou absolu du dossier qui doit contenir le fichier de point de contrôle de l’instance.
	TempDirectory	Obtient ou définit le chemin du système de fichiers relatif ou absolu du dossier qui doit contenir la base de données temporaire de l’instance.
	VersionStoreTaskQueueMax	Obtient ou définit le nombre d’éléments de travail de nettoyage en arrière-plan qui peuvent être mis en file d’attente dans le pool de threads du moteur de base de données à tout moment.
	WaypointLatency	Obtient ou définit le nombre de journaux pour lesquels esent retarde les vidages de base de données. Peut être utilisé pour améliorer la capacité de récupération de la base de données si les échecs entraînent la perte des fichiers journaux. Pris en charge sur Windows 7 et versions ultérieures. Ignoré sur Windows XP, Windows Server 2003, Windows Vista et Windows Server 2008.

TOP

Méthodes

	Nom	Description
	= (Égal à)	(Hérité de Object.)
	Finalize	(Hérité de Object.)
	GetHashCode	(Hérité de Object.)
	GetType	(Hérité de Object.)
	MemberwiseClone	(Hérité de Object.)
	ToString	Retourne une chaîne qui représente l’instance InstanceParameters actuelle. (Remplace Object.ToString().)

Haut

Voir aussi

Référence

Classe InstanceParameters

Espace de noms Microsoft.Isam.Esent.Interop