énumération JET_param

  • Article

Paramètres système ESENT.

Namespace:Microsoft.Isam.Esent.Interop
Assemblée: Microsoft.Isam.Esent.Interop (en Microsoft.Isam.Esent.Interop.dll)

Syntaxe

'Declaration
Public Enumeration JET_param
'Usage
Dim instance As JET_param

public enum JET_param

Membres

Nom du membre Description
SystemPath Ce paramètre indique le chemin du système de fichiers relatif ou absolu du dossier qui contiendra le fichier de point de contrôle pour le instance. Le chemin d’accès doit être terminé par une barre oblique inverse, qui indique que le chemin d’accès cible est un dossier.
TempPath Ce paramètre indique le chemin du système de fichiers relatif ou absolu du dossier ou du fichier qui contiendra la base de données temporaire pour le instance. Si le chemin d’accès est à un dossier qui contiendra la base de données temporaire, il doit être terminé par une barre oblique inverse.
LogFilePath Ce paramètre indique le chemin du système de fichiers relatif ou absolu du dossier qui contiendra les journaux des transactions pour le instance. Le chemin d’accès doit être terminé par une barre oblique inverse, qui indique que le chemin d’accès cible est un dossier.
BaseName Ce paramètre définit le préfixe à trois lettres utilisé pour la plupart des fichiers utilisés par 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.
EventSource Ce paramètre fournit une chaîne spécifique à l’application qui sera ajoutée aux messages du journal des événements émis par le moteur de base de données. Cela permet une corrélation facile des messages du journal des événements avec l’application source. Par défaut, le nom exécutable de l’application hôte est utilisé.
MaxSessions Ce paramètre réserve le nombre demandé de ressources de session pour une utilisation par un instance. Une ressource de session correspond directement à un type de données JET_SESID. Ce paramètre affecte le nombre de sessions qui peuvent être utilisées en même temps.
MaxOpenTables Ce paramètre réserve le nombre demandé de ressources d’arborescence B+ pour une utilisation par un instance. Ce paramètre affecte le nombre de tables pouvant être utilisées en même temps.
MaxCursors Ce paramètre réserve le nombre demandé de ressources de curseur pour une utilisation par un instance. Une ressource de curseur correspond directement à un type de données JET_TABLEID. Ce paramètre affecte le nombre de curseurs pouvant être utilisés en même temps. Une ressource de curseur ne peut pas être partagée par différentes sessions. Ce paramètre doit donc être défini sur une valeur suffisamment grande pour que chaque session puisse utiliser autant de curseurs que nécessaire.
MaxVerPages Ce paramètre réserve le nombre demandé de pages du magasin de versions pour une utilisation par un instance.
MaxTemporaryTables Ce paramètre réserve le nombre demandé de ressources de table temporaires pour une utilisation par un instance. Ce paramètre affecte le nombre de tables temporaires pouvant ê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 pour éviter les E/S requises pour créer la base de données temporaire si l’on sait qu’elle ne sera pas utilisée.

