Alibaba Cloud Elasticsearch クイックスタート - Elasticsearch - Alibaba Cloud ドキュメントセンター

このチュートリアルでは、Alibaba Cloud Elasticsearch を初めて利用する開発者向けに、クラスターの作成とデータ取得の方法を解説します。所要時間は約 45 分で、これにはクラスター作成の待機時間約 20 分が含まれます。

学習内容

Alibaba Cloud Elasticsearch クラスターの作成と設定
Kibana の Dev Tools を使用したデータモデリング
Kibana は Alibaba Cloud Elasticsearch コンソールに組み込まれており、手動でのインストールは不要です。
サンプルデータの挿入と各種検索操作の実行

このチュートリアルを完了すると、インデックスの作成、データの読み書き、検索の実行など、Alibaba Cloud Elasticsearch の基本操作を行えるようになります。

バージョンと費用

開始する前に、このチュートリアルの主要な情報を以下でご確認ください。

クラスタータイプとバージョン：Vector Enhanced Edition 8.17.0
このバージョンはセマンティック検索をサポートし、企業が検索拡張生成 (RAG) やマルチモーダル検索機能を迅速に構築するのに役立ちます。
費用の見積もり：このチュートリアルでは、従量課金の課金方法を使用します。推奨される仕様と所要時間に厳密に従った場合、総費用は 5 米ドル未満と見積もられます。チュートリアル完了後、不要な料金を避けるために、クラスターを直ちにリリースしてください。

前提条件

登録して Alibaba Cloud アカウントにログインします。アカウントに Elasticsearch や VPC などのリソースを作成および管理する権限があることを確認してください。
Virtual Private Cloud (VPC) と vSwitch を作成します。VPC と vSwitch のリージョンとゾーンをメモしておきます。Elasticsearch クラスターを作成する際に、同じリージョンとゾーンを選択する必要があります。そうしないと、クラスターを VPC と vSwitch に関連付けることができません。

操作手順

ステップ 1：クラスターの作成 (約 20 分)

クラスター作成ページに移動してクラスターを作成します。次の表の説明に従って主要なパラメーターを設定します。その他のパラメーターはデフォルト値を使用できます。

パラメーター	説明
支払い方法	従量課金を選択します。クラスターはいつでもリリースできます。
リージョンとゾーン	リージョン：ご利用の VPC と vSwitch があるリージョンを選択します。ゾーン：このチュートリアルでは、クラスターの作成時間を短縮するために、シングルゾーンを選択します。本番環境では、マルチ AZ デプロイにスペックアップできます。このチュートリアルでは、中国 (杭州) とゾーン I を使用します。
ネットワークタイプ	作成した VPC と vSwitch を選択します。
インスタンスタイプとElasticsearch バージョン	Vector Enhanced Edition 8.17.0 を選択します。このチュートリアルはこのバージョンに基づいています。
データノード仕様	CPU タイプ：Intel 2 コア 4 GiB データノードストレージタイプとサイズ：標準 SSD、ノードあたり 20 GiB のストレージ容量データノード数：2 データノードはインデックスデータを保存し、ドキュメントの作成、取得、更新、削除、集計などの操作に使用されます。
	ES_test
パスワード	カスタムパスワードを作成します。後で Kibana にログインしてインデックスを作成し、データを探索する際に使用します。

[今すぐ購入] をクリックし、クラスターのステータスが Active に変わるまで約 20 分待ってから、次のステップに進みます。

ステップ 2：Kibana の設定とログイン

Kibana へのパブリックアクセスはデフォルトで有効になっています。セキュリティ上の理由から、デフォルトではすべての IP アドレスからのアクセスが拒否されています。Kibana にアクセスするには、ご利用のデバイスの IP アドレスをパブリックアクセスホワイトリストに追加する必要があります。

まず、Alibaba Cloud アカウントにログインします。次に、Elasticsearch クラスターの認証情報を入力します。ユーザー名は elastic で、パスワードは設定時に作成したものです。

