Énumération JET_param

Paramètres système ESENT.

Espace de noms : Microsoft. ISAM. esent. Interop
Assembly : 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 d’accès relatif ou absolu du système de fichiers du dossier qui contiendra le fichier de point de contrôle de l’instance. Le chemin d’accès doit se terminer par une barre oblique inverse, ce qui indique que le chemin d’accès cible est un dossier.
TempPath Ce paramètre indique le chemin d’accès relatif ou absolu du système de fichiers du dossier ou du fichier qui contiendra la base de données temporaire de l’instance. Si le chemin d’accès correspond à un dossier qui contiendra la base de données temporaire, il doit se terminer par une barre oblique inverse.
LogFilePath Ce paramètre indique le chemin d’accès relatif ou absolu du système de fichiers du dossier qui contiendra les journaux des transactions pour l’instance. Le chemin d’accès doit se terminer par une barre oblique inverse, ce 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 à tous les messages du journal des événements émis par le moteur de base de données. Cela permet de corréler facilement 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 sera utilisé.
MaxSessions Ce paramètre réserve le nombre demandé de ressources de session pour une utilisation par une 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 de l’arborescence B + pour une utilisation par une instance. Ce paramètre affecte le nombre de tables qui peuvent être utilisées en même temps.
MaxCursors Ce paramètre réserve le nombre demandé de ressources de curseur pour une utilisation par une instance. Une ressource de curseur correspond directement à un type de données JET_TABLEID. Ce paramètre affecte le nombre de curseurs qui peuvent être utilisés en même temps. Une ressource de curseur ne peut pas être partagée par différentes sessions, de sorte que ce paramètre doit être défini sur une valeur suffisamment élevée afin 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 une instance.
MaxTemporaryTables Ce paramètre réserve le nombre demandé de ressources de table temporaire pour une utilisation par 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 à 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 nécessaires à la création de la base de données temporaire si elle est connue qu’elle ne sera pas utilisée.

L’utilisation d’une table temporaire requiert également une ressource curseur.

LogFileSize Ce paramètre permet de configurer la taille des fichiers du journal des transactions. Chaque fichier journal de transactions a une taille fixe. La taille est égale à la valeur de ce paramètre système, en unités de 1024 octets.
LogBuffers Ce paramètre permet de configurer la quantité de mémoire utilisée pour mettre en cache les enregistrements de journal avant leur écriture dans le fichier journal des transactions. L’unité de ce paramètre correspond à la taille de secteur du volume qui contient les fichiers du journal des transactions. La taille des secteurs étant presque toujours de 512 octets, il est possible de supposer en toute sécurité la taille de l’unité. Ce paramètre a un impact sur les performances. Lorsque le moteur de base de données subit une charge de mise à jour importante, cette mémoire tampon peut être entièrement très rapide. Une plus grande taille de cache pour le fichier journal des transactions est essentielle pour garantir une bonne performance des mises à jour dans une condition de charge élevée. La valeur par défaut est trop petite pour ce cas. Ne définissez pas ce paramètre sur un nombre de mémoires tampons plus grand (en octets) que la moitié de la taille d’un fichier journal de 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 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 supprimer les anciens fichiers du journal des transactions.
DbExtensionSize Ce paramètre contrôle la quantité d’espace qui est ajoutée à un fichier de base de données chaque fois qu’il doit croître pour accueillir 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 aussi petite que possible. La définition de ce paramètre sur SystemParameters. PageTempDBSmallest permet d’obtenir la plus petite base de données temporaire possible.
CacheSizeMax Ce paramètre configure la taille maximale du cache des pages de base de données. La taille est dans les pages de base de données. Si ce paramètre est laissé à sa valeur par défaut, la taille maximale du cache sera définie sur la taille de la mémoire physique lors de l’appel de JetInit.
CheckpointDepthMax Ce paramètre contrôle le vidage des pages de base de données à partir du cache des pages de base de données afin de réduire le temps nécessaire à la récupération d’un incident. Le paramètre est un seuil en octets pour le nombre de fichiers journaux des transactions qui doivent être relus après un incident. Si l’enregistrement circulaire est activé à l’aide de JET_param. CircularLog ensuite, ce paramètre contrôle également la quantité approximative de fichiers du journal 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 qui peuvent être mises en file d’attente par disque dans le système d’exploitation hôte à un moment donné. Une valeur plus élevée pour ce paramètre peut améliorer considérablement les performances d’une application de base de données volumineuse.
StartFlushThreshold Ce paramètre contrôle le moment où le cache de la page de base de données commence à supprimer des pages du cache pour libérer de l’espace pour les pages qui ne sont pas mises en cache. Lorsque le nombre de tampons de page dans le cache descend sous 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émarrage détermine le temps de réponse que le cache de page de la base de données doit avoir pour produire des tampons disponibles avant que l’application en ait besoin. Un seuil de démarrage élevé donnera plus de temps au processus en arrière-plan. toutefois, un seuil de démarrage élevé implique un seuil d’arrêt plus élevé et 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 la page de base de données met fin à 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 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 être toujours supérieur au seuil de démarrage défini par JET_paramStartFlushThreshold. La distance entre le seuil de démarrage 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 plus grand fossé rendra plus probable l’Association des écritures aux 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 maître qui contrôle la récupération après incident pour une instance. Si ce paramètre a la valeur « on », la récupération de type ARIES sera utilisée pour ramener toutes les bases de données de l’instance dans un état cohérent en cas de panne d’un processus ou d’un ordinateur. Si ce paramètre est défini sur « désactivé », toutes les bases de données de l’instance seront gérées sans l’avantage de la récupération après incident. Autrement dit, si l’instance n’est pas fermée correctement à l’aide de JetTerm avant la sortie du processus ou de l’arrêt de l’ordinateur, le contenu de toutes les bases de données de cette instance est 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 à cette taille cible.
EnableIndexChecking Lorsque ce paramètre a la valeur true, chaque base de données est vérifiée au moment de la 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 fait parce que le moteur de base de données conserve les clés de tri générées par LCMapStringW et que la valeur de ces clés de tri passe de Release à Release. Si un index principal est détecté comme étant dans cet État, JetAttachDatabase échouera toujours avec JET_err. PrimaryIndexCorrupted. Si des index secondaires sont détectés comme étant dans cet État, il existe deux résultats possibles. Si AttachDatabaseGrbit. DeleteCorruptIndexes a été passé à JetAttachDatabase, ces index sont supprimés et JET_wrnCorruptIndexDeleted sont retournés à partir de JetAttachDatabase. Ces index doivent ê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 sont envoyés dans le journal des événements de l’application. Si le nom de la clé de registre d’un autre journal des événements est configuré, les messages du journal des événements y seront à la place.
NoInformationEvent Lorsque ce paramètre a la valeur true, les messages du journal des événements d’information qui seraient normalement générés par le moteur de base de données seront supprimés.
EventLoggingLevel Configure le niveau de détail des messages EventLog émis dans le journal des événements par le moteur de base de données. Des numéros plus élevés entraînent des messages EventLog 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 logicielle.
CacheSizeMin Ce paramètre configure la taille minimale du cache des pages de base de données. La taille est dans les pages de base de données.
PreferredVerPages Ce paramètre représente un seuil relatif à MaxVerPages qui contrôle l’utilisation discrétionnaire des pages de version par le moteur de base de données. Si la taille de la Banque des versions dépasse ce seuil, toutes les informations qui sont utilisées uniquement pour les tâches en arrière-plan facultatives, telles que la récupération de l’espace supprimé dans la base de données, sont sacrifiées pour conserver de l’espace pour les informations transactionnelles.
DatabasePageSize Ce paramètre configure la taille de page pour la base de données. La taille de la 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 processus unique qui contient des applications qui utilisent le moteur de base de données, elles doivent toutes accepter sur une taille de page de base de données.

