기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 시작하기(AWS CLI)
<a name="gs-cli"></a>

다음 절차에서는를 사용하여 Amazon Kendra 인덱스를 생성하는 방법을 보여줍니다 AWS CLI. 이 절차는 데이터 소스, 인덱스를 만들고 인덱스에서 쿼리를 실행합니다.

**Amazon Kendra 인덱스를 생성하려면(CLI)**

1. [사전 조건](gs-prerequisites.md)을 수행합니다.

1. 다음 명령을 입력하여 인덱스를 생성합니다.

   ```
   aws kendra create-index \
    --name cli-getting-started-index \
    --description "Index for CLI getting started guide." \
    --role-arn arn:aws:iam::{{account id}}:role/KendraRoleForGettingStartedIndex
   ```

1.  Amazon Kendra 가 인덱스를 생성할 때까지 기다립니다. 다음 명령을 사용하여 진행률을 확인합니다. 상태 필드가 `ACTIVE`이면 다음 단계로 계속 진행합니다.

   ```
   aws kendra describe-index \
    --id {{index id}}
   ```

1. 명령 프롬프트에 다음 명령을 입력하여 데이터 소스를 생성합니다.

   ```
   aws kendra create-data-source \
    --index-id {{index id}} \
    --name {{data source name}} \
    --role-arn arn:aws:iam::{{account id}}:role/KendraRoleForGettingStartedDataSource \
    --type S3 \
    --configuration '{"S3Configuration":{"BucketName":"{{S3 bucket name}}"}}'
   ```

   템플릿 스키마를 사용하여 데이터 소스에 연결하는 경우 템플릿 스키마를 구성합니다.

   ```
   aws kendra create-data-source \
    --index-id {{index id}} \
    --name {{data source name}} \
    --role-arn arn:aws:iam::{{account id}}:role/KendraRoleForGettingStartedDataSource \
    --type TEMPLATE \
    --configuration '{"TemplateConfiguration":{"Template":{{{JSON schema}}}}}'
   ```

1. 데이터 소스를 생성하는 데 Amazon Kendra 시간이 걸립니다. 진행률을 확인하려면 다음 명령을 입력합니다. 상태가 `ACTIVE`이면 다음 단계로 계속 진행합니다.

   ```
   aws kendra describe-data-source \
    --id {{data source ID}} \
    --index-id {{index ID}}
   ```

1. 다음 명령을 입력하여 데이터 소스를 동기화합니다.

   ```
   aws kendra start-data-source-sync-job \
    --id {{data source ID}} \
    --index-id {{index ID}}
   ```

1. Amazon Kendra 는 데이터 소스를 인덱싱합니다. 소요 시간은 문서 수에 따라 달라집니다. 다음 명령을 사용하여 동기화 작업 상태를 확인할 수 있습니다. 상태가 `ACTIVE`이면 다음 단계로 계속 진행합니다.

   ```
   aws kendra describe-data-source \
    --id {{data source ID}} \
    --index-id {{index ID}}
   ```

1. 다음 명령을 입력하여 쿼리를 수행합니다.

   ```
   aws kendra query \
    --index-id {{index ID}} \
    --query-text "{{search term}}"
   ```

   검색 결과는 JSON 형식으로 표시됩니다.