Estrutura JET_TUPLELIMITS

Artigo
06/13/2023

Aplica-se a: Windows | Windows Server

Estrutura JET_TUPLELIMITS

A estrutura JET_TUPLELIMITS permite a personalização das características do índice de tupla por índice, em vez de uma base por instância, usando JetSetSystemParameter.

Windows Server 2003: A estrutura JET_TUPLELIMITS é introduzida no Windows Server 2003.

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

Membros

chLengthMin

O comprimento mínimo de uma tupla. O valor padrão é 3.

chLengthMax

O comprimento máximo de uma tupla. O valor padrão é 10.

chToIndexMax

O comprimento máximo de uma cadeia de caracteres a ser indexada. Por exemplo, se uma coluna tiver 100 caracteres e chToIndexMax for definido como 60, somente os primeiros 60 caracteres da coluna serão indexados. O valor padrão é 32767.

cchIncrement

Isso permite que o passo a passo seja configurado por índice.

Windows Vista: O membro cchIncrement é introduzido no Windows Vista. Antes do Windows Vista, o valor para deslocar a janela (o "passo") era sempre 1, como é mostrado no exemplo na seção de comentários.

ichStart

O deslocamento para o valor para começar a recuperar tuplas do valor.

Windows Vista: O membro ichStart é introduzido no Windows Vista.

Comentários

Um índice de tupla orienta uma cadeia de caracteres e indexa todas as suas subcadeias de caracteres possíveis de chLengthMax. No final da cadeia de caracteres (ou na posição chToIndexMax, o que ocorrer primeiro), as subcadeias de caracteres de pelo menos chLengthMin serão indexadas.

Um índice de tupla pode ser usado para pesquisar cadeias de caracteres com caracteres curinga à esquerda e à direita.

Supondo que uma linha com um campo de texto "RAIN IN SPAIN!", se um índice de tupla for criado com os parâmetros chLengthMin=2 e chLengthMax=3, as seguintes entradas serão criadas no índice:

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

Observe que "IN" ocorre duas vezes e que a última entrada ("N!") é menor que 3 (chLengthMax). Observe também que o algoritmo de divisão não está ciente de espaços ou palavras e trata todos os caracteres de forma idêntica.

Windows XP: O Windows XP dá suporte a índices de tupla, mas não tem JET_TUPLELIMITS. O mecanismo de banco de dados usará os valores padrão (chLengthMin=3, chLengthMax=10, chToIndexMax=32767). Ainda é possível alterar esses valores, mas eles são definidos por instância usando JetSetSystemParameter com JET_paramIndexTuplesLengthMin, JET_paramIndexTuplesLengthMax e JET_paramIndexTuplesToIndexMax.

Requisitos

Requisito	Valor
Cliente	Requer o Windows Vista.
Servidor	Requer o Windows Server 2008, Windows Server 2003.
Cabeçalho	Declarado em Esent.h.

Consulte Também

JET_COLTYP
JET_INDEXCREATE
JET_TUPLELIMITS
JetSetSystemParameter

Estrutura JET_TUPLELIMITS