Structure JET_TUPLELIMITS
S’applique à : Windows | Windows Serveurs
Structure JET_TUPLELIMITS
La structure JET_TUPLELIMITS permet de personnaliser les caractéristiques de l’index de tuples par index, plutôt qu’une base par instance, à l’aide de JetSetSystemParameter.
Windows Server 2003 : la structure JET_TUPLELIMITS est introduite dans Windows Server 2003.
typedef struct tagJET_TUPLELIMITS {
unsigned long chLengthMin;
unsigned long chLengthMax;
unsigned long chToIndexMax;
unsigned long cchIncrement;
unsigned long ichStart;
} JET_TUPLELIMITS;
Membres
chLengthMin
Longueur minimale d’un tuple. La valeur par défaut est 3.
chLengthMax
Longueur maximale d’un tuple. La valeur par défaut est 10.
chToIndexMax
Longueur maximale d’une chaîne à indexer. Par exemple, si une colonne a une longueur de 100 caractères et que chToIndexMax est défini sur 60, seuls les 60 premiers caractères de la colonne seront indexés. La valeur par défaut est 32767.
cchIncrement
Cela permet de configurer le Stride sur une base par index.
Windows Vista : le membre cchIncrement est introduit dans Windows Vista. avant Windows Vista, la quantité de décalage de la fenêtre (« stride ») était toujours de 1, comme indiqué dans l’exemple de la section notes.
ichStart
Offset dans la valeur pour commencer à récupérer des tuples à partir de la valeur.
Windows Vista : le membre ichStart est introduit dans Windows Vista.
Notes
Un index de tuple parcourt une chaîne et indexe toutes ses sous-chaînes possibles de chLengthMax. À la fin de la chaîne (ou à la position chToIndexMax, selon ce qui se produit en premier), les sous-chaînes d’au moins chLengthMin seront indexées.
Un index de tuple peut être utilisé pour rechercher des chaînes avec des caractères génériques de début et de fin.
En supposant une ligne avec un champ de texte « pluie en Espagne ! », si un index de tuple est créé avec les paramètres chLengthMin= 2 et chLengthMax= 3, les entrées suivantes sont créées dans l’index :
"RAI"
Ayn
DANS
« N I »
DANS
DANS
« N S »
SR
Spa
"PAI"
Ayn
« IN ! »
« N ! »
Notez que « IN » se produit deux fois, et que la dernière entrée (« N ! ») est plus petite que 3 (chLengthMax). Notez également que l’algorithme de fractionnement ne tient pas compte des espaces ou des mots et traite tous les caractères de la même façon.
Windows xp : Windows xp prend en charge les index de tuple, mais n’a pas de JET_TUPLELIMITS. Le moteur de base de données utilisera les valeurs par défaut (chLengthMin= 3, chLengthMax= 10, chToIndexMax= 32767). Il est toujours possible de modifier ces valeurs, mais elles sont définies en fonction de l’instance à l’aide de JetSetSystemParameter avec JET_paramIndexTuplesLengthMin, JET_paramIndexTuplesLengthMaxet JET_paramIndexTuplesToIndexMax.
Spécifications
| Condition requise | Valeur |
|---|---|
Client |
requiert Windows Vista. |
Serveur |
requiert Windows server 2008, Windows server 2003. |
En-tête |
Déclaré dans esent. h. |
Voir aussi
JET_COLTYP
JET_INDEXCREATE
JET_TUPLELIMITS
JetSetSystemParameter