左側のナビゲーションウィンドウで、データ可視化 をクリックします。[Kibana] セクションで、設定の編集 をクリックします。

ネットワークアクセス設定 セクションで、Kibana パブリックアクセスホワイトリストを変更します。

デバイス IP の取得

以下のシナリオに基づいて、ご利用のデバイスの IP アドレスを取得できます。

シナリオ	IP アドレス	方法
ローカルマシンからインターネット経由で Kibana にアクセスします。	ローカルマシンのパブリック IP アドレス。説明ローカルマシンがホームネットワークまたは企業の LAN (ローカルエリアネットワーク) 上にある場合は、LAN のパブリック出口 IP アドレスを追加する必要があります。	`curl ipinfo.io/ip` コマンドを実行して、ローカルマシンのパブリック IP アドレスをクエリします。
Elastic Compute Service (ECS) インスタンスからインターネット経由で Kibana にアクセスします。	ECS インスタンスと Elasticsearch クラスターが異なる VPC にある場合、ECS インスタンスのパブリック IP アドレスを使用して Kibana にアクセスできます。これを行うには、ECS インスタンスのパブリック IP アドレスをクラスターのパブリックアクセスホワイトリストに追加します。	ECS コンソールにログインし、インスタンスリストでインスタンスのパブリック IP アドレスを表示します。

パブリックホワイトリストへの追加

ご利用のデバイスの IP アドレスを取得し、パブリックアクセスホワイトリストに追加します。

[デフォルト] グループの右側にある設定をクリックします。表示されるダイアログボックスで、IP アドレスをホワイトリストに追加します。

設定タイプ

フォーマットと例

重要な注意事項

IPv4 アドレス形式

単一 IP アドレス：192.168.0.1
CIDR ブロック：192.168.0.0/24。散在する IP アドレスを CIDR ブロックにマージすることを推奨します。

単一のクラスターには、最大 300 の IP アドレスまたは CIDR ブロックのホワイトリストを設定できます。複数のエントリはカンマ (,) で区切り、カンマの前後にスペースを追加しないでください。

デフォルトのパブリックアドレス：127.0.0.1。これはすべての IPv4 アドレスからのアクセスを拒否します。
0.0.0.0/0：すべての IPv4 アドレスからのアクセスを許可します。
重要
- 0.0.0.0/0 の設定は強く推奨しません。これは高いセキュリティリスクをもたらします。
- 一部のクラスターとリージョンでは 0.0.0.0/0 をサポートしていません。実際の可用性は UI またはエラーメッセージに従います。

構成が完了したら、OK をクリックします。

インターネットからのアクセス をクリックします。Kibana ログインページで、ユーザー名とパスワードを入力します。ログインすると Kibana コンソールにリダイレクトされ、そこで Elasticsearch データの探索を開始できます。
- ユーザー名: ユーザー名は elastic です。
- パスワード: Elasticsearch クラスターの作成時に設定したパスワードです。パスワードを忘れた場合は、リセットできます。
[デベロッパーツール] コンソールに移動し、GET / コマンドを実行してクラスターの情報をクエリします。
検証：右側の応答ペインに、バージョン番号やクラスター名などの情報を含む JSON オブジェクトが返された場合、接続は成功です。

ステップ 3：インデックスの作成

Kibana Dev Tools で、次の RESTful API コマンドを実行して、資産運用商品データのための product_info という名前のインデックスマッピングを作成します。

PUT /product_info
{
  "settings": {
    "number_of_shards": 5,
    "number_of_replicas": 1
  },
  "mappings": {
      "properties": {
        "productName": {
          "type": "text",
          "analyzer": "ik_smart"
        },
        "annual_rate":{
          "type":"keyword"
        },
        "describe": {
          "type": "text",
          "analyzer": "ik_smart"
        }
    }
  }
}

パラメーターの説明：

settings：インデックスのシャード設定を定義します。たとえば、5 つのプライマリシャードと各プライマリシャードに 1 つのレプリカを定義できます。

