기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
이 자습서에서는 Amazon OpenSearch Serverless 검색 컬렉션을 신속하게 시작하고 실행하기 위한 기본 단계를 안내합니다. 검색 컬렉션을 사용하면 내부 네트워크의 애플리케이션과 전자상거래 웹사이트 검색 및 콘텐츠 검색과 같은 인터넷 경계 애플리케이션을 지원할 수 있습니다.
벡터 검색 컬렉션을 사용하는 방법을 알아보려면 벡터 검색 컬렉션 작업을 참조하세요. 컬렉션 사용에 대한 자세한 내용은 이 설명서의 Amazon OpenSearch Serverless 컬렉션 생성, 리스팅, 삭제 및 기타 주제 섹션을 참조하세요.
이 자습서에서는 다음 단계를 완료합니다.
-
참고
IndexName에 대해서는 ASCII 문자만 사용하는 것이 좋습니다.IndexName에 ASCII 문자를 사용하지 않으면 CloudWatch 지표의IndexName이 ASCII 문자가 아닌 문자인 경우 URL 인코딩 형식으로 변환됩니다.
1단계: 권한 구성
이 자습서를 완료하고 일반적으로 OpenSearch Serverless를 사용하려면 올바른 IAM 권한이 있어야 합니다. 이 자습서에서는 컬렉션을 생성하고 데이터를 업로드하고 검색한 다음 컬렉션을 삭제합니다.
사용자 또는 역할에는 다음과 같은 최소 권한이 포함된 연결된 자격 증명 기반 정책이 있어야 합니다.
{
"Version": "2012-10-17",
"Statement": [
{
"Action": [
"aoss:CreateCollection",
"aoss:ListCollections",
"aoss:BatchGetCollection",
"aoss:DeleteCollection",
"aoss:CreateAccessPolicy",
"aoss:ListAccessPolicies",
"aoss:UpdateAccessPolicy",
"aoss:CreateSecurityPolicy",
"aoss:GetSecurityPolicy",
"aoss:UpdateSecurityPolicy",
"iam:ListUsers",
"iam:ListRoles"
],
"Effect": "Allow",
"Resource": "*"
}
]
}OpenSearch Serverless IAM 권한에 대한 자세한 내용은 Amazon OpenSearch Serverless에 대한 Identity and Access Management 섹션을 참조하세요.
2단계: 컬렉션 생성
컬렉션은 특정 워크로드 또는 사용 사례를 지원하기 위해 함께 작동하는 OpenSearch 인덱스 그룹입니다.
OpenSearch Serverless 컬렉션 생성하기
-
https://console.aws.amazon.com/aos/home
Amazon OpenSearch Service 콘솔을 엽니다. -
왼쪽 탐색 창에서 Collections(컬렉션)를 선택하고 Create collection(컬렉션 생성)을 선택합니다.
-
컬렉션 이름을 movies(영화)로 지정합니다.
-
컬렉션 유형에서 Search(검색)를 선택합니다. 자세한 내용은 컬렉션 유형 선택을 참조하세요.
-
보안에서 표준 생성을 선택합니다.
-
암호화에서 AWS 소유 키사용을 선택합니다. AWS KMS key OpenSearch Serverless가 데이터를 암호화하는 데 사용하는 입니다.
-
Network(네트워크)에서 컬렉션에 대한 네트워크 설정을 구성합니다.
-
액세스 유형으로 Public(퍼블릭)을 선택합니다.
-
리소스 유형의 경우 OpenSearch 엔드포인트에 대한 액세스와 OpenSearch 대시보드에 대한 액세스를 모두 활성화합니다. OpenSearch 대시보드를 사용하여 데이터를 업로드하고 검색하므로 둘 다 활성화해야 합니다.
-
-
Next(다음)를 선택합니다.
-
Configure data access(데이터 액세스 구성)에서 컬렉션에 대한 액세스 설정을 지정합니다. 데이터 액세스 정책을 사용하면 사용자 및 역할이 컬렉션 내의 데이터에 액세스할 수 있습니다. 이 자습서에서는 단일 사용자에게 movies(영화) 컬렉션의 데이터를 인덱싱하고 검색하는 데 필요한 권한을 제공합니다.
movies 컬렉션에 대한 액세스를 제공하는 단일 규칙을 생성합니다. 규칙 이름을 Movies collection access(Movies 컬렉션 액세스)로 지정합니다.
-
Add principals(보안 주체 추가), IAM users and roles(IAM 사용자 및 역할)를 선택하고 OpenSearch 대시보드에 로그인하고 데이터를 인덱싱하는 데 사용할 사용자 또는 역할을 선택합니다. 저장(Save)을 선택합니다.
-
Index permissions(인덱스 권한)에서 모든 권한을 선택합니다.
-
Next(다음)를 선택합니다.
-
액세스 정책 설정에서 Create a new data access policy(새 데이터 액세스 정책 생성)를 선택하고 정책 이름을 movies로 지정합니다.
-
Next(다음)를 선택합니다.
-
컬렉션 설정을 검토하고 Submit(제출)을 선택합니다. 컬렉션이
Active상태가 될 때까지 몇 분 정도 기다립니다.
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와 같은 다양한 문서 필드를 볼 수 있습니다. -
데이터 검색을 시작하려면 왼쪽 탐색 창을 다시 열고 Discover(검색)를 선택하거나 개발 도구 내의 검색 API
를 사용합니다.
4단계: 컬렉션 삭제
movies(영화) 컬렉션은 테스트용이므로 실험을 마치면 삭제해야 합니다.
OpenSearch Serverless 컬렉션 삭제하기
-
Amazon OpenSearch Service 콘솔로 돌아갑니다.
-
왼쪽 탐색 창에서 Collections(컬렉션)를 선택하고 movies(영화) 컬렉션을 선택합니다.
-
[삭제(Delete)]를 선택하고 삭제 의사를 확인합니다.
다음 단계
컬렉션과 인덱스 데이터를 생성하는 방법을 알았으므로 다음 연습을 시도해볼 수 있습니다.
-
컬렉션 생성을 위한 고급 옵션을 참조하세요. 자세한 내용은 Amazon OpenSearch Serverless 컬렉션 생성, 리스팅, 삭제 단원을 참조하십시오.
-
컬렉션 보안을 대규모로 관리하기 위해 보안 정책을 구성하는 방법을 알아보세요. 자세한 내용은 Amazon OpenSearch Serverless 보안 개요 단원을 참조하십시오.
-
데이터를 컬렉션으로 인덱싱하는 다른 방법을 알아보세요. 자세한 내용은 Amazon OpenSearch Serverless 컬렉션으로 데이터 수집 단원을 참조하십시오.
