JET_INDEXCREATE 结构

适用于： Windows |Windows Server

JET_INDEXCREATE 结构包含基于可扩展存储引擎 (ESE) 数据库中的数据创建索引所需的信息。 结构由 JetCreateIndex2 等函数以及 JET_TABLECREATE 和 JET_TABLECREATE2 等结构使用。

typedef struct tagJET_INDEXCREATE {
  unsigned long cbStruct;
  tchar* szIndexName;
  tchar* szKey;
  unsigned long cbKey;
  JET_GRBIT grbit;
  unsigned long ulDensity;
  union {
    unsigned long lcid;
    JET_UNICODEINDEX* pidxunicode;
  };
  union {
    unsigned long cbVarSegMac;
    JET_TUPLELIMITS* ptuplelimits;
  };
  JET_CONDITIONALCOLUMN* rgconditionalcolumn;
  unsigned long cConditionalColumn;
  JET_ERR err;
  unsigned long cbKeyMost;
} JET_INDEXCREATE;

成员

cbStruct

此结构的大小（以字节为单位）。 将此成员设置为 sizeof ( JET_INDEXCREATE ) 。

szIndexName

要创建的索引的名称。

索引的名称必须满足以下条件：

• 它必须小于 JET_cbNameMost，不包括终止 null。

• 它必须包含以下字符：0 (零) 到 9，A 到 Z，a 到 z， 以及除“！” (感叹号) “、” (逗号) “、”[“ (左括号) 和”]“ (右括号) 的标点，即 ASCII 字符0x20、0x22 0x2d、0x2f 0x5a、0x5c、0x5d 0x7f。

• 它不得以空格开头。

• 它必须至少包含一个非空间字符。

szKey

指向以 null 分隔的标记的双 null 终止字符串的指针。

每个标记的格式为“<direction-specifier><column-name>”，其中 direction-specification 为“+”或“-”。 例如，“+abc\0-def\0+ghi\0” 的 szKey 将按升序) (三列“abc”编制索引，“def” (以降序) () 。 在 C 语言中，字符串文本具有隐含 的 NULL 终止符;因此，上述字符串将以双 NULL 终止。

szKey 中指定的列数不能超过 JET_ccolKeyMost 的值， (依赖于版本的常量) 。

在 szKey 中必须至少命名一个列。

过时行为：在双 NULL 终止符之后，可以 (WORD 指定语言 ID，该语言 ID 将传递到 MAKELCID ( langid，SORT_DEFAULT ) ) 作为指定索引 LCID 的一种方式。 通过在 grbit) 中设置JET_bitIndexUnicode，在 JET_UNICODEINDEX (中同时指定 szKey 中的语言 ID 和 LCID 是非法的。

已弃用：在语言 ID 之后，可以将 cbVarSegMac 作为 USHORT 传递。 如果在 szKey 中设置了 USHORT，如果在结构中设置了 cbVarSegMac ，则行为是未定义的。

cbKey

szKey 的长度（以字节为单位），包括两个终止 null。

grbit

包含下表中列出的零个或多个值的一组位。

ulDensity

初始索引 B+ 树的百分比密度。 指定小于 100 的数字最初会占用更多空间来创建索引，但允许索引的未来增长到位，从而避免内部碎片。

lcid

未在 grbit 参数中指定JET_bitIndexUnicode值时，在规范化数据时， (LCID) 区域设置标识符。 如果索引位于 Unicode 列上，则 LCID 会影响规范化。

pidxunicode

如果 grbit 参数中指定了JET_bitIndexUnicode值，则为指向JET_UNICODEINDEX结构的指针。 这允许用户指定在 Unicode 规范化期间传递给 LCMapString 函数的 自定义标志。

cbVarSegMac

未在 grbit 参数中指定JET_bitIndexTupleLimits值时，要存储在索引中的每列的最大长度（以字节为单位）。

为此字段指定值 0 (零) 等效于：

• 为主索引指定JET_cbPrimaryKeyMost。

• 为辅助索引指定JET_cbSecondaryKeyMost。

ptuplelimits

如果 grbit 参数中指定了JET_bitIndexTupleLimits值，则为指向JET_TUPLELIMITS结构的指针。

ptuplelimits 是在 Windows Server 2003 中引入的。

rgconditionalcolumn

JET_CONDITIONALCOLUMN 结构数组的可选参数，用于指定索引中的条件列。

cConditionalColumn

rgconditionalcolumn 数组中的结构计数。

err

包含用于创建此索引的返回代码。

cbKeyMost

指定索引中键的最大允许大小（以字节为单位）。 如果未在 grbit 参数中指定JET_bitIndexKeyMost值，则忽略此参数。 如果此参数设置为零，并在 grbit 参数中指定了JET_bitIndexKeyMost，则调用函数将失败并出现JET_err_InvalidDef。

支持的最小最大密钥大小为 JET_cbKeyMostMin (255) ，即旧版最大密钥大小。

最大密钥大小取决于数据库页大小 (JET_paramDatabasePageSize) ，如下所示：

• 如果 JET_paramDatabasePageSize = 2048，则JET_cbKeyMostMin (255) <= cbKeyMost<= JET_cbKeyMost2KBytePage (500)

• 如果 JET_paramDatabasePageSize = 4096，则JET_cbKeyMostMin (255) <= cbKeyMost<= JET_cbKeyMost4KBytePage (1000)

• 如果 JET_paramDatabasePageSize = 8192，则JET_cbKeyMostMin (255) <= cbKeyMost<= JET_cbKeyMost8KBytePage (2000)

还可以从 JET_paramKeyMost 系统参数中读取实例支持的最大密钥大小。

cbKeyMost 是在 Windows Vista 中引入的。

备注

ESE 支持对包含多个值的键列进行索引编制。 若要使用此功能，该列必须是 (JET_bitColumnTagged) 标记的列类型，并且必须标记为使用JET_bitColumnMultiValued为其多个值编制索引。 在低于 Windows Vista 的 Windows 版本中，只有索引中的第一个多值键列会在索引中展开其值。 所有其他多值列和标记列只会在索引中展开其第一个值。

假设表中存在以下行， (列 Alpha 不是多值，而 Beta、Gamma 和 Delta 列是多值) ，并且索引创建为“+Alpha\0+Beta\0+Gamma\0+Delta\0\0”：

将存储下降的索引元组：

{1，ABC，MNO，VWX}
{1，GHI，MNO，VWX}
{1，JKL，MNO，VWX}
{2，THE，RAIN，IN}

请注意，{2，THE，SPAIN，IN}不会存储，即使第二行中的 Alpha 列恰好具有单个多值。

在从 Windows Vista 开始的 Windows 版本中，可以通过指定JET_bitIndexCrossProduct在索引中扩展所有多值列。

要求

另请参阅

JET_COLTYP
JET_CONDITIONALCOLUMN
JET_ERR
JET_GRBIT
JET_TABLECREATE
JET_TABLECREATE2
JET_TUPLELIMITS
JET_UNICODEINDEX
JetCreateIndex2
JetSetColumn
JetUpdate