mappings：インデックスのフィールドを定義します。たとえば、インデックスに productName、annual_rate、describe の 3 つのフィールドを定義できます。text 型は形態素解析とあいまい検索をサポートし、keyword 型は完全一致のマッチングに使用されます。フィールドのデータ型についての詳細は、「フィールドのデータ型」をご参照ください。

検証：応答に "acknowledged": true と "shards_acknowledged": true が含まれている場合、インデックスは正常に作成されました。

ステップ 4：データの挿入

次のコマンドを実行して、テストデータを一括挿入します。

POST /product_info/_bulk
{"index":{}}
{"productName":"Wealth Management Product A","annual_rate":"3.2200%","describe":"180-day fixed-term product. Minimum investment: 20,000. Stable returns. Optional push notifications."}
{"index":{}}
{"productName":"Wealth Management Product B","annual_rate":"3.1100%","describe":"90-day scheduled investment product. Minimum investment: 10,000. Daily push notifications for credited returns."}
{"index":{}}
{"productName":"Wealth Management Product C","annual_rate":"3.3500%","describe":"270-day scheduled investment product. Minimum investment: 40,000. Daily push notifications for immediately credited returns."}
{"index":{}}
{"productName":"Wealth Management Product D","annual_rate":"3.1200%","describe":"90-day scheduled investment product. Minimum investment: 12,000. Daily push notifications for credited returns."}
{"index":{}}
{"productName":"Wealth Management Product E","annual_rate":"3.0100%","describe":"Recommended 30-day scheduled investment product. Minimum investment: 8,000. Daily push notifications for returns."}
{"index":{}}
{"productName":"Wealth Management Product F","annual_rate":"2.7500%","describe":"Popular 3-day short-term product. No service fees. Minimum investment: 500. Return notifications sent by text message."}

検証：応答に "errors": false が含まれている場合、データは正常に挿入されました。

ステップ 5：データの取得

全文検索 (あいまい一致)

describe フィールドに「Daily push notifications for credited returns」を含む資産運用商品をクエリします。

GET /product_info/_search
{
  "query": {
    "match": {
      "describe": "Daily push notifications for credited returns"
    }
  }
}

検証：結果は関連度スコアでソートされ、スコアの高い結果が先に表示されます。

条件付き検索 (完全一致)

annual_rate が 3.00% から 3.13% の間の資産運用商品をクエリします。

GET /product_info/_search
{
  "query": {
    "range": {
      "annual_rate": {
        "gte": "3.0000%",
        "lte": "3.1300%"
      }
    }
  }
}

検証：クエリは数値範囲で完全一致を実行し、条件を満たす結果を返します。クエリ条件の使用方法の詳細については、「Query DSL」をご参照ください。

リソースのクリーンアップと次のステップ

データの削除とクラスターのリリース

次のコマンドを実行して、テストインデックスを削除します。
```
DELETE /product_info
```
次の結果が返されます。
```
{ "acknowledged" : true }
```
Elasticsearch コンソールのクラスターリストに移動します。
クラスターリストでリリースするクラスターを見つけ、操作列で > クラスターのリリース をクリックし、直ちに削除 を選択してから OK をクリックしてクラスターをリリースします。
重要
クラスターをリリースすると、クラスターとそれに含まれるすべてのデータが完全に削除されます。この操作は元に戻すことはできません。慎重に進めてください。

次のステップ

Alibaba Cloud Elasticsearch についてさらに学ぶには、以下のトピックを探索できます。

データの収集と移行：ビジネスデータを Elasticsearch に収集または移行するをご参照ください。
データを移行する前に、データ量を評価して、クラスター構成のスペックアップが必要かどうかを判断してください。
パフォーマンスチューニング：クラスターのパフォーマンスを向上させるためのインデックス設計とクエリ最適化のテクニックを学びます。
Kibana の可視化：Kibana の Discover や Dashboard などの機能を使用してデータダッシュボードを作成する方法を学びます。