JET_TUPLELIMITS Structure

Article
06/13/2023

S’applique à : Windows | Windows Server

JET_TUPLELIMITS Structure

La structure JET_TUPLELIMITS permet la personnalisation des caractéristiques d’index de tuples par index, plutôt que 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 contient 100 caractères et que chToIndexMax est défini sur 60, seuls les 60 premiers caractères de la colonne sont indexés. La valeur par défaut est 32767.

cchIncrement

Cela permet de configurer la foulée par index.

Windows Vista : Le membre cchIncrement est introduit dans Windows Vista. Avant Windows Vista, la quantité de décalage de la fenêtre (la « foulée ») était toujours égale à 1, comme illustré dans l’exemple de la section remarques.

ichStart

Décalage dans la valeur pour commencer à récupérer les tuples de la valeur.

Windows Vista : Le membre ichStart est introduit dans Windows Vista.

Notes

Un index de tuple guide 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 sont indexées.

Un index 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 « RAIN IN SPAIN! », 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 »
« AIN »
« IN »
« N I »
« IN »
« IN »
« N S »
« SP »
« SPA »
« PAI »
« AIN »
« IN! »
« N! »

Notez que « IN » se produit deux fois, et que la dernière entrée (« N ! ») est inférieur à 3 (chLengthMax). Notez également que l’algorithme de fractionnement ne prend pas en compte les espaces ou les mots et traite tous les caractères de la même manière.

Windows XP : Windows XP prend en charge les index tuples, mais n’a pas de JET_TUPLELIMITS. Le moteur de base de données utilise les valeurs par défaut (chLengthMin=3, chLengthMax=10, chToIndexMax=32767). Il est toujours possible de modifier ces valeurs, mais elles sont définies par instance à l’aide de JetSetSystemParameter avec JET_paramIndexTuplesLengthMin, JET_paramIndexTuplesLengthMax et JET_paramIndexTuplesToIndexMax.

Spécifications

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

Voir aussi

JET_COLTYP
JET_INDEXCREATE
JET_TUPLELIMITS
JetSetSystemParameter

JET_TUPLELIMITS Structure