INDEX 命令

创建索引文件,以按逻辑顺序显示和访问表记录。

语法

  
INDEX ON eExpression TO IDXFileName | TAG TagName [OF CDXFileName]  
   [FOR lExpression]  
   [COMPACT]  
   [ASCENDING | DESCENDING]  
   [UNIQUE | CANDIDATE]  
   [ADDITIVE]  

论据

eExpression
指定一个索引表达式,该表达式可以包含当前表中的字段或字段的名称。 基于索引表达式的索引键是在表中每个记录的索引文件中创建的。 Visual FoxPro 使用这些键来显示和访问表中的记录。

注释

虽然不建议这样做, 但 eExpression 也可以是内存变量、数组元素或另一工作区域中表中的字段或字段表达式。 备注字段不能单独用于索引文件表达式;它们必须与其他字符表达式结合使用。 如果访问包含不再存在的变量或字段或字段的索引,Visual FoxPro 将生成错误消息。

如果尝试生成长度变化的键的索引,则密钥将填充空格。 Visual FoxPro 不支持可变长度索引键。

可以创建长度为零的索引键。 例如,当索引表达式是空备注字段的子字符串时,将创建零长度索引键。 零长度索引键生成错误消息。 当 Visual FoxPro 创建索引时,它会计算表中第一条记录中的字段。 如果字段为空,则可能需要在第一条记录的字段中输入一些临时数据,以防止长度为 0 的索引键。

TO IDXFileName
创建 .idx 索引文件。 为索引文件提供默认扩展名 .idx。

TAG TagName[OF CDXFileName]
创建复合索引文件。 复合索引文件是包含任意数量的单独标记(索引项)的单个索引文件。 每个标记都由其唯一的标记名称标识。 标记名称必须以字母或下划线开头,并且可以包含最多 10 个字母、数字或下划线的任意组合。 复合索引文件中的标记数仅受可用内存和磁盘空间的限制。

多条目复合索引文件始终紧凑。 创建复合索引文件时,无需包含 COMPACT。 复合索引文件的名称以 .cdx 扩展名提供。

可以创建两种类型的复合索引文件:结构和非结构。

结构复合索引文件可以通过排除可选的 OF CDXFileName 子句来创建具有 TAG TagName 的结构复合索引文件。 结构复合索引文件始终具有与表相同的基名称,并在打开表时自动打开。

非结构复合索引文件可以通过在 TAG TagName 后面包括 OF CDXFileName 来创建非结构复合索引文件。 与结构复合索引文件不同,必须使用 USE 中的子句显式打开 INDEX 非结构复合索引文件。

如果已创建并打开复合索引文件,则使用 TAG TagName 发出INDEX会将标记添加到复合索引文件。

FOR lExpression
指定一个条件,即只有满足筛选表达式 lExpression 的记录可用于显示和访问;索引键在索引文件中仅为与筛选器表达式匹配的记录创建。

Visual FoxPro Rushmore 技术优化 INDEX ...如果 lExpression 是可优化表达式,则为 FOR lExpression 命令。 为了获得最佳性能,请使用 FOR 子句中的可优化表达式。

紧凑的
创建压缩的 .idx 文件。

上升
指定 .cdx 文件的升序。 默认情况下,按升序创建 .cdx 标记。 (可以添加 ASCENDING 作为索引文件顺序的提醒。可以通过包括 DESCENDING 以相反顺序对表编制索引。

降
指定 .cdx 文件的降序。 创建 .idx 索引文件时,不能包含 DESCENDING。

独特
指定只有遇到特定索引键值的第一条记录包含在 .idx 文件或 .cdx 标记中。 UNIQUE 可用于防止显示或访问重复记录。 使用重复索引键添加的所有记录均从索引文件中排除。 使用 UNIQUE 选项INDEX与在颁发INDEX或 REINDEX 之前执行 SET UNIQUE ON 相同。

当 UNIQUE 索引或索引标记处于活动状态且重复记录以更改索引键的方式发生更改时,将更新索引或索引标记。 但是,在使用 REINDEX 重新编制文件索引之前,无法访问或显示具有原始索引键的下一个重复记录。

候选人
创建候选结构索引标记。 仅当创建结构索引标记时,才能包含 CANDIDATE 关键字;否则,Visual FoxPro 将生成错误消息。

候选索引标记可防止在索引表达式 eExpression 中指定的字段或字段的组合中重复值。 候选术语是指索引的类型;由于候选索引会阻止重复值,因此它们有资格成为主索引的“候选项”。

如果为字段或已包含重复值的字段组合创建候选索引标记,Visual FoxPro 将生成错误。

添加剂
保持打开以前打开的任何索引文件。 如果在为表 INDEX创建索引文件或文件时省略 ADDITIVE 子句,则任何以前打开的索引文件(结构复合索引除外)均已关闭。

注解

按索引表达式指定的顺序显示和访问具有索引文件的表中的记录。 表中记录的物理顺序不会由索引文件更改。

索引类型

Visual FoxPro 允许创建两种类型的索引文件:

  • 复合 .cdx 索引文件,其中包含多个称为标记的索引项

  • 包含一个索引项的 .idx 索引文件

还可以创建结构复合索引文件,该文件随表自动打开。

注释

由于打开表时会自动打开结构复合索引文件,因此它们是首选索引类型。

包括 COMPACT 以创建压缩的 .idx 索引文件。 复合索引文件始终紧凑。

索引顺序和更新

只有一个索引文件(主索引文件)或标记(主标记)控制显示或访问表的顺序。 某些命令(例如 SEEK)使用主索引文件或标记来搜索记录。 但是,所有打开的 .idx 和 .cdx 索引文件都会更新,因为对表进行了更改。

用户定义的函数

尽管索引表达式可以包含用户定义的函数,但不应在索引表达式中使用用户定义的函数。 索引表达式中的用户定义的函数会增加创建或更新索引所需的时间。 此外,当用户定义的函数用于索引表达式时,可能不会发生索引更新。

如果在索引表达式中使用用户定义的函数,Visual FoxPro 必须能够找到用户定义的函数。 当 Visual FoxPro 创建索引时,索引表达式将保存在索引文件中,但索引表达式中仅包含对用户定义函数的引用。

另请参阅

ALTER TABLE - SQL 命令
DELETE TAG 命令
SET COLLATE 命令
SET UNIQUE 命令