接口定义
rebuild_index() 接口用于重建 Base 类 Collection 的所有索引。
def rebuild_index(self,drop_before_rebuild: bool = False,throttle: int = 0,timeout: Optional[float] = None)
使用实例
注意：
索引重建过程中 Collection 禁止写入、读取。
重建索引需要新的内存来构建索引。
db = client.database('db-test')coll = db.collection('book-vector')# rebuildcoll.rebuild_index(drop_before_rebuild=False,throttle=1,timeout=30)
入参描述
参数名 | 是否必选 | 参数含义 | 配置方法及要求 |
drop_before_rebuild | 否 | 标识在重建索引时，是否需先删除旧索引再重建新索引。 说明： 重建索引需要占用额外的内存空间，数据量越大，消耗的内存空间越大。在重建索引之前，您需根据实际资源情况选择是否需先删除旧索引再重建，避免引起内存占满而阻塞业务正常运行。 | 取值如下所示： True：重建之前，先删除旧索引在重建索引。 说明： 内存资源不足时，可先删除旧索引，在新索引还没有创建完成之前，该表无法正常读写。 False：重建之前，不删除旧索引，创建新索引完成之后再删除旧索引。默认为 False。 说明： 内存资源足够的情况下，可不删除旧索引。在新索引还没有创建完成之前，该表可读，禁止写入数据。 |
throttle | 否 | 标识是否限制构建索引的单节点 CPU 核数。 说明： 重建索引会消耗 CPU 资源，为防止资源打满影响写入或者检索等操作，请根据业务实际配置重建索引的 CPU 核数。默认为限制 CPU 核数为 1。 | 取值如下所示： 0：不限制 CPU 核数。 1：CPU 核数为 1。 |
出参描述
输出信息，如下所示。
{'affectedCount': 1}
参数名 | 参数含义 |
affectedCount | 影响行数，即为重建索引的集合数量。 |
相关说明
使用 describe_collection() 可查看指定集合的索引状态。返回参数 indexStatus 中的 status 标识当前 Collection 重建索引的状态，startTime 显示重建索引开始的时间。
ready：表示当前 Collection 准备就绪，可正常使用。
training：表示当前 Collection 正在进行数据训练，即训练模型已生成向量数据。
building：表示当前 Collection 正在重建索引，即将生成的向量数据存储到新的索引中。
failed: 重建索引失败，可能会影响集合读写操作。
注意：
training data 与 building index 状态期间不可写入数据。若重建索引之前先删除旧索引，则集合不可进行相似性查询，只能进行精确查询。
