

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# ステップ 5: Amazon Kendra インデックスをクエリする
<a name="tutorial-search-metadata-query-kendra"></a>

Amazon Kendra インデックスは自然言語クエリの準備が整いました。インデックスを検索すると、Amazon Kendra は指定したすべてのデータとメタデータを使用して、検索クエリに対する最も正確な回答を返します。

Amazon Kendra が回答できるクエリには、次の 3 種類があります。
+ Factoid 型クエリ (「誰が」、「何を」、「いつ」、または「どこで」の質問)
+ 説明的なクエリ (「どのように」の質問)
+ キーワード検索 (意図と対象範囲が明確でない質問)

**Topics**
+ [Amazon Kendra インデックスをクエリする](#tutorial-search-metadata-query-kendra-basic)
+ [検索結果のフィルタリング](#tutorial-search-metadata-query-kendra-filters)

## Amazon Kendra インデックスをクエリする
<a name="tutorial-search-metadata-query-kendra-basic"></a>

Amazon Kendra がサポートする 3 種類のクエリに対応する質問を使用して、Amazon Kendra インデックスをクエリできます。詳細については、[クエリ](https://docs.aws.amazon.com/kendra/latest/dg/searching-example.html)を参照してください。

このセクションの質問例は、サンプルデータセットに基づいて選択されています。

### Amazon Kendra インデックスをクエリするには (コンソール)
<a name="tutorial-search-metadata-query-index-console"></a>

1. Amazon Kendra コンソール ([https://console.aws.amazon.com/kendra/](https://console.aws.amazon.com/kendra/)) を開きます。

1. **[Indexes]** (インデックス) リストから、`kendra-index` をクリックします。

1. 左側のナビゲーションメニューから、インデックスを検索するオプションを選択します。

1. Factoid 型クエリを実行するには、検索ボックスに **Who is Lewis Hamilton?** と入力し、[Enter] キーを押します。

   最初に返された結果は、Amazon Kendra が提案した回答と、その回答を含むデータファイルです。残りの結果は、一連の推奨ドキュメントを形成します。

   

     
![\[Search interface showing query "Who is Lewis Hamilton?" with Formula One driver information results.\]](http://docs.aws.amazon.com/ja_jp/kendra/latest/dg/images/tutorial-query1.png)

1. 説明的なクエリを実行するには、検索ボックスに **How does Formula One work?** と入力し、[Enter] キーを押します。

   Amazon Kendra コンソールから返された別の結果が表示されます。今回は、関連する語句が強調表示されます。

   

     
![\[Search results for "How does Formula One work?" showing snippets about the racing series.\]](http://docs.aws.amazon.com/ja_jp/kendra/latest/dg/images/tutorial-query2.png)

1. キーワード検索を実行するには、検索ボックスに **Formula One** と入力し、[Enter] キーを押します。

   Amazon Kendra コンソールから返される別の結果と、データセット内の語句に関する他のすべてのメンションの結果が表示されます。

   

     
![\[Search results for "Formula One" showing Amazon Kendra suggested answers with article snippets.\]](http://docs.aws.amazon.com/ja_jp/kendra/latest/dg/images/tutorial-query3.png)

### Amazon Kendra インデックスをクエリするには (AWS CLI)
<a name="tutorial-search-metadata-query-index-cli"></a>

1. サンプルの Factoid 型クエリを実行するには、[[query]](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kendra/query.html) コマンドを使用します。

------
#### [ Linux ]

   ```
   aws kendra query \
           --index-id kendra-index-id \
           --query-text "Who is Lewis Hamilton?" \
           --region aws-region
   ```

   コードの説明は以下のとおりです。
   + *kendra-index-id* は、保存した `kendra-index-id`、
   + *aws-region* はお客様の AWS リージョンです。

------
#### [ macOS ]

   ```
   aws kendra query \
           --index-id kendra-index-id \
           --query-text "Who is Lewis Hamilton?" \
           --region aws-region
   ```

   コードの説明は以下のとおりです。
   + *kendra-index-id* は、保存した `kendra-index-id`、
   + *aws-region* はお客様の AWS リージョンです。

------
#### [ Windows ]

   ```
   aws kendra query ^
           --index-id kendra-index-id ^
           --query-text "Who is Lewis Hamilton?" ^
           --region aws-region
   ```

   コードの説明は以下のとおりです。
   + *kendra-index-id* は、保存した `kendra-index-id`、
   + *aws-region* はお客様の AWS リージョンです。

------

   はクエリの結果 AWS CLI を表示します。

1. サンプルの説明的なクエリを実行するには、[[query]](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kendra/query.html) コマンドを使用します。

------
#### [ Linux ]

   ```
   aws kendra query \
           --index-id kendra-index-id \
           --query-text "How does Formula One work?" \
           --region aws-region
   ```

   コードの説明は以下のとおりです。
   + *kendra-index-id* は、保存した `kendra-index-id`、
   + *aws-region* はお客様の AWS リージョンです。

------
#### [ macOS ]

   ```
   aws kendra query \
           --index-id kendra-index-id \
           --query-text "How does Formula One work?" \
           --region aws-region
   ```

   コードの説明は以下のとおりです。
   + *kendra-index-id* は、保存した `kendra-index-id`、
   + *aws-region* はお客様の AWS リージョンです。

------
#### [ Windows ]

   ```
   aws kendra query ^
           --index-id kendra-index-id ^
           --query-text "How does Formula One work?" ^
           --region aws-region
   ```

   コードの説明は以下のとおりです。
   + *kendra-index-id* は、保存した `kendra-index-id`、
   + *aws-region* はお客様の AWS リージョンです。

------

   はクエリに結果 AWS CLI を表示します。

1. サンプルキーワード検索を実行するには、[[query]](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kendra/query.html) コマンドを使用します。

------
#### [ Linux ]

   ```
   aws kendra query \
           --index-id kendra-index-id \
           --query-text "Formula One" \
           --region aws-region
   ```

   コードの説明は以下のとおりです。
   + *kendra-index-id* は、保存した `kendra-index-id`、
   + *aws-region* はお客様の AWS リージョンです。

------
#### [ macOS ]

   ```
   aws kendra query \
           --index-id kendra-index-id \
           --query-text "Formula One" \
           --region aws-region
   ```

   コードの説明は以下のとおりです。
   + *kendra-index-id* は、保存した `kendra-index-id`、
   + *aws-region* はお客様の AWS リージョンです。

------
#### [ Windows ]

   ```
   aws kendra query ^
           --index-id kendra-index-id ^
           --query-text "Formula One" ^
           --region aws-region
   ```

   コードの説明は以下のとおりです。
   + *kendra-index-id* は、保存した `kendra-index-id`、
   + *aws-region* はお客様の AWS リージョンです。

------

   は、クエリに対して返された回答 AWS CLI を表示します。

## 検索結果のフィルタリング
<a name="tutorial-search-metadata-query-kendra-filters"></a>

Amazon Kendra コンソールのカスタムドキュメント属性を使用して、検索結果をフィルタリングしてソートすることができます。Amazon Kendra がクエリを処理する方法の詳細については、[クエリのフィルタリング](https://docs.aws.amazon.com/kendra/latest/dg/filtering.html)を参照してください。

### 検索結果をフィルタリングするには (コンソール)
<a name="tutorial-search-metadata-filter-index-console"></a>

1. Amazon Kendra コンソール ([https://console.aws.amazon.com/kendra/](https://console.aws.amazon.com/kendra/)) を開きます。

1. **[Indexes]** (インデックス) リストから、`kendra-index` をクリックします。

1. 左側のナビゲーションメニューから、インデックスを検索するオプションを選択します。

1. 検索ボックスに、クエリとして **Soccer matches** と入力し、[Enter] キーを押します。

1. 左側のナビゲーションメニューから、**[Filter search results]** (検索結果をフィルタリング) を選択し、検索結果をフィルタリングするために使用できるファセットのリストを表示します。

1. **[EVENT]** の小見出しの「Champions League」のチェックボックスをオンにし、「Champions League」を含む結果のみにフィルタリングされた検索結果を表示します。

   

     
![\[Search interface for soccer matches with filters and Amazon Kendra suggested answers.\]](http://docs.aws.amazon.com/ja_jp/kendra/latest/dg/images/tutorial-filter.png)

### 検索結果をフィルタリングするには (AWS CLI)
<a name="tutorial-search-metadata-filter-index-cli"></a>

1. 検索可能な特定のタイプのエンティティ (`EVENT` など) を表示するには、[[query]](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kendra/query.html) コマンドを使用します。

------
#### [ Linux ]

   ```
   aws kendra query \
           --index-id kendra-index-id \
           --query-text "Soccer matches" \
           --facets '[{"DocumentAttributeKey":"EVENT"}]' \
           --region aws-region
   ```

   コードの説明は以下のとおりです。
   + *kendra-index-id* は、保存した `kendra-index-id`、
   + *aws-region* はお客様の AWS リージョンです。

------
#### [ macOS ]

   ```
   aws kendra query \
           --index-id kendra-index-id \
           --query-text "Soccer matches" \
           --facets '[{"DocumentAttributeKey":"EVENT"}]' \
           --region aws-region
   ```

   コードの説明は以下のとおりです。
   + *kendra-index-id* は、保存した `kendra-index-id`、
   + *aws-region* はお客様の AWS リージョンです。

------
#### [ Windows ]

   ```
   aws kendra query ^
           --index-id kendra-index-id ^
           --query-text "Soccer matches" ^
           --facets '[{"DocumentAttributeKey":"EVENT"}]' ^
           --region aws-region
   ```

   コードの説明は以下のとおりです。
   + *kendra-index-id* は、保存した `kendra-index-id`、
   + *aws-region* はお客様の AWS リージョンです。

------

   に検索結果 AWS CLI が表示されます。タイプのファセットのリストを取得するには`EVENT`、 AWS CLI 出力の「FacetResults」セクションに移動して、フィルタリング可能なファセットのリストとその数を確認します。例えば、ファセットの 1 つは「Champions League」です。
**注記**  
`EVENT` の代わりに、`DocumentAttributeKey` 値に対して [Amazon Kendra インデックスの作成](tutorial-search-metadata-create-index-ingest.md#tutorial-search-metadata-create-index) で作成したインデックスフィールドを選択できます。

1. 同じ検索を実行し、「Champions League」を含む結果のみでフィルタリングするには、[[query]](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/kendra/query.html) コマンドを使用します。

------
#### [ Linux ]

   ```
   aws kendra query \
           --index-id kendra-index-id \
           --query-text "Soccer matches" \
           --attribute-filter '{"ContainsAny":{"Key":"EVENT","Value":{"StringListValue":["Champions League"]}}}' \
           --region aws-region
   ```

   コードの説明は以下のとおりです。
   + *kendra-index-id* は、保存した `kendra-index-id`、
   + *aws-region* はお客様の AWS リージョンです。

------
#### [ macOS ]

   ```
   aws kendra query \
           --index-id kendra-index-id \
           --query-text "Soccer matches" \
           --attribute-filter '{"ContainsAny":{"Key":"EVENT","Value":{"StringListValue":["Champions League"]}}}' \
           --region aws-region
   ```

   コードの説明は以下のとおりです。
   + *kendra-index-id* は、保存した `kendra-index-id`、
   + *aws-region* はお客様の AWS リージョンです。

------
#### [ Windows ]

   ```
   aws kendra query ^
           --index-id kendra-index-id ^
           --query-text "Soccer matches" ^
           --attribute-filter '{"ContainsAny":{"Key":"EVENT","Value":{"StringListValue":["Champions League"]}}}' ^
           --region aws-region
   ```

   コードの説明は以下のとおりです。
   + *kendra-index-id* は、保存した `kendra-index-id`、
   + *aws-region* はお客様の AWS リージョンです。

------

   はフィルタリングされた検索結果 AWS CLI を表示します。