Структура JET_TUPLELIMITS

Статья
06/13/2023

Применимо к: Windows | Windows Server

Структура JET_TUPLELIMITS

Структура JET_TUPLELIMITS позволяет настраивать характеристики индекса кортежа для каждого индекса, а не для каждого экземпляра, используя JetSetSystemParameter.

Windows Server 2003: Структура JET_TUPLELIMITS появилась в Windows Server 2003.

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

Элементы

chLengthMin

Минимальная длина кортежа. Значение по умолчанию равно 3.

chLengthMax

Максимальная длина кортежа. Значение по умолчанию — 10.

chToIndexMax

Максимальная длина индексации строки. Например, если столбец имеет длину 100 символов, а параметр chToIndexMax имеет значение 60, индексируются только первые 60 символов столбца. Значение по умолчанию — 32767.

cchIncrement

Это позволяет настроить шаг для каждого индекса.

Windows Vista: Элемент cchIncrement появился в Windows Vista. До windows Vista значение смещения окна ("шаг") всегда составляло 1, как показано в примере в разделе примечаний.

ichStart

Смещение в значение для начала получения кортежей из значения.

Windows Vista: Элемент ichStart появился в Windows Vista.

Индекс кортежа проходит по строке и индексирует все возможные подстроки chLengthMax. В конце строки (или в позиции chToIndexMax, в зависимости от того, что произойдет раньше) будут индексированы подстроки по крайней мере chLengthMin .

Индекс кортежа можно использовать для поиска строк как с начальными, так и конечными подстановочными знаками.

При условии, что строка с текстовым полем "RAIN IN SPAIN!", если создается индекс кортежа с параметрами chLengthMin=2 и chLengthMax=3, в индексе создаются следующие записи:

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

Обратите внимание, что "IN" происходит дважды и что последняя запись ("N!") короче 3 (chLengthMax). Также обратите внимание, что алгоритм разделения не учитывает пробелы или слова и обрабатывает все символы одинаково.

Windows XP: Windows XP поддерживает индексы кортежей, но не имеет JET_TUPLELIMITS. Ядро СУБД будет использовать значения по умолчанию (chLengthMin=3, chLengthMax=10, chToIndexMax=32767). Эти значения по-прежнему можно изменить, но они задаются для каждого экземпляра с помощью JetSetSystemParameter с JET_paramIndexTuplesLengthMin, JET_paramIndexTuplesLengthMax и JET_paramIndexTuplesToIndexMax.

Требования

Требование	Значение
Клиент	Требуется Windows Vista.
Сервер	Требуется Windows Server 2008, Windows Server 2003.
Верхняя часть	Объявлено в Esent.h.

См. также:

JET_COLTYP
JET_INDEXCREATE
JET_TUPLELIMITS
JetSetSystemParameter

Структура JET_TUPLELIMITS