ステップ 1: アクセス許可を設定するステップ 2: コレクションを作成するステップ 3: データをアップロードして検索するステップ 4: コレクションを削除する次のステップ

Amazon OpenSearch Serverless の開始方法

このチュートリアルでは、Amazon OpenSearch Serverless 検索コレクションをすばやく起動して実行するための基本的な手順について説明します。検索コレクションを使用すると、内部ネットワーク内のアプリケーション、および e コマースウェブサイトの検索やコンテンツ検索などのインターネットに接続されたアプリケーションを強化できます。

ベクトル検索コレクションの使用方法については、「ベクトル検索コレクションの使用」を参照してください。コレクションの使用に関する詳細については、このガイドの「Amazon OpenSearch サーバーレスコレクションの作成、一覧表示、削除」とその他のトピックを参照してください。

このチュートリアルでは、次の手順を実行します。

ステップ 1: アクセス許可を設定する

このチュートリアルを完了し、一般的に OpenSearch Serverless を使用するには、正しい IAM アクセス許可が必要です。このチュートリアルでは、コレクションを作成し、アップロードしたデータの検索を行い、最後にそのコレクションを削除します。

ユーザーまたはロールには、以下の最低限の許可を含む ID ベースのポリシーが、アタッチされている必要があります。


{
  "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 サーバーレスコレクションを作成するには

https://console.aws.amazon.com/aos/home で Amazon OpenSearch Service コンソールを開きます。
左側のナビゲーションペインで [Collections] (コレクション) 、[Create collection] (コレクションを作成) を選択します。
コレクションに movies という名前を付けます。
コレクションタイプでは、[Search] (検索) を選択します。詳細については、「Choosing a collection type」(コレクションタイプの選択) を参照してください。
セキュリティで、標準作成 を選択します。
暗号化 で、 の使用 AWS 所有のキーを選択します。これは、 OpenSearch サーバーレス AWS KMS key がデータの暗号化に使用するです。
[Network] (ネットワーク) で、コレクションのネットワーク設定を行います。
- アクセスタイプには、[Public] (パブリック) を選択します。
- リソースタイプで、 OpenSearch エンドポイントへのアクセスを有効にする と OpenSearch Dashboards へのアクセスを有効にする の両方を選択します。 OpenSearch Dashboards を使用してデータをアップロードおよび検索するため、両方を有効にする必要があります。
[次へ] をクリックします。
[Configure data access] (データアクセスの設定) で、コレクションのアクセス設定をセットアップします。データアクセスポリシーにより、コレクション内のデータに対し、ユーザーとロールがアクセスできるようになります。このチュートリアルでは、movies コレクション内にあるデータのインデックス作成と検索に必要なアクセス許可を、1 人のユーザーに提供します。

movies コレクションに対するアクセスを提供する単一のルールを作成します。このルールに、「Movies collection access」権という名前を付けます。
「プリンシパルの追加」、「IAM ユーザーとロール」を選択し、 OpenSearch ダッシュボードへのサインインとデータのインデックス作成に使用するユーザーまたはロールを選択します。[保存] を選択します。
[Index permissions] (インデックス作成の許可) で、すべての許可を選択します。
[次へ] をクリックします。
アクセスポリシーの設定では、[Create a new data access policy] (新しいデータアクセスポリシーとして作成する) を選択し、ポリシーに [movies] という名前を付けます。
[次へ] をクリックします。
コレクションの設定を確認して、[Submit] (送信) を選択します。コレクションステータスが Active になるまで数分待機します。

ステップ 3: データをアップロードして検索する

Postman または cURL を使用して、 OpenSearch サーバーレスコレクションにデータをアップロードできます。簡略化のため、これらの例では OpenSearch Dashboards コンソール内で開発ツールを使用します。

movies コレクションのデータをインデックス化して検索するには

左側のナビゲーションペインで [Collections] (コレクション) を選択した後、「movies」コレクションを選択してその詳細ページを開きます。
コレクションの OpenSearch Dashboards URL を選択します。この URL の形式は、https://dashboards.{region}.aoss.amazonaws.com/_login/?collectionId={collection-id} になります。
OpenSearch ダッシュボードで、左側のナビゲーションペインを開き、開発ツール を選択します。
次のリクエストを送信し、「movies-index」というインデックスを 1 つ作成します。
```
PUT movies-index 
```
1 つのドキュメントを「movies-index」にインデックスするために、次のリクエストを送信します。
```
PUT movies-index/_doc/1
{ 
  "title": "Shawshank Redemption",
  "genre": "Drama",
  "year": 1994
}
```
OpenSearch Dashboards でデータを検索するには、少なくとも 1 つのインデックスパターンを設定する必要があります。 OpenSearch はこれらのパターンを使用して、分析するインデックスを識別します。左のナビゲーションパネルを開き、[Stack Management] (スタック管理)、[Index Patterns] (インデックスパターン) の順に選択してから、[Create index pattern] (インデックスパターンを作成) を選択します。このチュートリアルでは、movies と入力します。
[次のステップ] を選択してから、[インデックスパターンの作成] を選択します。パターンが作成されたら、title および genre などのさまざまなドキュメントフィールドを表示できます。
データの検索を開始するには、左のナビゲーションパネルを再度開き [Discover] (検出) を選択するか、開発ツールの検索 API を使用します。

ステップ 4: コレクションを削除する

「movies」コレクションはテスト用のため、試用を終了したら確実に削除します。

OpenSearch Serverless コレクションを削除するには

Amazon OpenSearch Service コンソールに戻ります。
左側のナビゲーションペインで [Collections] (コレクション) を選択した後、「movies」コレクションを選択します。
[削除] を選択して、削除を確認します。

次のステップ

ここまでで、コレクションおよびデータインデックスの作成に関する練習が終わっています。さらに、以下の演習のいくつかも有用です。

コレクションを作成するための、高度なオプションを確認してみてください。詳細については、「Amazon OpenSearch サーバーレスコレクションの作成、一覧表示、削除」を参照してください。
コレクションのセキュリティを大規模に管理するための、セキュリティポリシーの設定方法を説明しています。詳細については、「Amazon OpenSearch サーバーレスのセキュリティの概要」を参照してください。
コレクション内でデータをインデックス化するための、他の方法を学びます。詳細については、「Amazon OpenSearch Serverless コレクションへのデータの取り込み」を参照してください。

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

Amazon OpenSearch Serverless とは

コレクションの作成と管理