全文搜索指南

在应用内使用全文搜索是一个很常见的需求。例如一个阅读类的应用，里面有很多有价值的文章，开发者会提供一个搜索框，让用户键入关键字后就能查找到应用内相关的文章，并按照相关度排序，就好像我们打开浏览器用 Google 搜索关键字一样。 虽然使用正则查询也可以实现全文搜索功能，但数据量较大的时候正则查询会有性能问题，因此我们提供了专门的全文搜索功能。

为 Class 启用搜索

你需要选择至少一个 Class 为它开启全文搜索。开启后，该 Class 的数据会自动建立索引，并且可以调用我们的搜索组件或者 API 搜索到内容。

请注意，启用了搜索的 Class 数据，其搜索结果仍然遵循 ACL。如果你为 Class 里的 Object 设定了合理的 ACL，那么搜索结果也将遵循这些 ACL 值，保护你的数据安全。

你可以在 开发者中心 > 你的游戏 > 游戏服务 > 云服务 > 数据存储 > 全文搜索 为 Class 启用搜索，点击「添加搜索 Class」：

• Class：选择需要启用搜索的 Class。最多允许 10 个 Class 启用全文搜索。
• 开放的列：你可以选择将哪些字段加入搜索索引。默认情况下，objectId、createdAt、updatedAt 三个字段将无条件加入开放字段列表。除了这三个字段外，每个 Class 最多允许索引 10 个字段。请仔细挑选要索引的字段。

如果一个 Class 启用了全文搜索，但是超过两周没有任何搜索调用，我们将自动禁用该 Class 的搜索功能。

搜索 API

我们提供了 全文搜索的 REST API 接口。 SDK 封装了这一接口。

假设你对 GameScore 类 启用了全文搜索，你就可以尝试传入关键字来搜索：

Unity

LCSearchQuery<GameScore> query = new LCSearchQuery<GameScore>("GameScore");
query.QueryString("dennis")
    .OrderByDescending("score")
    .Limit(10);
LCSearchResponse<GameScore> response = await query.Find();
// 符合查询条件的文档总数
Debug.Log(response.Hits);
// 符合查询条件的结果文档
foreach (GameScore score in response.Results) {

}
// 标记本次查询结果，下次查询继续传入这个 sid 用于查找后续的数据，用来支持翻页查询
Debug.Log(response.Sid);

Android

LCSearchQuery searchQuery = new LCSearchQuery("dennis");
searchQuery.setClassName("GameScore");
searchQuery.setLimit(10);
searchQuery.orderByAscending("score"); // 根据 score 字段升序排序。
searchQuery.findInBackground().subscribe(new Observer<List<LCObject>>() {
  @Override
  public void onSubscribe(Disposable disposable) {}

  @Override
  public void onNext(List<LCObject> results) {
    for (LCObject o:results) {
      System.out.println(o);
    }
    testSucceed = true;
    latch.countDown();
  }

  @Override
  public void onError(Throwable throwable) {
    throwable.printStackTrace();
    testSucceed = true;
    latch.countDown();
  }

  @Override
  public void onComplete() {}
});

iOS

LCSearchQuery *searchQuery = [LCSearchQuery searchWithQueryString:@"test-query"];
searchQuery.className = @"GameScore";
searchQuery.highlights = @"field1,field2";
searchQuery.limit = 10;
searchQuery.cachePolicy = kLCCachePolicyCacheElseNetwork;
searchQuery.maxCacheAge = 60;
searchQuery.fields = @[@"field1", @"field2"];
[searchQuery findInBackground:^(NSArray *objects, NSError *error) {
  for (LCObject *object in objects) {
        NSString *appUrl = [object objectForKey:@"_app_url"];
        NSString *deeplink = [object objectForKey:@"_deeplink"];
        NSString *highlight = [object objectForKey:@"_highlight"];
        // other fields
        // code is here
    }
}];

有关查询语法，可以参考 q 查询语法。

因为每次请求都有 limit 限制，所以一次请求可能并不能获取到所有满足条件的记录。 SearchQuery 的 hits() 标示所有满足查询条件的记录数。 你可以多次调用同一个 SearchQuery 的 find() 获取余下的记录。

如果在不同请求之间无法保存查询的 query 对象，可以利用 sid 做到翻页，一次查询是通过 SearchQuery 的 _sid 属性来标示的。 你可以通过 SearchQuery 的 sid() 来重建查询 query 对象，继续翻页查询。 sid 在 5 分钟内有效。

复杂排序可以使用 SearchSortBuilder，例如，假设 scores 是由分数组成的数组，现在需要根据分数的平均分倒序排序，并且没有分数的排在最后：

Unity

LCSearchSortBuilder sortBuilder = new LCSearchSortBuilder();
sortBuilder.OrderByAscending("balance", "avg", "last");
searchQuery.SortBy(sortBuilder);

Android

LCSearchSortBuilder builder = LCSearchSortBuilder.newBuilder();
builder.orderByDescending("scores","avg","last");
searchQuery.setSortBuilder(builder);

iOS

LCSearchSortBuilder *builder = [LCSearchSortBuilder newBuilder];
[builder orderByDescending:@"scores" withMode:@"max" andMissing:@"last"];
searchQuery.sortBuilder = builder;

更多 API 请参考 SDK API 文档：

Unity

• LCSearchQuery
• LCSearchSortBuilder
• LCSearchResponse

Android

• LCSearchQuery
• LCSearchSortBuilder

iOS

• LCSearchQuery
• LCSearchSortBuilder

自定义分词

默认情况下， String 类型的字段都将被自动执行分词处理，我们使用的分词组件是 mmseg，词库来自搜狗。但是很多用户由于行业或者专业的特殊性，一般都有自定义词库的需求，因此我们提供了自定义词库的功能。应用创建者可以通过 开发者中心 > 你的游戏 > 游戏服务 > 云服务 > 数据存储 > 全文搜索 > 自定义词库 上传词库文件。

词库文件要求为 UTF-8 编码，每个词单独一行，文件大小不能超过 512 K，例如：

面向对象编程
函数式编程
高阶函数
响应式设计

将其保存为文本文件，如 words.txt，上传即可。上传后，分词将于 3 分钟后生效。开发者可以通过 analyze API（要求使用 master key）来测试。

自定义词库生效后，仅对新添加或者更新的文档／记录才有效，如果需要对原有的文档也生效的话，需要在 数据存储 > 全文搜索 点击「重建索引」按钮，重建原有索引。 同样，如果更新了自定义词库（包括删除自定义词库），也需要重建索引。