JET_TUPLELIMITS結構

發行項
06/13/2023

適用于： Windows |Windows Server

JET_TUPLELIMITS結構

JET_TUPLELIMITS結構允許使用JetSetSystemParameter，以個別索引為基礎自訂 Tuple 索引特性，而不是個別實例。

Windows Server 2003： windows Server 2003 引進 JET_TUPLELIMITS 結構。

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

成員

chLengthMin

Tuple 的最小長度。預設值是 3。

chLengthMax

Tuple 的最大長度。預設值是 10。

chToIndexMax

要編制索引之字串的最大長度。例如，如果資料行長度為 100 個字元，且 chToIndexMax 設為 60，則只會編制資料行的前 60 個字元的索引。預設值為 32767。

cchIncrement

這可讓每個索引設定步幅。

Windows Vista：cchIncrement成員是在 Windows Vista 中引進。在 Windows Vista 之前，將視窗移位 (「步幅」) 一律為 1，如一節中的範例所示。

ichStart

要開始從值擷取 Tuple 的值位移。

Windows Vista：ichStart成員是在 Windows Vista 中引進。

備註

Tuple 索引會逐步執行字串，並編制 chLengthMax所有可能子字串的索引。在字串結尾 (或位置 chToIndexMax，不論發生哪一個情況，都會先) ，至少 會編制 chLengthMin 的子字串索引。

元組索引可用於搜尋具有前置和尾端萬用字元的字串。

假設資料列的文字欄位為「RAIN IN SPAIN！」，如果使用chLengthMin=2 和 chLengthMax=3 參數建立 Tuple 索引，則會在索引中建立下列專案：

「RAI」
「AIN」
「IN」
「N I」
「 IN」
「IN」
「N S」
「 SP」
「SPA」
「PAI」
「AIN」
「IN！」
「N！」

請注意，「IN」發生兩次，且最後一個專案 (「N！」) 短于 3 (chLengthMax) 。另請注意，分割演算法不知道空格或單字，而且會以相同方式處理所有字元。

Windowsxp： Windows XP 支援元組索引，但沒有 JET_TUPLELIMITS。資料庫引擎將使用預設值 (chLengthMin=3、 chLengthMax=10、 chToIndexMax=32767) 。仍然可以變更這些值，但會使用 JetSetSystemParameter 搭配 JET_paramIndexTuplesLengthMin、 JET_paramIndexTuplesLengthMax和 JET_paramIndexTuplesToIndexMax，依實例設定這些值。

規格需求

需求	值
用戶端	需要 Windows Vista。
Server	需要 Windows Server 2008、Windows Server 2003。
標頭	在 Esent.h 中宣告。

另請參閱

JET_COLTYP
JET_INDEXCREATE
JET_TUPLELIMITS
JetSetSystemParameter

共用方式為

JET_TUPLELIMITS結構