기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
자습서: Amazon OpenSearch Serverless 시작하기
이 자습서에서는 Amazon OpenSearch Serverless 검색 컬렉션을 빠르게 시작하고 실행하는 기본 단계를 보여줍니다. 검색 컬렉션을 사용하면 전자 상거래 웹 사이트 검색 및 콘텐츠 검색과 같은 내부 네트워크 및 인터넷 연결 애플리케이션의 애플리케이션을 강화할 수 있습니다.
벡터 검색 컬렉션을 사용하는 방법을 알아보려면 벡터 검색 컬렉션 작업을 참조하세요. 컬렉션 사용에 대한 자세한 내용은 이 설명서의 Amazon OpenSearch Serverless 컬렉션 관리 및 기타 주제 섹션을 참조하세요.
이 자습서에서는 다음 단계를 완료합니다.
-
참고
에는 ASCII 문자만 사용합니다
IndexName. 에 ASCII 문자를 사용하지 않으면 CloudWatch 지표IndexNameIndexName의가 ASCII가 아닌 문자의 URL 인코딩 형식으로 변환됩니다.
1단계: 권한 구성
이 자습서를 완료하고 일반적으로 OpenSearch Serverless를 사용하려면 올바른 IAM 권한이 있어야 합니다. 이 자습서에서는 컬렉션을 생성하고 데이터를 업로드하고 검색한 다음 컬렉션을 삭제합니다.
사용자 또는 역할에는 다음과 같은 최소 권한이 포함된 연결된 자격 증명 기반 정책이 있어야 합니다.
OpenSearch Serverless IAM 권한에 대한 자세한 내용은 Amazon OpenSearch Serverless에 대한 Identity and Access Management 섹션을 참조하세요.
2단계: 컬렉션 생성
컬렉션은 특정 워크로드 또는 사용 사례를 지원하기 위해 함께 작동하는 OpenSearch 인덱스 그룹입니다.
OpenSearch Serverless 컬렉션 생성하기
-
https://console.aws.amazon.com/aos/home
Amazon OpenSearch Service 콘솔을 엽니다. -
왼쪽 탐색 창에서 컬렉션을 선택합니다.
-
Create collection(컬렉션 생성)을 선택합니다.
-
이름에
movies를 입력합니다. -
컬렉션 유형에서 검색을 선택합니다. 자세한 내용은 컬렉션 유형 선택을 참조하세요.
-
컬렉션 생성 방법에서 Express 생성을 선택합니다.
-
기본 설정을 검토합니다. 여기에는 컬렉션 그룹, OpenSearch UI 애플리케이션 설정,를 사용한 암호화 AWS 소유 키, 퍼블릭 네트워크 액세스 및 자동 생성된 데이터 액세스 정책이 포함됩니다.
-
Create collection(컬렉션 생성)을 선택합니다.
-
컬렉션 상태가 로 변경될 때까지 기다립니다
Active. 몇 분 정도 걸릴 수 있습니다.
작은 정보
이 자습서에서는 NextGen Express 생성 방법을 사용합니다. 더 빠른 경로를 위해 랜딩 페이지의 정보 배너에 있는 Express 생성 버튼에서 Express 생성에 액세스할 수도 있습니다. 암호화, 네트워크 및 데이터 액세스 설정을 더 잘 제어하려면 표준 생성을 사용합니다. Classic 컬렉션 생성 마법사를 사용하려면 Classic으로 전환을 선택합니다. 자세한 내용은 컬렉션 생성 단원을 참조하십시오.
3단계: 데이터 업로드 및 검색
Postman
movies(영화) 컬렉션에서 데이터를 인덱싱하고 검색하기
-
왼쪽 탐색 창에서 Collections(컬렉션)를 선택하고 movies(영화) 컬렉션을 선택하여 세부 정보 페이지를 엽니다.
-
컬렉션에 대한 OpenSearch 대시보드 URL을 선택합니다. URL은
https://dashboards.형식을 취합니다.{region}.aoss.amazonaws.com/_login/?collectionId={collection-id} -
OpenSearch 대시보드에서 왼쪽 탐색 창을 열고 Dev Tools(개발 도구)를 선택합니다.
-
movies-index라는 단일 인덱스를 생성하려면 다음 요청을 보냅니다.
PUT movies-index
-
단일 문서를 movies-index로 인덱싱하려면 다음 요청을 보냅니다.
PUT movies-index/_doc/1 { "title": "Shawshank Redemption", "genre": "Drama", "year": 1994 } -
OpenSearch 대시보드에서 데이터를 검색하려면 하나 이상의 인덱스 패턴을 구성해야 합니다. OpenSearch는 이러한 패턴을 사용하여 분석할 인덱스를 식별하기 때문입니다. 왼쪽 탐색 창을 열고 Stack Management(스택 관리)를 선택하고 Index Patterns(인덱스 패턴)를 선택한 다음 Create index pattern(인덱스 패턴 생성)을 선택합니다. 본 자습서에서는 movies를 입력합니다.
-
다음 단계(Next step)를 선택한 후 인덱스 패턴 생성(Create index pattern)을 선택합니다. 패턴이 생성되면
title,genre와 같은 다양한 문서 필드를 볼 수 있습니다. -
데이터 검색을 시작하려면 왼쪽 탐색 창을 다시 열고 검색을 선택하거나 개발 도구에서 검색 API
를 사용합니다.
오류 처리
인덱스 및 검색 작업을 실행하면 다음과 같은 오류 응답이 표시될 수 있습니다.
-
HTTP 507- 내부 서버 오류가 발생했음을 나타냅니다. 이 오류는 일반적으로 요청의 볼륨 또는 복잡성으로 인해 OpenSearch 컴퓨팅 유닛(OCU)이 오버로드되었음을 나타냅니다. OpenSearch Serverless는 로드를 관리하기 위해 자동으로 확장되지만, 추가 리소스 배포가 지연될 수 있습니다.이 오류를 완화하려면 지수 백오프 재시도 정책을 구현합니다. 이 방식은 요청 속도를 일시적으로 줄여 로드를 효과적으로 관리합니다. 자세한 내용은 AWS SDK 및 도구 참조 가이드의 재시도 동작을 참조하세요.
-
HTTP 402- 최대 OpenSearch 컴퓨팅 유닛(OCU) 용량 한도에 도달했음을 나타냅니다. 워크로드를 최적화하여 OCU 사용량을 줄이거나, 할당량 증대를 요청합니다.
4단계: 컬렉션 삭제
영화 모음은 테스트용이므로 실험을 마쳤으면 삭제하세요.
OpenSearch Serverless 컬렉션 삭제하기
-
Amazon OpenSearch Service 콘솔로 돌아갑니다.
-
왼쪽 탐색 창에서 Collections(컬렉션)를 선택하고 movies(영화) 컬렉션을 선택합니다.
-
[삭제(Delete)]를 선택하고 삭제 의사를 확인합니다.
다음 단계
이제 컬렉션 및 인덱스 데이터를 생성하는 방법을 알았으므로 다음을 시도해 볼 수 있습니다.
-
컬렉션을 생성하기 위한 고급 옵션을 살펴봅니다. 자세한 내용은 Amazon OpenSearch Serverless 컬렉션 관리 단원을 참조하십시오.
-
대규모로 컬렉션 보안을 관리하도록 보안 정책을 구성합니다. 자세한 내용은 Amazon OpenSearch Serverless 보안 개요 단원을 참조하십시오.
-
다른 방법을 사용하여 데이터를 컬렉션으로 인덱싱합니다. 자세한 내용은 Amazon OpenSearch Serverless 컬렉션으로 데이터 수집 단원을 참조하십시오.