Paramètres de base de données

S’applique à : Windows | Windows Server

Paramètres de base de données

Cette rubrique contient les paramètres utilisés pour la base de données.

JET_paramCheckFormatWhenOpenFail
44

Si ce paramètre est défini, JetInit retourne une erreur spéciale lors de l’ouverture d’une base de données ou d’un journal des transactions d’une version précédente du moteur de base de données. Ces erreurs sont les suivantes :

Erreur	Description
JET_errDatabase200Format	La base de données et/ou les fichiers journaux des transactions ont été créés avec le moteur de base de données dans Windows NT 3.51.
JET_errDatabase400Format	La base de données et/ou les fichiers journaux des transactions ont été créés avec le moteur de base de données dans une version de test antérieure à Windows NT Server 4.0.
JET_errDatabase500Format	La base de données et/ou les fichiers journaux des transactions ont été créés avec le moteur de base de données dans Windows NT Server 4.0.

Windows Vista : Pour Windows Vista et versions ultérieures, ce paramètre est obsolète et n’affecte pas le fonctionnement du moteur de base de données.

Étiquette	Valeur
Valeur par défaut :	True
Tapez :	Boolean
Plage valide :	False, True
Étendue :	Instance
Définir après JetCreateInstance :	Oui
Défini après JetInit :	Non
Affecte la disposition physique :	Non
Affecte la fiabilité :	Non
Affecte les performances :	Non
Affecte les ressources :	Non
Disponibilité :	Tous

JET_paramDatabasePageSize
64

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.

Note 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, elles doivent toutes convenir d’une taille de page de base de données.

Étiquette	Valeur
Valeur par défaut :	4096
Tapez :	Integer
Plage valide :	2048, 4096, 8192
Étendue :	Global
Définir après JetCreateInstance :	Non
Défini après JetInit :	Non
Affecte la disposition physique :	Oui
Affecte la fiabilité :	Non
Affecte les performances :	Oui
Affecte les ressources :	Oui
Disponibilité :	Tous

JET_paramDbExtensionSize
18

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.

Étiquette	Valeur
Valeur par défaut :	256
Tapez :	Integer
Plage valide :	1 – 2147483647
Étendue :	Instance
Définir après JetCreateInstance :	Oui
Défini après JetInit :	Non Windows Vista : Pour Windows Vista et versions ultérieures : Oui
Affecte la disposition physique :	Non
Affecte la fiabilité :	Non
Affecte les performances :	Oui
Affecte les ressources :	Oui
Disponibilité :	Tous

JET_paramEnableIndexChecking
45

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_errPrimaryIndexCorrupted.

Si des index secondaires sont détectés dans cet état, il existe deux résultats possibles. Si JET_bitDbDeleteCorruptIndexes a été passé à JetAttachDatabase , ces index sont supprimés et JET_wrnCorruptIndexDeleted sont retournés à partir de JetAttachDatabase. Ces index devront être recréés par votre application. Si JET_bitDbDeleteCorruptIndexes n’a pas été passé à JetAttachDatabase , l’appel échoue avec JET_errSecondaryIndexCorrupted.

Note Il est vivement recommandé que ce paramètre soit défini sur True par votre application.

Note Il est vivement recommandé aux applications d’éviter d’utiliser des colonnes de clé Unicode dans leurs index de clé primaire (cluster).

Étiquette	Valeur
Valeur par défaut :	False
Tapez :	Boolean
Plage valide :	False, True
Étendue :	Global Windows Vista : Pour Windows Vista et versions ultérieures : Instance
Définir après JetCreateInstance :	Non
Définir après JetInit :	Non
Affecte la disposition physique :	Non
Affecte la fiabilité :	Oui
Affecte les performances :	Non
Affecte les ressources :	Non
Disponibilité :	Tous

JET_paramEnableIndexCleanup
54

Lorsque ce paramètre est défini sur true, le moteur de base de données peut automatiquement propre des index vers le haut sur des colonnes clés Unicode au moment de JetInit, si nécessaire, afin d’éviter les changements de format de base de données causés par des modifications apportées à la bibliothèque NLS dans Windows. De telles modifications sont apportées régulièrement à la bibliothèque NLS pour ajouter la prise en charge de nouvelles langues, pour ajouter des caractères manquants à une langue, pour ajouter un ordre de classement à une langue ou pour corriger des bogues dans l’ordre de classement d’une langue. Ces modifications affectent les clés de tri produites par LCMapStringW qui sont conservées par le moteur de base de données en tant que composants des clés d’index.

