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