翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# チュートリアル: Amazon OpenSearch Serverless の開始方法
このチュートリアルでは、Amazon OpenSearch Serverless の検索コレクションを準備して、迅速に実行するための基本的な手順を説明します。検索コレクションを使用すると、内部ネットワーク内のアプリケーション、および e コマースウェブサイトの検索やコンテンツ検索などのインターネットに接続されたアプリケーションを強化できます。
ベクトル検索コレクションの使用方法については、「[ベクトル検索コレクションの使用](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 による適切なアクセス許可が必要です。このチュートリアルでは、コレクションを作成し、アップロードしたデータの検索を行い、最後にそのコレクションを削除します。
ユーザーまたはロールには、以下の最低限の許可を含む [ID ベースのポリシー](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 向けの アイデンティティとアクセス管理](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]** (検索) を選択します。詳細については、「[Choosing a collection type](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 Dashboards へのアクセスを有効にする]** の両方を選択します。データのアップロードと検索に、OpenSearch Dashboards を使用するため、上記の両方を有効にする必要があります。
1. [**次へ**] を選択します。
1. **[Configure data access]** (データアクセスの設定) で、コレクションのアクセス設定をセットアップします。[データアクセスポリシー](serverless-data-access.md)により、コレクション内のデータに対し、ユーザーとロールがアクセスできるようになります。以下のチュートリアルの例では、*movies* コレクション内にあるデータのインデックス作成と検索に必要なアクセス許可を、1 人のユーザーに提供します。
*movies* コレクションに対するアクセスを提供する単一のルールを作成します。このルールに、「**Movies collection access**」権という名前を付けます。
1. **[Add principals]** (プリンシパルを追加)、**[IAM users and roles]** (IAM ユーザーとロール) の順に選択し、OpenSearch Dashboards へのサインインとデータのインデックス作成に使用する IAM ユーザーを選択します。**[保存]** を選択します。
1. **[Index permissions]** (インデックス作成の許可) で、すべての許可を選択します。
1. [**次へ**] を選択します。
1. アクセスポリシーの設定では、**[Create a new data access policy]** (新しいデータアクセスポリシーとして作成する) を選択し、ポリシーに **[movies]** という名前を付けます。
1. [**次へ**] を選択します。
1. コレクションの設定を確認して、**[Submit]** (送信) を選択します。コレクションステータスが `Active` になるまで数分待機します。
## ステップ 3: データをアップロードして検索する
OpenSearch Serverless コレクションへのデータのアップロードには、[Postman](https://www.postman.com/downloads/) または cURL が使用できます。簡潔に言うと、これらの例では OpenSearch Dashboards** コンソール内の開発ツールを使用しています**。
**movies コレクションのデータをインデックス化して検索するには**
1. 左側のナビゲーションペインで **[Collections]** (コレクション) を選択した後、「**movies**」コレクションを選択してその詳細ページを開きます。
1. コレクションの OpenSearch Dashboards URL を選択します。この URL の形式は、`https://dashboards.{region}.aoss.amazonaws.com/_login/?collectionId={collection-id}` になります。
1. OpenSearch Dashboards 内で左側のナビゲーションペインを開き、**[Dev Tools]** (開発ツール) を選択します。
1. *movies-index* というインデックスを 1 つ作成するには、次のリクエストを送信します。
```
PUT movies-index
```
![\[OpenSearch Dashboards console showing PUT request for movies-index with JSON response.\]](http://docs.aws.amazon.com/ja_jp/opensearch-service/latest/developerguide/images/serverless-gsg-create.png)
1. 1 つのドキュメントを *movies-index* にインデックスするには、次のリクエストを送信します。
```
PUT movies-index/_doc/1
{
"title": "Shawshank Redemption",
"genre": "Drama",
"year": 1994
}
```
1. OpenSearch Dashboards 内でデータを検索するためには、少なくとも 1 つのインデックスパターンを設定する必要があります。OpenSearch は、そのパターンを使用して、分析する対象のインデックスを特定します。左のナビゲーションパネルを開き、**[Stack Management]** (スタック管理)、**[Index Patterns]** (インデックスパターン) の順に選択してから、**[Create index pattern]** (インデックスパターンを作成) を選択します。このチュートリアルでは、*movies* と入力します。
1. [**次のステップ**] を選択してから、[**インデックスパターンの作成**] を選択します。パターンが作成されたら、`title` および `genre` などのさまざまなドキュメントフィールドを表示できます。
1. データの検索を開始するには、左のナビゲーションパネルを再度開き **[Discover]** (検出) を選択するか、開発ツールの[検索 API](https://opensearch.org/docs/latest/api-reference/search/) を使用します。
## エラー処理
インデックスおよび検索オペレーションを実行すると、次のエラーレスポンスが表示されることがあります。
+ `HTTP 507` – 内部サーバーエラーが発生したことを示します。このエラーは通常、OpenSearch コンピューティングユニット (OCU) がリクエスト量またはリクエストの複雑さによって過負荷状態になっていることを示します。OpenSearch Serverless は負荷を管理するために自動的にスケーリングされますが、追加のリソースのデプロイに遅延が生じる可能性があります。
このエラーを軽減するには、エクスポネンシャルバックオフ再試行ポリシーを実装します。このアプローチにより、リクエストレートを一時的に低減させ、負荷を効果的に管理できます。詳細については、「*AWS SDK とツールのリファレンスガイド*」の「[Retry behavior](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. [**削除**] を選択して、削除を確認します。
## 次の手順
ここまでで、コレクションおよびデータインデックスの作成に関する練習が終わっています。さらに、以下の演習のいくつかも有用です。
+ コレクションを作成するための、高度なオプションを確認してみてください。詳細については、「[Amazon OpenSearch Serverless コレクションの管理](serverless-manage.md)」を参照してください。
+ コレクションのセキュリティを大規模に管理するための、セキュリティポリシーの設定方法を説明しています。詳細については、「[Amazon OpenSearch Serverless のセキュリティの概要](serverless-security.md)」を参照してください。
+ コレクション内でデータをインデックス化するための、他の方法を学びます。詳細については、「[Amazon OpenSearch Serverless コレクションへのデータの取り込み](serverless-clients.md)」を参照してください。