文档中心

AI 数据湖服务

元数据管理

索引管理

索引是加速 Lance 表查询性能的关键结构，可显著提升标量字段过滤、全文检索以及高维向量相似度检索的效率。在 LAS 元数据中，您可以为 Lance 表查看、创建、增量构建或删除索引，通过产品化的索引生命周期管理降低索引运维成本。索引基于构建时对应的数据版本生效；当表持续写入新数据后，您可以通过增量构建将索引更新至最新数据版本。

注意事项

索引管理为白名单功能。如果您希望使用此功能，请提交工单联系开通功能白名单。

本文适用于存储在 TOS 并接入 LAS Catalog 的 Lance 表。索引管理仅支持 Lance 7.x 及以上版本。

准备工作

权限要求

创建索引、增量构建索引、删除索引需要表的 Alter 权限。

资源要求

索引相关任务依赖表级计算资源。首次使用前，请先在表详情页右上角的计算资源配置中关联可用的 EMR Serverless 队列和计算组。具体绑定步骤和说明，请参见：计算资源配置。

注意

创建索引和增量构建索引会使用计算资源，并按照所选队列的计费规则收取费用。如果所选队列欠费、被删除，或表维护计算组不可用，索引相关任务将无法正常执行。

索引数据存储于 TOS，相关存储费用按 TOS 计费规则收取，详情请参见 TOS 计费说明。

创建索引

说明

单表最多创建 30 个索引，单字段最多创建 5 个索引。

在左侧导航栏选择湖管理 > 元数据，选择对应的数据库和数据表，进入表详情页面。

进入索引管理页面，单击创建索引。

在创建索引页面，设置索引名称、字段和类型，然后单击确认。

参数	说明
索引名称	同一张表内唯一。支持使用系统自动生成的名称（如 idx_{field}_{type}），也可以自定义，长度为 1-128 字符。
重建索引	默认开启，开启后，若该字段已存在同类型索引，将重建并替换原索引。
索引字段	每次选择一个字段，系统将根据字段类型展示可创建的索引类型。
索引类型	当前版本支持以下索引类型： BTree（标量索引）：适用于数值、时间、字符串等高选择性标量字段，常用于等值精确查询与范围扫描。 Zone Map（标量索引）：适用于数值、时间、字符串等标量字段，常用于按时间范围（dt）、数值区间进行范围过滤与数据跳过。 FTS（全文索引）：适用于文本字段，常用于长文本关键词检索、分词匹配与 BM25 排序。 IVF_PQ（向量索引）：适用于固定维度浮点向量，常用于高维 embedding 向量的近似最近邻（ANN）相似度检索。

返回索引列表查看构建进度，待状态更新为可用后即可生效。索引构建完成时间取决于数据量和可用计算资源。在构建过程中，系统会持续更新索引状态。

增量构建索引

当表持续写入新数据时，已有索引可能只覆盖部分数据。此时，您可以通过增量构建将索引补齐到未覆盖的数据范围。

在左侧导航栏选择湖管理 > 元数据，选择对应的数据库和数据表，进入表详情页面。

进入索引管理页面，在索引列表中找到覆盖率为部分覆盖的索引。

单击增量构建，提交补建任务。

等待任务完成后，查看覆盖率、未索引数据量和索引状态是否已更新。增量构建只会处理当前未被索引覆盖的数据。如果表在任务执行期间仍持续写入，任务完成后索引覆盖率可能仍为部分覆盖。

查看索引

在左侧导航栏选择湖管理 > 元数据，选择对应的数据库和数据表，进入表详情页面。

进入索引管理页面。

在列表中查看当前表已创建的索引信息，例如索引名称、分类、类型和字段。如果当前表还没有索引，页面会显示空状态，您可以直接发起创建操作。

字段	说明
索引名称	已创建的索引名称。
索引分类	当前索引的一级分类（标量/全文/向量）。
索引类型	索引的具体类型（如 BTree、Zone Map、FTS、IVF_PQ）。
索引字段	当前索引绑定的目标列。
状态	支持按状态筛选，各状态说明如下：构建中：创建、增量构建或重建任务正在后台执行中，支持查看详情、刷新，构建中的索引暂不支持删除操作。可用：索引构建完成且已覆盖当前表的全部数据，线上查询正常生效。支持查看详情、删除。优化中：表在持续追加新数据，增量 Fragment 尚未被索引覆盖；查询时已覆盖部分走索引，未覆盖部分自动回退为全表扫描。支持查看详情、增量构建、删除。优化失败：索引对象存在，但因索引文件缺失/损坏、索引元数据不一致、或后端引擎版本不兼容等原因无法被查询安全使用。支持查看详情、删除。创建失败：创建索引任务执行异常，索引未成功构建生效。支持查看详情、删除。
索引覆盖率	已覆盖 fragments / 当前表总 fragments 的比例；全量覆盖显示具体百分比，未覆盖/失败显示 -。
大小	索引文件在 TOS 中实际占用的物理存储大小（如 0 B 或实际字节数）。
更新时间	索引最近一次构建/变更的时间戳。
创建时间	索引创建时间。
操作	包含详情、增量构建（仅索引为部分覆盖时可用）和删除。

删除索引

在左侧导航栏选择湖管理 > 元数据，选择对应的数据库和数据表，进入表详情页面。

进入索引管理页面，在索引列表中找到目标索引。

单击删除，在二次确认弹窗中确认操作。

等待删除完成后，刷新索引列表确认结果。删除索引后，后续查询将不再使用该索引。若索引处于构建中，则暂不支持删除，待构建完成或失败后方可删除。

最近更新时间：2026.10.16 11:33:12

这个页面对您有帮助吗？

有用

无用