estructura de JET_TUPLELIMITS

Se aplica a: Windows | Windows Server

estructura de JET_TUPLELIMITS

La estructura de JET_TUPLELIMITS permite personalizar las características del índice de tupla por índice, en lugar de por instancia, mediante JetSetSystemParameter.

Windows Server 2003: La estructura JET_TUPLELIMITS se introduce en Windows Server 2003.

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

Miembros

chLengthMin

Longitud mínima de una tupla. El valor predeterminado es 3.

chLengthMax

Longitud máxima de una tupla. El valor predeterminado es 10.

chToIndexMax

Longitud máxima de una cadena que se va a indexar. Por ejemplo, si una columna tiene 100 caracteres y chToIndexMax se establece en 60, solo se indexarán los primeros 60 caracteres de la columna. El valor predeterminado es 32767.

cchIncrement

Esto permite configurar el paso por índice.

Windows Vista: El miembro cchIncrement se introduce en Windows Vista. Antes de Windows Vista, la cantidad para desplazar la ventana (el "paso") siempre era 1, como se muestra en el ejemplo de la sección comentarios.

ichStart

Desplazamiento en el valor para empezar a recuperar tuplas del valor.

Windows Vista: El miembro ichStart se presenta en Windows Vista.

Comentarios

Un índice de tupla recorre una cadena e indexa todas sus posibles subcadenas de chLengthMax. Al final de la cadena (o en la posición chToIndexMax, lo que ocurra primero), se indexarán las subcadenas de al menos chLengthMin .

Se puede usar un índice de tupla para buscar cadenas con caracteres comodín iniciales y finales.

Suponiendo que una fila con un campo de texto de "RAIN IN SPAIN!", si se crea un índice de tupla con parámetros chLengthMin=2 y chLengthMax=3, se crean las siguientes entradas en el índice:

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

Tenga en cuenta que "IN" se produce dos veces y que la última entrada ("N!") es más corto que 3 (chLengthMax). Tenga en cuenta también que el algoritmo de división no es consciente de espacios o palabras y trata todos los caracteres de forma idéntica.

Windows XP: Windows XP admite índices de tupla, pero no tiene JET_TUPLELIMITS. El motor de base de datos usará los valores predeterminados (chLengthMin=3, chLengthMax=10, chToIndexMax=32767). Todavía es posible cambiar estos valores, pero se establecen por instancia mediante JetSetSystemParameter con JET_paramIndexTuplesLengthMin, JET_paramIndexTuplesLengthMax y JET_paramIndexTuplesToIndexMax.

Requisitos

Requisito	Value
Cliente	Requiere Windows Vista.
Servidor	Requiere Windows Server 2008, Windows Server 2003.
Encabezado	Declarado en Esent.h.

Consulte también

JET_COLTYP
JET_INDEXCREATE
JET_TUPLELIMITS
JetSetSystemParameter