énumération JET_param

Paramètres système ESENT.

Espace de noms:Microsoft.Isam.Esent.Interop
Assemblée: Microsoft.Isam.Esent.Interop (dans 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 être arrêté avec un caractère de barre oblique inverse, ce qui indique que le chemin 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 est à un dossier qui contiendra la base de données temporaire, il doit être arrêté avec un caractère de 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 être arrêté avec un caractère de barre oblique inverse, ce qui indique que le chemin cible est un dossier.
BaseName Ce paramètre définit le préfixe de trois lettres utilisé pour de nombreux 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 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 à utiliser 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 d’arborescence B+ à utiliser 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 à utiliser 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 afin que ce paramètre soit défini sur une valeur suffisante pour que chaque session puisse utiliser autant de curseurs que nécessaire.
MaxVerPages Ce paramètre réserve le nombre demandé de pages de magasin de versions à utiliser par une instance.
MaxTemporaryTables Ce paramètre réserve le nombre demandé de ressources de table temporaires à utiliser 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 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 que les E/S ne soient nécessaires pour créer la base de données temporaire s’il est connu qu’il ne sera pas utilisé.

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 est une taille fixe. La taille est égale au paramètre de ce paramètre système en unités de 1024 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 du secteur du volume qui contient les fichiers journaux des transactions. La taille du secteur est presque toujours de 512 octets. Il est donc sûr de supposer que la taille de l’unité est sûre. Ce paramètre a un impact sur les performances. Lorsque le moteur de base de données est sous une charge de mise à jour importante, cette mémoire tampon peut devenir complète très rapidement. Une taille de cache plus importante pour le fichier journal des transactions est essentielle pour de bonnes performances de mise à jour sous une telle condition de charge é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 certain nombre de mémoires tampons supérieures (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 de 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 de transactions 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 se trouve 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 se trouve 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 comme 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 page de base de données. La taille se trouve dans les pages de base de données. Si ce paramètre est laissé à 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 page de base de données pour 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 de transactions qui doivent être relectés après un incident. Si la journalisation circulaire est activée à l’aide de JET_param. CircularLog contrôle ensuite la quantité approximative de fichiers journaux de transactions qui seront conservés sur le disque.
OutstandingIOMax Ce paramètre contrôle le nombre d’E/S de fichiers de base de données pouvant être mis en file d’attente par disque dans le système d’exploitation hôte à la fois. Une valeur plus importante pour ce paramètre peut considérablement aider les performances d’une application de base de données volumineuse.
StartFlushThreshold Ce paramètre contrôle lorsque le cache de page de base de données commence à supprimer des pages du cache pour rendre la place pour les pages qui ne sont pas mises en cache. Lorsque le nombre de mémoires tampons de page dans le cache est inférieur à ce seuil, un processus en arrière-plan est démarré pour régénérer 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 ê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 page de base de données doit avoir à produire des mémoires tampons disponibles avant que l’application ne les ait besoin. Un seuil de démarrage élevé donnera plus de temps au processus en arrière-plan pour réagir. Toutefois, un seuil de démarrage élevé implique un seuil d’arrêt plus élevé et qui réduit la taille effective du cache de page 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 lorsque le cache de page de base de données termine l’évication des pages du cache pour rendre la place 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 commencé à régénérer 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 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 va rendre plus probable que les écritures dans les pages voisines peuvent être combinées. Toutefois, un seuil d’arrêt élevé réduit la taille effective du cache de 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 principal qui contrôle la récupération d’incident pour une instance. Si ce paramètre est défini sur « On », la récupération du style ARIES est utilisée pour amener toutes les bases de données de l’instance à un état cohérent en cas de blocage 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 sont gérées sans bénéficier de la récupération d’incident. Autrement dit, si l’instance n’est pas arrêtée correctement à l’aide de JetTerm avant la sortie du processus ou l’arrêt de la machine, le contenu de toutes les bases de données de cette instance sera endommagé.
EnableOnlineDefrag Ce paramètre contrôle le comportement de la défragmentation en ligne lorsqu’il est initié à 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 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 tant que 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 est vrai, chaque base de données est vérifiée au moment de 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. Pour ce faire, 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 passe de la mise en production à la 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 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 utilisé par le moteur de base de données 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 s’y trouvent à la place.
NoInformationEvent Lorsque ce paramètre est vrai, les messages du journal des événements d’information qui seraient généralement 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 é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 (par génération) pendant la récupération réversible.
CacheSizeMin Ce paramètre configure la taille minimale du cache de 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 relatif à 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 de l’espace supprimé dans la base de données, sont sacrifiées pour conserver la place des 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 processus unique qui contient différentes applications qui utilisent le moteur de base de données, ils doivent tous s’entendre 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. Cela 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 de transactions sur le disque d’une taille 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 silencieusement tous les anciens fichiers journaux, 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 sa taille de fichier journal des transactions tout en continuant à fonctionner de manière 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 au Windows filtre d’exception non géré. Cela entraîne la gestion de l’exception en tant qu’échec de l’application. L’intention 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 l’altération de la base de données 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 au 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 d’accès 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