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

このチュートリアルでは、Alibaba Cloud Elasticsearch (ES) を初めて利用する開発者向けに、クラスターの作成からデータの取得までのプロセスを解説します。このチュートリアルは、クラスター作成の待機時間 20 分を含め、完了までに約 45 分かかります。

学習内容

ES クラスターの作成と設定
Kibana の Dev Tools を使用したデータモデリング
Kibana は ES のコアコンポーネントであり、ES に保存されたデータを探索、分析、可視化するための直感的なグラフィカルインターフェイスを提供します。利便性のため、Kibana は ES コンソールに組み込まれており、手動でインストールする必要はありません。
サンプルデータの挿入とさまざまな取得操作の実行

このチュートリアルを完了すると、インデックスの作成、データの読み書き、検索の実行など、ES の基本的な機能を理解できます。

ES のバージョンと費用

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

ES のタイプとバージョン：Vector Enhanced Edition 8.17.0
このバージョンは、AI 検索パイプラインにおけるコアアルゴリズムサービスをモジュール化しています。これらのサービスには、ドキュメント解析、スライシング、テキスト埋め込み、クエリ分析、取得、ソート、大規模言語モデル (LLM) が含まれます。このバージョンはセマンティック検索をサポートし、検索拡張生成 (RAG) やマルチモーダル検索機能を迅速に構築するのに役立ちます。
推定費用：このチュートリアルでは、従量課金の課金方法を使用します。推奨される仕様と期間に従う場合、総費用は 20 人民元未満になる見込みです。チュートリアル完了後は、不要な課金を避けるために、速やかにクラスターをリリースしてください。

前提条件

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

操作手順

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

クラスター作成ページに移動してクラスターを作成します。主要なパラメーターを以下の表に従って設定します。その他のパラメーターはデフォルト値のままでかまいません。

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

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

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

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

アクセス認証には 2 要素認証が使用されます。まず、Alibaba Cloud アカウントにログインします。次に、ES クラスターのアクセス認証情報を使用して 2 回目の認証を行います。ユーザー名は elastic に固定されており、対応するパスワードを入力する必要があります。

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

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

デバイスの IP アドレスの取得

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

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

パブリックアクセスホワイトリストへの IP アドレスの追加

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

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

設定タイプ

フォーマットと例

重要な注意点

IPv4 アドレス形式

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

単一のクラスターに対して最大 300 個の IP アドレスまたは CIDR ブロックを設定できます。複数の 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 コンソールにリダイレクトされ、ES データを探索できます。
- ユーザー名：ユーザー名は elastic に固定されています。
- パスワード：ES クラスター作成時に設定したパスワード。パスワードを忘れた場合は、リセットできます。
[Dev Tools] コンソールで、GET / コマンドを実行してクラスター情報を照会します。
検証：右側のペインにバージョン番号やクラスター名などの情報を含む JSON オブジェクトが表示されれば、接続は成功です。

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

Kibana Dev Tools で、以下のコマンドを実行して、資産運用商品のデータ用に 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":"資産運用商品 A","annual_rate":"3.2200%","describe":"180 日間の定期商品。最低投資額：20,000。安定したリターン。プッシュ通知はオプション。"}
{"index":{}}
{"productName":"資産運用商品 B","annual_rate":"3.1100%","describe":"90 日間の積立投資商品。最低投資額：10,000。リターン入金時に毎日プッシュ通知。"}
{"index":{}}
{"productName":"資産運用商品 C","annual_rate":"3.3500%","describe":"270 日間の積立投資商品。最低投資額：40,000。リターン即時入金時に毎日プッシュ通知。"}
{"index":{}}
{"productName":"資産運用商品 D","annual_rate":"3.1200%","describe":"90 日間の積立投資商品。最低投資額：12,000。リターン入金時に毎日プッシュ通知。"}
{"index":{}}
{"productName":"資産運用商品 E","annual_rate":"3.0100%","describe":"おすすめの 30 日間積立投資商品。最低投資額：8,000。リターン時に毎日プッシュ通知。"}
{"index":{}}
{"productName":"資産運用商品 F","annual_rate":"2.7500%","describe":"人気の 3 日間短期商品。サービス料金なし。最低投資額：500。リターン通知はショートメッセージで送信。"}

検証：結果に "errors": false が含まれていれば、データは挿入されています。

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

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

describe フィールドに「リターン入金時に毎日プッシュ通知」を含む資産運用商品を照会します。

GET /product_info/_search
{
  "query": {
    "match": {
      "describe": "リターン入金時に毎日プッシュ通知"
    }
  }
}

検証：結果は関連度スコアでソートされます。スコアが高い結果ほど上位に表示されます。

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

annual_rate (年率換算収益率) が 3.00% から 3.13% の間の資産運用商品を照会します。

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

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

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

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

以下のコマンドを実行して、このチュートリアルで作成したテストインデックスを削除します。
```
DELETE /product_info
```
以下の結果が返されます。
Elasticsearch コンソールのクラスターリストに戻ります。
クラスターリストで、リリースしたいクラスターを見つけます。操作列で、 > クラスターのリリース をクリックし、直ちに削除 を選択します。その後、OK をクリックしてクラスターをリリースします。
重要
クラスターをリリースすると、クラスターとそれに含まれるすべてのデータが完全に削除されます。この操作は元に戻すことができません。操作は慎重に行ってください。

次の学習ステップ

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

データの収集/移行：ビジネスデータを ES に収集または移行する
移行前に、データ量に基づいてクラスターの構成をスペックアップする必要があるかどうかを判断する必要があります。
AI サービス：検索拡張生成 (RAG) 技術を使用して、検索プロセスの各段階を強化します。
パフォーマンスチューニング: インデックス設計とクエリ最適化のテクニックを検討し、クラスターのパフォーマンスを向上させます。
Kibana の可視化：Discover や Dashboard などの Kibana の機能を使用してデータ可視化ダッシュボードを作成する方法を学びます。