Struttura JET_TUPLELIMITS

Si applica a: Windows | Windows Server

Struttura JET_TUPLELIMITS

La struttura JET_TUPLELIMITS consente la personalizzazione delle caratteristiche dell'indice della tupla in base all'indice, anziché in base all'istanza, usando JetSetSystemParameter.

Windows Server 2003: La struttura JET_TUPLELIMITS è stata introdotta in Windows Server 2003.

    typedef struct tagJET_TUPLELIMITS {
      unsigned long chLengthMin;
      unsigned long chLengthMax;
      unsigned long chToIndexMax;
      unsigned long cchIncrement;
      unsigned long ichStart;
    } JET_TUPLELIMITS;

Membri

chLengthMin

Lunghezza minima di una tupla. Il valore predefinito è 3.

chLengthMax

Lunghezza massima di una tupla. Il valore predefinito è 10.

chToIndexMax

Lunghezza massima di una stringa da indicizzare. Ad esempio, se una colonna è lunga 100 caratteri e chToIndexMax è impostata su 60, verranno indicizzati solo i primi 60 caratteri della colonna. Il valore predefinito è 32767.

cchIncrement

Ciò consente di configurare lo stride in base all'indice.

Windows Vista: Il membro cchIncrement viene introdotto in Windows Vista. Prima di Windows Vista, la quantità di spostamento della finestra (il "stride") era sempre 1, come illustrato nell'esempio nella sezione osservazioni.

ichStart

Offset nel valore per iniziare a recuperare le tuple dal valore.

Windows Vista: Il membro ichStart viene introdotto in Windows Vista.

Commenti

Un indice di tupla illustra una stringa e indicizza tutte le possibili sottostringhe di chLengthMax. Alla fine della stringa (o in corrispondenza della posizione chToIndexMax, a seconda di quale condizione si verifica per prima), le sottostringhe di almeno chLengthMin verranno indicizzate.

È possibile usare un indice di tupla per la ricerca di stringhe con caratteri jolly iniziali e finali.

Supponendo che una riga con un campo di testo "RAIN IN SPAGNA!", se un indice di tupla viene creato con parametri chLengthMin=2 e chLengthMax=3, nell'indice vengono create le voci seguenti:

"RAI"
"AIN"
"IN "
"N I"
" IN"
"IN "
"N S"
" SP"
"SPA"
"PAI"
"AIN"
"IN!"
"N!"

Si noti che "IN" si verifica due volte e che l'ultima voce ("N!") è più breve di 3 (chLengthMax). Si noti anche che l'algoritmo di suddivisione non riconosce spazi o parole e tratta tutti i caratteri in modo identico.

Windows XP: Windows XP supporta gli indici di tupla, ma non dispone di JET_TUPLELIMITS. Il motore di database utilizzerà i valori predefiniti (chLengthMin=3, chLengthMax=10, chToIndexMax=32767). È comunque possibile modificare questi valori, ma vengono impostati per ogni istanza usando JetSetSystemParameter con JET_paramIndexTuplesLengthMin, JET_paramIndexTuplesLengthMax e JET_paramIndexTuplesToIndexMax.

Requisiti

Requisito	Valore
Client	Richiede Windows Vista.
Server	Richiede Windows Server 2008, Windows Server 2003.
Intestazione	Dichiarato in Esent.h.

Vedere anche

JET_COLTYP
JET_INDEXCREATE
JET_TUPLELIMITS
JetSetSystemParameter