L’utilisation d’une table temporaire nécessite également une ressource de curseur.
LogFileSize Ce paramètre configure la taille des fichiers journaux des transactions. Chaque fichier journal des transactions a une taille fixe. La taille est égale au paramètre de ce paramètre système en unités de 1 024 octets.
LogBuffers Ce paramètre configure 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 des transactions. L’unité de ce paramètre est la taille de secteur du volume qui contient les fichiers journaux des transactions. La taille du secteur est presque toujours de 512 octets. Il est donc prudent de supposer cette taille pour l’unité. Ce paramètre a un impact sur les performances. Lorsque le moteur de base de données est soumis à une charge de mise à jour importante, cette mémoire tampon peut devenir saturée très rapidement. Une plus grande taille de cache pour le fichier journal des transactions est essentielle pour de bonnes performances de mise à jour dans une condition de charge aussi élevée. La valeur par défaut est connue pour être trop petite pour ce cas. Ne définissez pas ce paramètre sur un nombre de mémoires tampons supérieur (en octets) à la moitié de la taille d’un fichier journal des transactions.
CircularLog Ce paramètre configure la façon dont les fichiers journaux des transactions sont gérés par le moteur de base de données. Lorsque la journalisation circulaire est désactivée, tous les fichiers journaux des transactions générés sont conservés sur le disque jusqu’à ce qu’ils ne soient plus nécessaires, car une sauvegarde complète de la base de données a été effectuée. Lorsque la journalisation circulaire est activée, seuls les fichiers journaux des transactions qui sont plus jeunes 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 des transactions.
DbExtensionSize Ce paramètre contrôle la quantité d’espace ajoutée à un fichier de base de données chaque fois qu’il doit croître pour prendre en charge davantage de données. La taille est dans les pages de base de données.
PageTempDBMin Ce paramètre contrôle la taille initiale de la base de données temporaire. La taille est dans les pages de base de données. Une taille de 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 base de données temporaire pour qu’elle soit aussi petite que possible. La définition de ce paramètre sur SystemParameters.PageTempDBSmallest permet d’obtenir la base de données temporaire la plus petite possible.
CacheSizeMax Ce paramètre configure la taille maximale du cache de la page de base de données. La taille est dans les pages de base de données. Si ce paramètre est conservé à sa valeur par défaut, la taille maximale du cache est définie sur la taille de la mémoire physique lorsque JetInit est appelé.
CheckpointDepthMax Ce paramètre contrôle la façon dont les pages de base de données sont vidées du cache de la page de base de données afin de réduire le temps nécessaire à la récupération suite à un incident. Le paramètre est un seuil en octets pour le nombre de fichiers journaux des transactions qui devront être relu après un incident. Si la journalisation circulaire est activée à l’aide de JET_param. CircularLog contrôle également la quantité approximative de fichiers journaux des transactions qui seront conservés sur le disque.
OutstandingIOMax Ce paramètre contrôle le nombre d’E/S de fichier de base de données pouvant être mises en file d’attente par disque dans le système d’exploitation hôte à la fois. Une valeur plus élevée pour ce paramètre peut considérablement améliorer les performances d’une application de base de données volumineuse.
StartFlushThreshold Ce paramètre contrôle le moment où le cache de pages de base de données commence à supprimer les pages du cache pour libérer de l’espace pour les pages qui ne sont pas mises en cache. Lorsque le nombre de mémoires tampons de page dans le cache passe en dessous de ce seuil, un processus en arrière-plan est démarré pour réapprovisionner ce pool de mémoires tampons disponibles. Ce seuil est toujours relatif à la taille maximale du cache définie par JET_paramCacheSizeMax. Ce seuil doit également toujours être inférieur au seuil d’arrêt défini par JET_paramStopFlushThreshold. La hauteur de distance du seuil de début détermine le temps de réponse que le cache de la page de base de données doit avoir pour produire les mémoires tampons disponibles avant que l’application n’en ait besoin. Un seuil de démarrage élevé donne au processus en arrière-plan plus de temps pour réagir. Toutefois, un seuil de démarrage élevé implique un seuil d’arrêt plus élevé, ce qui réduit la taille effective du cache des pages de base de données pour les pages modifiées (Windows 2000) ou pour toutes les pages (Windows XP et versions ultérieures).
StopFlushThreshold Ce paramètre contrôle le moment où le cache de page de base de données se termine par la suppression des pages du cache pour libérer de l’espace pour les pages qui ne sont pas mises en cache. Lorsque le nombre de mémoires tampons de page dans le cache dépasse ce seuil, le processus en arrière-plan qui a démarré pour réapprovisionner ce pool de mémoires tampons disponibles est arrêté. Ce seuil est toujours relatif à la taille maximale du cache définie par JET_paramCacheSizeMax. Ce seuil doit également toujours être supérieur au seuil de début défini par JET_paramStartFlushThreshold. La distance entre le seuil de début et le seuil d’arrêt affecte l’efficacité avec laquelle les pages de base de données sont vidées par le processus en arrière-plan. Un écart plus important rendra plus probable la combinaison des écritures dans les pages voisines. Toutefois, un seuil d’arrêt élevé réduit la taille effective du cache des pages de base de données pour les pages modifiées (Windows 2000) ou pour toutes les pages (Windows XP et versions ultérieures).
Récupération Ce paramètre est le commutateur master qui contrôle la récupération d’incident pour un instance. Si ce paramètre est défini sur « Activé », la récupération de style ARIES sera utilisée pour amener toutes les bases de données de l’instance à un état cohérent en cas d’incident de processus ou de machine. Si ce paramètre est défini sur « Désactivé », toutes les bases de données du instance seront gérées sans bénéficier d’une récupération sur incident. Autrement dit, si le instance n’est pas arrêté proprement à l’aide de JetTerm avant la fermeture du processus ou l’arrêt de l’ordinateur, le contenu de toutes les bases de données de ce instance sera endommagé.
EnableOnlineDefrag Ce paramètre contrôle le comportement de la défragmentation en ligne lorsqu’elle est lancée à l’aide de JetDefragment(JET_SESID, JET_DBID, String, Int32, Int32, DefragGrbit) et JetDefragment2(JET_SESID, JET_DBID, String, Int32, Int32, JET_CALLBACK, DefragGrbit).
CacheSize Ce paramètre peut être utilisé pour contrôler la taille du cache de la page de base de données au moment de l’exécution. En règle générale, le cache ajuste automatiquement sa taille en fonction des niveaux d’activité de la base de données et de l’ordinateur. Si l’application définit ce paramètre sur zéro, le cache ajuste sa propre taille de cette manière. Toutefois, si l’application définit ce paramètre sur une valeur différente de zéro, le cache s’ajuste lui-même à cette taille cible.
EnableIndexChecking Lorsque ce paramètre a la valeur true, chaque base de données est vérifiée à l’heure JetAttachDatabase pour les index sur les colonnes clés Unicode qui ont été créées à l’aide d’une version antérieure de la bibliothèque NLS dans le système d’exploitation. Cela doit être effectué, car le moteur de base de données conserve les clés de tri générées par LCMapStringW et la valeur de ces clés de tri change de mise en production. Si un index principal est détecté dans cet état, JetAttachDatabase échoue toujours avec JET_err. PrimaryIndexCorrupted. Si des index secondaires sont détectés dans cet état, il existe deux résultats possibles. Si AttachDatabaseGrbit.DeleteCorruptIndexes a été passé à JetAttachDatabase, ces index seront supprimés et JET_wrnCorruptIndexDeleted seront retournés à partir de JetAttachDatabase. Ces index devront être recréés par votre application. Si AttachDatabaseGrbit.DeleteCorruptIndexes n’a pas été passé à JetAttachDatabase, l’appel échoue avec JET_errSecondaryIndexCorrupted.
EventSourceKey Ce paramètre peut être utilisé pour contrôler le 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 vont dans le 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 passent à la place.
NoInformationEvent Lorsque ce paramètre a la valeur true, les messages du journal des événements informationnels qui seraient normalement générés par le moteur de base de données sont supprimés.
EventLoggingLevel Configure le niveau de détail des messages de journal des événements qui sont émis dans le journal des événements par le moteur de base de données. Des nombres plus élevés entraînent des messages de journal des événements plus détaillés.
DeleteOutOfRangeLogs Supprimez les fichiers journaux qui ne correspondent pas (au niveau de la génération) pendant la récupération réversible.
CacheSizeMin Ce paramètre configure la taille minimale du cache de la page de base de données. La taille se trouve dans les pages de base de données.
PreferredVerPages Ce paramètre représente un seuil par rapport à MaxVerPages qui contrôle l’utilisation discrétionnaire des pages de version par le moteur de base de données. Si la taille du magasin de versions dépasse ce seuil, toutes les informations utilisées uniquement pour les tâches en arrière-plan facultatives, telles que la récupération d’espace supprimé dans la base de données, sont sacrifiées pour conserver de la place pour les informations transactionnelles.
DatabasePageSize Ce paramètre configure la taille de page de la base de données. La taille de page est la plus petite unité d’allocation d’espace possible pour un fichier de base de données. La taille de la page de base de données est également très importante, car elle définit la limite supérieure de la taille d’un enregistrement individuel dans la base de données.

