• 平滑重建索引

    平滑重建索引

    前一章讲到有些情况不得不需要重建索引,可以用 XSIndex::clean 立即全部清空所有数据,然后再把现有数据全部添加到索引数据库中。

    但这种方式的缺点对于线上项目是难以容忍的,因此可以选择使用平滑重建方式。它的内部实现相当于在一个临时区域开辟新库,把所有的添加操作全部更新到新库,直到您完成重建,完成后再用新库替代旧库用于搜索。1. 使用重建在编代码时,把所有的 XSIndex:add 操作都放进 XSIndex::beginRebuild 和 XSIndex::endRebuild 之间即可。写法参考如下:

    1. // 宣布开始重建索引
    2. $index->beginRebuild();
    3.  
    4. // 然后在此开始添加数据
    5. ...
    6. $index->add($doc);
    7. ...
    8.  
    9. // 告诉服务器重建完比
    10. $index->endRebuild();

    Note: 为确保重建的顺利完成,请在重建时不要对同一个项目开启多个进程、 连接同时交替重建以免发生错乱。

    2. 中止重建虽然我们一再强调,但仍然会在某些意外情况下,导致重建工作意外终止。这时索引库进入一个崩溃状态,出现 DB has been rebuilding 的错误。

    这时您可以再次调用 XSIndex::beginRebuild 开始重建索引,但这会丢失之前的所有重建成果。您还可以在重建前先调用 XSIndex::stopRebuild 直接清除这个错误状态。

    Note: 中止重建以及重复开启重建的功能自 1.3.4 版起可用。