翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# クエリ結果の折りたたみ/展開
**注記**
機能のサポートは、使用されているインデックスタイプと検索 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_id`され`_document_title``_created_at`、これらの属性またはフィールドを使用してクエリ時に高度な検索機能が提供されます。
Amazon Kendraのクエリ結果の折りたたみと展開機能を使用すると、共通のドキュメント属性を使用して検索結果をグループ化して、指定したプライマリドキュメントの下に (折りたたみまたは部分的に展開) 表示できます。
**注記**
クエリ結果の折りたたみと展開機能は、現在 [Amazon Kendra API](https://docs.aws.amazon.com/kendra/latest/APIReference/welcome.html) 経由でのみ利用できます。
これは、次のような検索状況で役に立ちます。
+ インデックス内のドキュメントに複数のバージョンのコンテンツが存在する。エンドユーザーがインデックスをクエリする際に、重複を非表示または折りたたむことにより、最も関連性の高いバージョンのドキュメントを表示する場合。例えば、インデックスに「NYC leave policy」という名前のドキュメントの複数のバージョンが含まれている場合、「Type」属性/フィールドを使用して、特定のグループ「HR」と「Legal」のドキュメントを折りたたむことができます。
+ インデックスには、商品在庫など、1 種類の項目またはオブジェクトに関する固有の情報を含む複数のドキュメントが含まれています。アイテム情報の取得やソートしやすくするために、エンドユーザーがアイテムやオブジェクトにリンクされたすべてのドキュメントに 1 つの検索結果としてアクセス可能にする。以下の例では、「animal print shirts」を検索すると、名前でグループ化され、価格の昇順でソートされた結果が返されています。
## 結果の折りたたみ
類似または関連するドキュメントをグループ化するには、折りたたむ属性を指定する必要があります (例えば、`_category` でドキュメントを折りたたんだり、グループ化したりできます)。これを行うには、[クエリ 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` タイプはサポートされていません。
## ソート順を使用してプライマリドキュメントを選択する
折りたたまれたグループにプライマリドキュメントが表示されるように設定するには、[CollapseConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_CollapseConfiguration.html) の `SortingConfigurations` パラメータを使用します。例えば、ドキュメントの最新バージョンを取得するには、折りたたまれた各グループを `_version` でソートします。`SortingConfigurations` を使用して、ソートする属性/フィールドを 3 つまで指定し、各属性/フィールドのソート順を指定できます。ソート属性数のクォータの引き上げをリクエストできます。
デフォルトでは、 はクエリレスポンスを、レスポンスの結果ごとに決定した関連性スコアで Amazon Kendra ソートします。デフォルトのソート順序を変更するには、ドキュメント属性をソート可能にしてから、これらの属性を使用してレスポンスをソート Amazon Kendra するように を設定します。詳細については、「[Sorting responses](https://docs.aws.amazon.com/kendra/latest/dg/tuning-sorting-responses.html#sorting-responses)」を参照してください。
## ドキュメントのキーストラテジーの欠損
ドキュメントに折りたたみ属性値がない場合、 Amazon Kendra には次の 3 つのカスタマイズオプションがあります。
+ `COLLAPSE` を選択して、null 値または欠損値を含むすべてのドキュメントを 1 つのグループに折りたたみます。これはデフォルトの設定です。
+ `IGNORE` を選択して、null 値または欠損値を含むドキュメントを無視します。無視したドキュメントは、クエリ結果に表示されません。
+ `EXPAND` を選択して、null または欠落しているドキュメントをそれぞれ独自のグループに展開します。
## 結果の拡張
[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 機能とのやり取り
+ 結果を折りたたんだり展開したりしても、ファセットの数は変化せず、表示される結果の総数にも影響しません。
+ Amazon Kendra [注目の検索結果](https://docs.aws.amazon.com/kendra/latest/dg/featured-results.html)は、設定した折りたたみフィールドと同じフィールド値であっても折りたたまれません。
+ 結果の折りたたみと展開は、`DOCUMENT` タイプの結果にのみ適用されます。