SearchParamsBuilder有什么功能？（2）

在使用阿里云的OpenSearch服务时，您可以通过调整查询参数来定制返回结果的格式以及搜索的具体行为。根据您的描述，这里有几个关键的设置方法，我将为您逐一解释：

1. 设置返回结果的格式

如果您希望自定义查询结果的输出格式，可以使用 OpenSearch\Util\SearchParamsBuilder::setFormat 方法。这个方法允许您从几种预设的格式中选择，以适应不同的数据处理需求。

• 使用方法:

  $paramsBuilder = new OpenSearch\Util\SearchParamsBuilder();
  $paramsBuilder->setFormat('fulljson'); // 设置返回格式为 fulljson，包含更多节点信息如 variableValue 等
  

  其中，$format 参数可选值有 'xml', 'json', 和 'fulljson'。默认情况下，可能返回的是较为简洁的 JSON 格式，而 'fulljson' 则提供了更详细的响应内容，适合需要更多元数据或详细信息的场景。

2. 设置要搜索的应用名称或ID

为了指定搜索操作针对哪个应用（在OpenSearch中创建的索引应用），您可以使用 OpenSearch\Util\SearchParamsBuilder::setAppName 方法。

• 使用方法:

  $paramsBuilder->setAppName('YourAppNameOrID');
  

  这里的 $appNames 参数应替换为您的实际应用名称或ID，确保该应用已存在于您的OpenSearch服务中。

3. 设置搜索关键词

为了执行一个具体的搜索请求，您需要通过 OpenSearch\Util\SearchParamsBuilder::setQuery 方法来设定搜索关键词。

• 使用方法:

  $paramsBuilder->setQuery('index_name:your_keyword');
  

  在这里，$query 参数遵循特定的格式，即 索引名:'关键词'，并且支持逻辑运算符（AND, OR）来组合多个条件。请确保索引名正确，并用英文冒号分隔索引名和关键词。

4. 设置KV pairs

如果您的搜索请求需要额外的键值对参数（例如用于过滤、排序等），可以利用 OpenSearch\Util\SearchParamsBuilder::setKvPairs 方法。

• 使用方法:

  $paramsBuilder->setKvPairs('key1:value1,key2:value2');
  

  $kvPairs 参数是一个字符串，其中包含一系列用逗号分隔的键值对，每个键值对之间用冒号分隔。这些键值对能够帮助进一步细化搜索条件或配置搜索行为。

综上所述，通过这些方法，您可以灵活地构建和定制OpenSearch的查询请求，以满足不同场景下的搜索需求。