Il est important de comprendre qu’il est possible que les modifications apportées à l’index soient si importantes qu’un nettoyage incrémentiel n’est pas possible. Dans ce cas, l’index est géré comme prescrit par JET_paramEnableIndexChecking.

Note Il est vivement recommandé de définir ce paramètre et JET_paramEnableIndexChecking sur True par votre application.

Étiquette	Valeur
Valeur par défaut :	True
Tapez :	Boolean
Plage valide :	False, True
Étendue :	Instance
Définir après JetCreateInstance :	Oui
Définir après JetInit :	Non Windows Vista : Pour Windows Vista et versions ultérieures : Oui
Affecte la disposition physique :	Non
Affecte la fiabilité :	Non
Affecte les performances :	Non
Affecte les ressources :	Non
Disponibilité :	Windows Server 2003 et versions ultérieures

JET_paramOneDatabasePerSession
102

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.

Windows XP et Windows Server 2003 : Ce paramètre est écrit uniquement sur Windows XP et Windows Server 2003.

Windows Vista : Ce paramètre se comporte normalement à partir de Windows Vista.

Note Ce paramètre est en écriture uniquement.

Étiquette	Valeur
Valeur par défaut :	False
Tapez :	Boolean
Plage valide :	False, True
Étendue :	Global
Définir après JetCreateInstance :	Non Windows Vista : Pour Windows Vista et versions ultérieures : Oui
Définir après JetInit :	Non
Affecte la disposition physique :	Non
Affecte la fiabilité :	Non
Affecte les performances :	Non
Affecte les ressources :	Non
Disponibilité :	Windows XP et versions ultérieures

JET_paramEnableOnlineDefrag
35

Ce paramètre contrôle le comportement de la défragmentation en ligne lorsqu’elle est lancée à l’aide de JetDefragment. Pour plus d’informations, consultez JetDefragment .

Windows 2000 : sur Windows 2000, ce paramètre était un simple booléen qui contrôlerait la défragmentation en ligne lorsqu’elle était lancée par JetDefragment. Lorsque la valeur est TRUE, la défragmentation en ligne est effectuée sur les enregistrements de chaque table de la base de données.

Windows XP : Sur Windows XP et les versions ultérieures, ce paramètre peut être défini sur une ou plusieurs des options suivantes :

Option	Description
JET_OnlineDefragDisable	N’effectuez pas de défragmentation en ligne. Il s’agit de l’équivalent binaire de la valeur False de Windows 2000 pour ce paramètre.
JET_OnlineDefragAllOBSOLETE	Effectuer une défragmentation en ligne complète. Il s’agit de l’équivalent binaire du paramètre Windows 2000 de True pour ce paramètre.
JET_OnlineDefragDatabases	Effectuez la défragmentation en ligne des enregistrements de chaque table de la base de données.
JET_OnlineDefragSpaceTrees	Effectuez la défragmentation en ligne des arborescences d’espace de chaque table de la base de données.
JET_OnlineDefragStreamingFiles	Ce paramètre est utilisé pour prendre en charge l’infrastructure Microsoft Exchange et n’est pas destiné à être utilisé dans votre application.
JET_OnlineDefragAll	Effectuer une défragmentation en ligne complète. Il s’agit de l’équivalent conceptuel au paramètre Windows 2000 de True pour ce paramètre.

Étiquette	Valeur
Valeur par défaut :	Windows 2000 : Vrai Windows XP : pour Windows XP et versions ultérieures : JET_OnlineDefragAll
Tapez :	Windows 2000 : Boolean Windows XP et versions ultérieures : JET_GRBIT (entier)
Plage valide :	Windows 2000 : False, True Windows XP et versions ultérieures : 0 – JET_OnlineDefragAll
Étendue :	Instance
Définir après JetCreateInstance :	Oui
Défini après JetInit :	Oui
Affecte la disposition physique :	Non
Affecte la fiabilité :	Oui
Affecte les performances :	Oui
Affecte les ressources :	Non
Disponibilité :	Tous