Une seule taille de page de base de données est prise en charge par processus pour l’instant. Cela signifie que si vous êtes dans un seul processus qui contient différentes applications qui utilisent le moteur de base de données, elles doivent toutes convenir d’une taille de page de base de données.
ErrorToString Ce paramètre peut être utilisé pour convertir un JET_ERR en chaîne. Il ne doit être utilisé qu’avec JetGetSystemParameter.
RuntimeCallback Configure le moteur avec un délégué JET_CALLBACK . Ce rappel peut être appelé pour les raisons suivantes : FreeCursorLS, FreeTableLS ou Null. Pour plus d’informations, consultez JetSetLS(JET_SESID, JET_TABLEID, JET_LS, LsGrbit). Ce paramètre ne peut pas être récupéré actuellement.
CleanupMismatchedLogFiles Ce paramètre contrôle le résultat de JetInit lorsque le moteur de base de données est configuré pour commencer à utiliser des fichiers journaux des transactions sur un 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, lorsque 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 démarre un nouvel ensemble de fichiers journaux des transactions à l’aide de la taille du fichier journal configurée. Ce paramètre est utile lorsque l’application souhaite modifier en toute transparence la taille de son fichier journal des transactions tout en restant transparente dans les scénarios de mise à niveau et de restauration.
ExceptionAction Ce paramètre contrôle ce qui se passe lorsqu’une exception est levée par le moteur de base de données ou le code appelé par le moteur de base de données. Lorsqu’elle est définie sur JET_ExceptionMsgBox, toute exception est levée sur le filtre d’exception non géré Windows. Cela entraîne la gestion de l’exception en tant qu’échec d’application. L’objectif est d’empêcher le code d’application d’essayer par erreur d’intercepter et d’ignorer une exception générée par le moteur de base de données. Cela ne peut pas être autorisé, car une altération de la base de données peut se produire. Si l’application souhaite gérer correctement ces exceptions, vous pouvez désactiver la protection en définissant ce paramètre sur JET_ExceptionNone.
CreatePathIfNotExist Lorsque ce paramètre a la valeur true, tout dossier manquant dans un chemin de système de fichiers utilisé par le moteur de base de données est créé en mode silencieux. Sinon, l’opération qui utilise le chemin du système de fichiers manquant échoue avec JET_err. InvalidPath.
OneDatabasePerSession Lorsque ce paramètre a la valeur true, une seule base de données est autorisée à être ouverte à l’aide de JetOpenDatabase par une session donnée à la fois. La base de données temporaire est exclue de cette restriction.
MaxInstances Ce paramètre contrôle le nombre maximal d’instances qui peuvent être créées dans un seul processus.
VersionStoreTaskQueueMax Ce paramètre contrôle le nombre d’éléments de travail de nettoyage en arrière-plan qui peuvent être mis en file d’attente vers le pool de threads du moteur de base de données à tout moment.

Voir aussi

Informations de référence

Espace de noms Microsoft.Isam.Esent.Interop