本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 折叠/展开查询结果
<a name="expand-collapse-query-results"></a>

**注意**  
功能支持因所用索引类型和搜索 API 而异。要查看您使用的索引类型和搜索 API 是否支持此功能，请参阅[索引类型](https://docs.aws.amazon.com/kendra/latest/dg/hiw-index-types.html)。

当您 Amazon Kendra 连接到数据时，它会抓取[文档元数据属性](https://docs.aws.amazon.com/kendra/latest/dg/hiw-document-attributes.html)（例如`_document_title``_created_at`、和`_document_id`），并在查询期间使用这些属性或字段提供高级搜索功能。

Amazon Kendra的“折叠和展开查询结果”功能允许您使用常用文档属性对搜索结果进行分组，并在指定的主文档下显示搜索结果（折叠或部分展开）。

**注意**  
折叠和展开查询结果功能目前只能通过 [Amazon Kendra API](https://docs.aws.amazon.com/kendra/latest/APIReference/welcome.html) 使用。

这在以下几种搜索情况下很有用：
+ 索引中的文档中存在多个版本的内容。当您的最终用户查询索引时，您希望他们看到包含重复项hidden/collapsed. For example, if your index contains multiple versions of a document named "NYC leave policy" you can choose to collapse the documents for the specific groups "HR" and "Legal" using the "Type" attribute/field的最相关的文档版本。  
![示例 1](http://docs.aws.amazon.com/zh_cn/kendra/latest/dg/images/expand-collapse-1.png)
+ 您的索引包含多个文档，其中包含有关一种商品或对象（例如产品库存）的唯一信息。为了方便地捕获项目信息以及对其排序，您希望最终用户能够将项目或对象链接的所有文档作为一个搜索结果进行访问。在以下示例中，客户搜索“animal print shirts”会返回按名称分组并按价格升序排序的结果。  
![示例 2](http://docs.aws.amazon.com/zh_cn/kendra/latest/dg/images/expand-collapse-2.png)

## 折叠结果
<a name="expand-results"></a>

要将相似或相关的文档组合在一起，必须指定要折叠的属性（例如，您可以按其折叠 collapse/group 文档`_category`）。为此，请调用 [Query API](https://docs.aws.amazon.com/kendra/latest/APIReference/API_Query.html) 并使用[CollapseConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CollapseConfiguration.html)对象指定`DocumentAttributeKey`要折叠的。`DocumentAttributeKey`控制哪些字段的搜索结果将处于折叠状态。支持的属性键字段包括`String`和`Number`。 `String list`不支持和`Date`类型。

## 使用排序顺序选择主文档
<a name="primary-document"></a>

要将主文档配置为在折叠的组中显示，请使用下面的`SortingConfigurations`参数[CollapseConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CollapseConfiguration.html)。例如，要获取文档的最新版本，可以按 `_version` 对每个折叠的组进行排序。您最多可以指定 3 attributes/fields 个作为排序依据，并 attribute/field 使用指定每个排序顺序`SortingConfigurations`。您可以请求增加排序属性的数量的限额。

默认情况下， Amazon Kendra 按其为响应中的每个结果确定的相关性分数对查询响应进行排序。要更改默认排序顺序，请将文档属性设置为可排序，然后配置 Amazon Kendra 为使用这些属性对响应进行排序。有关更多信息，请参阅 [ 响应](https://docs.aws.amazon.com/kendra/latest/dg/tuning-sorting-responses.html#sorting-responses)。

## 缺少文档密钥策略
<a name="missing-doc-key"></a>

如果您的文档没有折叠属性值，则会 Amazon Kendra 提供三个自定义选项：
+ 选择一个组中包含空值或缺失值`COLLAPSE`的所有文档。这是默认配置。
+ 选择值为空或缺失值的`IGNORE`文档。被忽略的文档不会出现在查询结果中。
+ 将`EXPAND`每个具有空值或缺失值的文档选择为一组。

## 扩大结果
<a name="expanding-results"></a>

您可以使用[CollapseConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CollapseConfiguration.html)对象中的`Expand`参数选择是否展开折叠的搜索结果组。展开的结果与为该组选择主文档时使用的排序顺序相同。

要配置要展开的折叠搜索结果组的数量，请使用[ExpandConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_ExpandConfiguration.html)对象中的`MaxResultItemstoExpand`参数。例如，如果将此值设置为 10，则只有 100 个结果组中的前 10 个具有扩展功能。

要配置每个折叠的主文档显示的展开结果数，请使用`MaxExpandResultsPerItem`参数。例如，如果您将此值设置为 3，则每个折叠的组最多会显示 3 个结果。

## 与其他 Amazon Kendra 功能的互动
<a name="cross-feature-interactions"></a>
+ 折叠和展开结果不会改变分面的数量，也不会影响显示的结果总数。
+ 即使Amazon Kendra [精选搜索结果](https://docs.aws.amazon.com/kendra/latest/dg/featured-results.html)的字段值与您配置的折叠字段相同，也不会折叠。
+ 折叠和展开结果仅适用于 `DOCUMENT` 类型的结果。