JET_paramPageFragment
20

Ce paramètre est le seuil utilisé par le moteur de base de données pour contrôler la fragmentation de l’espace libre. La taille est dans les pages de base de données.

Étiquette	Valeur
Valeur par défaut :	8
Tapez :	Integer
Plage valide :	0 – 2147483647
Étendue :	Instance
Définir après JetCreateInstance :	Oui
Défini après JetInit :	Non
Affecte la disposition physique :	Non
Affecte la fiabilité :	Non
Affecte les performances :	Oui
Affecte les ressources :	Oui
Disponibilité :	Tous

JET_paramRecordUpgradeDirtyLevel
78

Ce paramètre contrôle l’agressivité avec laquelle le gestionnaire de cache de page de base de données écrit une page de base de données qui a subi une conversion au format in place. Ces conversions de format se produisent à la volée lorsque les pages sont chargées à partir d’une base de données créée avec le moteur de base de données Windows 2000, mais utilisée par une version Windows XP ou ultérieure du moteur de base de données.

Étiquette	Valeur
Valeur par défaut :	1
Tapez :	Integer
Plage valide :	0-3
Étendue :	Global
Définir après JetCreateInstance :	Oui
Défini après JetInit :	Oui
Affecte la disposition physique :	Oui
Affecte la fiabilité :	Non
Affecte les performances :	Oui
Affecte les ressources :	Non
Disponibilité :	Windows XP et versions ultérieures

JET_paramWaypointLatency
153

La latence (dans les journaux) derrière le pourboire/le journal le plus élevé pour différer le vidage de la page de base de données. L’activation de cette latence peut permettre la récupération de base de données en cas de perte catastrophique du fichier journal le plus récent. Voir JET_bitReplayIgnoreLostLogs.

Étiquette	Valeur
Valeur par défaut :	0
Tapez :	Integer
Plage valide :	0-1023
Étendue :	Instance
Définir après JetCreateInstance :	Oui
Définir après JetInit :	Non
Affecte la disposition physique :	Non
Affecte la fiabilité :	Oui
Affecte les performances :	Oui
Affecte les ressources :	Non
Disponibilité :	Windows 7

JET_paramDefragmentSequentialBTrees
160

Activez/désactivez la défragmentation séquentielle automatique des arborescences B.

Étiquette	Valeur
Valeur par défaut :	1
Tapez :	Boolean
Plage valide :	0-1
Étendue :	Instance
Définir après JetCreateInstance :	Oui
Définir après JetInit :	Non
Affecte la disposition physique :	Oui
Affecte la fiabilité :	Non
Affecte les performances :	Oui
Affecte les ressources :	Non
Disponibilité :	Windows 7

JET_paramDefragmentSequentialBTreesDensityCheckFrequency
161

Détermine la fréquence à laquelle la densité de l’arborescence B est vérifiée.

Étiquette	Valeur
Valeur par défaut :	10
Tapez :	Integer
Plage valide :	Entier maximal 0
Étendue :	Instance
Définir après JetCreateInstance :	Oui
Définir après JetInit :	Non
Affecte la disposition physique :	Oui
Affecte la fiabilité :	Non
Affecte les performances :	Oui
Affecte les ressources :	Non
Disponibilité :	Windows 7

JET_paramIOThrottlingTimeQuanta
162

Durée maximale, en millisecondes, que le mécanisme de limitation des E/S donne à une tâche à exécuter pour qu’elle soit considérée comme « terminée ».

Étiquette	Valeur
Valeur par défaut :	125
Tapez :	Integer
Plage valide :	0-10000
Étendue :	Global
Définir après JetCreateInstance :	Oui
Définir après JetInit :	Non
Affecte la disposition physique :	Non
Affecte la fiabilité :	Non
Affecte les performances :	Oui
Affecte les ressources :	Non
Disponibilité :	Windows 7

Spécifications

Condition requise	Valeur
Client	Nécessite Windows Vista, Windows XP ou Windows 2000 Professionnel.
Serveur	Nécessite Windows Server 2008, Windows Server 2003 ou Windows 2000 Server.
En-tête	Déclaré dans Esent.h.

Voir aussi

JetAttachDatabase
JetCreateInstance
JetDefragment
JetInit