java - Google 搜索 API 查询选项和排序选项限制

Question

我无法理解 Google 搜索 API 中的“限制”。

docs显示此示例:

  // Build the SortOptions with 2 sort keys
  SortOptions sortOptions =
      SortOptions.newBuilder()
          .addSortExpression(
              SortExpression.newBuilder()
                  .setExpression("price")
                  .setDirection(SortExpression.SortDirection.DESCENDING)
                  .setDefaultValueNumeric(0))
          .addSortExpression(
              SortExpression.newBuilder()
                  .setExpression("brand")
                  .setDirection(SortExpression.SortDirection.DESCENDING)
                  .setDefaultValue(""))
          .setLimit(1000)
          .build();

  // Build the QueryOptions
  QueryOptions options =
      QueryOptions.newBuilder()
          .setLimit(25)
          .setFieldsToReturn("model", "price", "description")
          .setSortOptions(sortOptions)
          .build();

SortOptions 的限制描述为:

Maximum number of objects to score and/or sort. Cannot be more than 10,000. Default: 1,000

QueryOptions 的限制描述为:

The documentation explains limit as: The maximum number of documents to return in the results. Default: 20 Max :1000

我个人希望通过分页返回尽可能多的结果。注意:我使用的是光标。

这是否意味着，如果我想使用 QueryOptions，即使 SortOptions 可以返回 10000 个结果，我也只能返回 1000 个结果？

或者是否会返回所有文档，仅对前 1000 个文档进行排序？

我担心一旦我的光标到达1000个文档的末尾，即使超过1000个文档也不会返回更多内容。

Answer 1

您始终只能从排序集中获得前 1000 个文档，因为QueryOptions 和 SortOptions(及其限制)控制提取结果流的不同阶段。

SortOptions.limit 通知索引引擎在准备结果集时使用有限的文档集。但是当您从索引接收文档时使用 QueryOptions.limit。

例如，想象一下与 RDBMS 类似的下一种情况:您需要创建复杂的请求，并使用 top/limit 创建排序 View 。在这种情况下:

• SortOptions.limit - 创建 View 时使用；
• QueryOptions.limit - 当您从 View 中选择数据时。