기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 자습서: Amazon OpenSearch Serverless 시작하기
이 자습서에서는 Amazon OpenSearch Serverless *검색* 컬렉션을 신속하게 시작하고 실행하기 위한 기본 단계를 안내합니다. 검색 컬렉션을 사용하면 내부 네트워크의 애플리케이션과 전자상거래 웹사이트 검색 및 콘텐츠 검색과 같은 인터넷 경계 애플리케이션을 지원할 수 있습니다.
*벡터 검색* 컬렉션을 사용하는 방법을 알아보려면 [벡터 검색 컬렉션 작업](serverless-vector-search.md)을 참조하세요. 컬렉션 사용에 대한 자세한 내용은 이 설명서의 [Amazon OpenSearch Serverless 컬렉션 관리](serverless-manage.md) 및 기타 주제 섹션을 참조하세요.
이 자습서에서는 다음 단계를 완료합니다.
1. [권한 구성](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/serverless-getting-started.html#serverless-gsg-permissions)
1. [컬렉션 생성](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/serverless-getting-started.html#serverless-gsg-create)
1. [데이터 업로드 및 검색](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/serverless-getting-started.html#serverless-gsg-index)
1. [컬렉션 삭제](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/serverless-getting-started.html#serverless-gsg-delete)
**참고**
`IndexName`에는 ASCII 문자만 사용하는 것이 좋습니다. `IndexName`에 ASCII 문자를 사용하지 않으면 CloudWatch 지표의 `IndexName`이 ASCII 문자가 아닌 문자인 경우 URL 인코딩 형식으로 변환됩니다.
## 1단계: 권한 구성
이 자습서를 완료하고 일반적으로 OpenSearch Serverless를 사용하려면 올바른 IAM 권한이 있어야 합니다. 이 자습서에서는 컬렉션을 생성하고 데이터를 업로드하고 검색한 다음 컬렉션을 삭제합니다.
사용자 또는 역할에는 다음과 같은 최소 권한이 포함된 연결된 [자격 증명 기반 정책](security-iam-serverless.md#security-iam-serverless-id-based-policies)이 있어야 합니다.
------
#### [ JSON ]
****
```
{
"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](security-iam-serverless.md) 섹션을 참조하세요.
## 2단계: 컬렉션 생성
컬렉션은 특정 워크로드 또는 사용 사례를 지원하기 위해 함께 작동하는 OpenSearch 인덱스 그룹입니다.
**OpenSearch Serverless 컬렉션 생성하기**
1. [https://console.aws.amazon.com/aos/home](https://console.aws.amazon.com/aos/home ) Amazon OpenSearch Service 콘솔을 엽니다.
1. 왼쪽 탐색 창에서 **Collections**(컬렉션)를 선택하고 **Create collection**(컬렉션 생성)을 선택합니다.
1. 컬렉션 이름을 **movies**(영화)로 지정합니다.
1. 컬렉션 유형에서 **Search**(검색)를 선택합니다. 자세한 내용은 [컬렉션 유형 선택](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/serverless-overview.html#serverless-usecase)을 참조하세요.
1. **보안**에서 **표준 생성**을 선택합니다.
1. **암호화**에서 ** AWS 소유 키사용**을 선택합니다. OpenSearch Serverless AWS KMS key 가 데이터를 암호화하는 데 사용하는 입니다.
1. **Network**(네트워크)에서 컬렉션에 대한 네트워크 설정을 구성합니다.
+ 액세스 유형으로 **Public**(퍼블릭)을 선택합니다.
+ 리소스 유형의 경우 **OpenSearch 엔드포인트에 대한 액세스**와 **OpenSearch 대시보드에 대한 액세스**를 모두 활성화합니다. OpenSearch 대시보드를 사용하여 데이터를 업로드하고 검색하므로 둘 다 활성화해야 합니다.
1. **다음**을 선택합니다.
1. **Configure data access**(데이터 액세스 구성)에서 컬렉션에 대한 액세스 설정을 지정합니다. [데이터 액세스 정책](serverless-data-access.md)을 사용하면 사용자 및 역할이 컬렉션 내의 데이터에 액세스할 수 있습니다. 이 자습서에서는 단일 사용자에게 **movies(영화) 컬렉션의 데이터를 인덱싱하고 검색하는 데 필요한 권한을 제공합니다.
**movies 컬렉션에 대한 액세스를 제공하는 단일 규칙을 생성합니다. 규칙 이름을 **Movies collection access**(Movies 컬렉션 액세스)로 지정합니다.
1. **Add principals**(보안 주체 추가), **IAM users and roles**(IAM 사용자 및 역할)를 선택하고 OpenSearch 대시보드에 로그인하고 데이터를 인덱싱하는 데 사용할 사용자 또는 역할을 선택합니다. **저장**을 선택합니다.
1. **Index permissions**(인덱스 권한)에서 모든 권한을 선택합니다.
1. **다음**을 선택합니다.
1. 액세스 정책 설정에서 **Create a new data access policy**(새 데이터 액세스 정책 생성)를 선택하고 정책 이름을 **movies**로 지정합니다.
1. **다음**을 선택합니다.
1. 컬렉션 설정을 검토하고 **Submit**(제출)을 선택합니다. 컬렉션이 `Active` 상태가 될 때까지 몇 분 정도 기다립니다.
## 3단계: 데이터 업로드 및 검색
[Postman](https://www.postman.com/downloads/) 또는 cURL을 사용하여 OpenSearch Serverless 컬렉션에 데이터를 업로드할 수 있습니다. 간결하게 하기 위해 이러한 예시는 OpenSearch 대시보드 콘솔의 **Dev Tools**(개발 도구)를 사용합니다.
**movies(영화) 컬렉션에서 데이터를 인덱싱하고 검색하기**
1. 왼쪽 탐색 창에서 **Collections**(컬렉션)를 선택하고 **movies**(영화) 컬렉션을 선택하여 세부 정보 페이지를 엽니다.
1. 컬렉션에 대한 OpenSearch 대시보드 URL을 선택합니다. URL은 `https://dashboards.{region}.aoss.amazonaws.com/_login/?collectionId={collection-id}` 형식을 취합니다.
1. OpenSearch 대시보드에서 왼쪽 탐색 창을 열고 **Dev Tools**(개발 도구)를 선택합니다.
1. **movies-index라는 단일 인덱스를 생성하려면 다음 요청을 보냅니다.
```
PUT movies-index
```
![\[OpenSearch Dashboards console showing PUT request for movies-index with JSON response.\]](http://docs.aws.amazon.com/ko_kr/opensearch-service/latest/developerguide/images/serverless-gsg-create.png)
1. 단일 문서를 *movies-index*로 인덱싱하려면 다음 요청을 보냅니다.
```
PUT movies-index/_doc/1
{
"title": "Shawshank Redemption",
"genre": "Drama",
"year": 1994
}
```
1. OpenSearch 대시보드에서 데이터를 검색하려면 하나 이상의 인덱스 패턴을 구성해야 합니다. OpenSearch는 이러한 패턴을 사용하여 분석할 인덱스를 식별하기 때문입니다. 왼쪽 탐색 창을 열고 **Stack Management**(스택 관리)를 선택하고 **Index Patterns**(인덱스 패턴)를 선택한 다음 **Create index pattern**(인덱스 패턴 생성)을 선택합니다. 본 자습서에서는 *movies*를 입력합니다.
1. **다음 단계(Next step)**를 선택한 후 **인덱스 패턴 생성(Create index pattern)**을 선택합니다. 패턴이 생성되면 `title`, `genre`와 같은 다양한 문서 필드를 볼 수 있습니다.
1. 데이터 검색을 시작하려면 왼쪽 탐색 창을 다시 열고 **Discover**(검색)를 선택하거나 개발 도구 내의 [검색 API](https://opensearch.org/docs/latest/api-reference/search/)를 사용합니다.
## 오류 처리
인덱스 및 검색 작업을 실행할 때 다음과 같은 오류 응답을 받을 수 있습니다.
+ `HTTP 507` - 내부 서버 오류가 발생했음을 나타냅니다. 이 오류는 일반적으로 요청의 볼륨 또는 복잡성으로 인해 OpenSearch 컴퓨팅 유닛(OCU)이 오버로드되었음을 나타냅니다. OpenSearch Serverless는 로드를 관리하기 위해 자동으로 확장되지만, 추가 리소스 배포가 지연될 수 있습니다.
이 오류를 완화하려면 지수 백오프 재시도 정책을 구현합니다. 이 방식은 요청 속도를 일시적으로 줄여 로드를 효과적으로 관리합니다. 자세한 내용은 *AWS SDK 및 도구 참조 가이드*의 [재시도 동작](https://docs.aws.amazon.com/sdkref/latest/guide/feature-retry-behavior.html)을 참조하세요.
+ `HTTP 402` - 최대 OpenSearch 컴퓨팅 유닛(OCU) 용량 한도에 도달했음을 나타냅니다. 워크로드를 최적화하여 OCU 사용량을 줄이거나, 할당량 증대를 요청합니다.
## 4단계: 컬렉션 삭제
*movies*(영화) 컬렉션은 테스트용이므로 실험을 마치면 삭제해야 합니다.
**OpenSearch Serverless 컬렉션 삭제하기**
1. **Amazon OpenSearch Service** 콘솔로 돌아갑니다.
1. 왼쪽 탐색 창에서 **Collections**(컬렉션)를 선택하고 **movies**(영화) 컬렉션을 선택합니다.
1. [**삭제(Delete)**]를 선택하고 삭제 의사를 확인합니다.
## 다음 단계
컬렉션과 인덱스 데이터를 생성하는 방법을 알았으므로 다음 연습을 시도해볼 수 있습니다.
+ 컬렉션 생성을 위한 고급 옵션을 참조하세요. 자세한 내용은 [Amazon OpenSearch Serverless 컬렉션 관리](serverless-manage.md) 단원을 참조하십시오.
+ 컬렉션 보안을 대규모로 관리하기 위해 보안 정책을 구성하는 방법을 알아보세요. 자세한 내용은 [Amazon OpenSearch Serverless 보안 개요](serverless-security.md) 단원을 참조하십시오.
+ 데이터를 컬렉션으로 인덱싱하는 다른 방법을 알아보세요. 자세한 내용은 [Amazon OpenSearch Serverless 컬렉션으로 데이터 수집](serverless-clients.md) 단원을 참조하십시오.