ErrorToString Ce paramètre peut être utilisé pour convertir un JET_ERR en chaîne. Ce doit être utilisé uniquement 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 du journal des transactions sur un disque d’une taille différente de celle configurée. Normalement, JetInit (JET_INSTANCE) récupère les bases de données, mais échoue avec LogFileSizeMismatchDatabasesConsistent pour indiquer que la taille du fichier journal n’est pas correctement configurée. Toutefois, lorsque ce paramètre est défini sur true, le moteur de base de données supprime silencieusement tous les anciens fichiers journaux, puis démarre un nouvel ensemble de fichiers journaux de transactions à l’aide de la taille de fichier journal configurée. Ce paramètre est utile lorsque l’application souhaite modifier en toute transparence la taille du fichier journal des transactions, tout en continuant à travailler de manière transparente dans les scénarios de mise à niveau et de restauration.
ExceptionAction Ce paramètre contrôle ce qui se produit lorsqu’une exception est levée par le moteur de base de données ou le code qui est appelé par le moteur de base de données. quand la valeur JET_ExceptionMsgBox, toute exception est levée dans le Windows filtre d’exception non géré. L’exception est alors gérée en tant qu’échec de l’application. L’objectif est d’empêcher le code d’application d’essayer à tort 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 base de données endommagée peut se produire. Si l’application souhaite gérer correctement ces exceptions, la protection peut être désactivée en définissant ce paramètre sur JET_ExceptionNone.
CreatePathIfNotExist Lorsque ce paramètre est défini sur true, tout dossier manquant dans un chemin d’accès du système de fichiers utilisé par le moteur de base de données sera créé sans assistance. Dans le cas contraire, l’opération qui utilise le chemin d’accès au système de fichiers manquant échouera avec JET_err. InvalidPath.
OneDatabasePerSession Lorsque ce paramètre a la valeur true, une seule base de données peut être ouverte à l’aide de JetOpenDatabase par une session donnée à un moment donné. 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 processus unique.
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 dans le pool de threads du moteur de base de données à un moment donné.

Voir aussi

Informations de référence

Espace de noms Microsoft. ISAM. esent. Interop