View a markdown version of this page

시작하기(AWS CLI) - Amazon Kendra

Amazon Kendra 는 2026년 7월 30일부터 신규 고객에게 더 이상 공개되지 않습니다. 서비스를 사용하려면 7월 30일 이전에 가입하세요. 와 유사한 기능을 알아보려면 Amazon Bedrock 지식 기반을 Amazon Kendra살펴보세요. 자세히 알아보기

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

시작하기(AWS CLI)

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

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

  1. 사전 조건을 수행합니다.

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

    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

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

    aws kendra describe-index \
 --id index id

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

    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}}}'

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

    aws kendra describe-data-source \
 --id data source ID \
 --index-id index ID

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

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

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

    aws kendra describe-data-source \
 --id data source ID \
 --index-id index ID

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

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

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