기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 5단계: Amazon Kendra 인덱스 쿼리
이제 Amazon Kendra 인덱스를 자연어 쿼리에 사용할 준비가 되었습니다. 인덱스를 검색할 때 Amazon Kendra는 사용자가 제공한 모든 데이터와 메타데이터를 사용하여 검색 쿼리에 가장 정확한 답변을 제공합니다.
Amazon Kendra가 응답할 수 있는 쿼리에는 세 가지 종류가 있습니다.
+ 팩토이드 쿼리(“누가”, “무엇을”, “언제”, “어디에서” 질문)
+ 서술형 쿼리(“어떻게” 질문)
+ 키워드 검색(의도와 범위가 명확하지 않은 질문)
**Topics**
+ [Amazon Kendra 인덱스 쿼리](#tutorial-search-metadata-query-kendra-basic)
+ [검색 결과 필터링](#tutorial-search-metadata-query-kendra-filters)
## Amazon Kendra 인덱스 쿼리
Amazon Kendra가 지원하는 세 가지 쿼리 유형에 해당하는 질문을 사용하여 Amazon Kendra 인덱스를 쿼리할 수 있습니다. 자세한 내용은 [쿼리](https://docs.aws.amazon.com/kendra/latest/dg/searching-example.html)를 참조하세요.
이 섹션의 예제 질문은 샘플 데이터 세트를 기반으로 선택되었습니다.
### Amazon Kendra 인덱스를 쿼리하려면 (콘솔)
1. [https://console.aws.amazon.com/kendra/](https://console.aws.amazon.com/kendra/)에서 Amazon Kendra 콘솔을 엽니다.
1. **인덱스** 목록에서 `kendra-index`를 클릭합니다.
1. 왼쪽 탐색 메뉴에서 인덱스 검색 옵션을 선택합니다.
1. 샘플 팩토이드 쿼리를 실행하려면 검색 상자에 **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/ko_kr/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/ko_kr/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/ko_kr/kendra/latest/dg/images/tutorial-query3.png)
### Amazon Kendra 인덱스를 쿼리하려면 (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 "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 표시됩니다.
## 검색 결과 필터링
Amazon Kendra 콘솔에서 사용자 지정 문서 속성을 사용하여 검색 결과를 필터링하고 정렬할 수 있습니다. Amazon Kendra가 쿼리를 처리하는 방법에 대한 자세한 내용은 [쿼리 필터링](https://docs.aws.amazon.com/kendra/latest/dg/filtering.html)을 참조하세요.
### 검색 결과를 필터링하려면 (콘솔)
1. [https://console.aws.amazon.com/kendra/](https://console.aws.amazon.com/kendra/)에서 Amazon Kendra 콘솔을 엽니다.
1. **인덱스** 목록에서 `kendra-index`를 클릭합니다.
1. 왼쪽 탐색 메뉴에서 인덱스 검색 옵션을 선택합니다.
1. 검색 상자에 **Soccer matches**를 쿼리로 입력하고 Enter 키를 누릅니다.
1. 왼쪽 탐색 메뉴에서 **검색 결과 필터링**을 선택하면 검색을 필터링하는 데 사용할 수 있는 패싯 목록이 표시됩니다.
1. **이벤트** 부제목 아래의 “Champions League” 확인란을 선택하면 “Champions League”가 포함된 결과로만 필터링된 검색 결과를 볼 수 있습니다.
![\[Search interface for soccer matches with filters and Amazon Kendra suggested answers.\]](http://docs.aws.amazon.com/ko_kr/kendra/latest/dg/images/tutorial-filter.png)
### 검색 결과를 필터링하려면 (AWS CLI)
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 표시됩니다. 유형의 패싯 목록을 가져오려면 AWS CLI 출력의 "FacetResults" 섹션으로 `EVENT`이동하여 필터링 가능한 패싯 목록과 해당 개수를 확인합니다. 예를 들어, 패싯 중 하나는 “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 표시됩니다.