アプリケーションを構成 - OpenSearch - Alibaba Cloud - OpenSearch

インスタンス情報、データソース、インデックス管理など、OpenSearch アプリケーションの主要な設定項目とステータス表示について説明します。

インスタンスの基本情報

1. インスタンス ID：インスタンスの一意の識別子です。

2. タグ：インスタンスを識別し、グループ化するために使用するカスタムラベルです。

3. インスタンス作成時刻：インスタンスが作成された時刻です。形式は YYYY-mm-dd HH:MM:SS です。

4. 課金方法：OpenSearch の課金方法です。サブスクリプションまたは従量課金を選択できます。

5. リージョン：アプリケーションがデプロイされているリージョンです。例：China (Hangzhou)、China (Shanghai)、China (Beijing)、China (Qingdao)、China (Zhangjiakou)。

6. エディション：OpenSearch インスタンスのエディションです。例：High-Performance Search Edition。

7. クラスター優先仕様：ユースケースに基づく仕様です。例：Shared General-Purpose、Shared Compute-Optimized、Dedicated General-Purpose、Dedicated Compute-Optimized。

8. ストレージリソース：アプリケーション内のすべてのテーブルにある全ドキュメントの累積サイズです。この値にはフィールド名は含まれません。容量は、フィールド内容を文字列として扱って算出されます。

9. コンピューティングリソース：LCU (ロジックコンピューティングユニット) は、検索のコンピューティング能力を測定する単位です。1 LCU は、検索クラスターにおける 10 ミリコアのコンピューティング能力を表します。注：ミリコアは CPU リソースの単位で、CPU コアの 1/1000 に相当します。

10. インスタンスの説明：インスタンスの簡単な説明です。任意の内容にカスタマイズできます。

オンラインアプリケーションとオフラインアプリケーション

アプリケーションを初めて設定してインデックスの再構築を行うと、オンラインアプリケーションになります。その後、データのクリアやオフライン変更など、インデックスの再構築をトリガーする操作を実行すると、OpenSearch は本番サービスの安定性を確保するためにオフラインアプリケーションを作成します。すべての変更はオフラインアプリケーション上で行います。OpenSearch がオフラインアプリケーションのインデックス構築に成功したら、テストできます。テストに合格した場合は、新しいオンラインアプリケーションとして公開できます。このプロセスにより、インスタンス操作が本番サービスに影響するのを防ぎます。

ステータス

アプリケーションステータスは現在の状態を示します。「正常」ステータスは、アプリケーションバージョンがトラフィックを処理中であることを意味します。

非アクティブなアプリケーションのその他のステータスは次のとおりです：

1) 設定保留中：アプリケーションが設定される前のステータスです。

2) バージョン初期化中

3) データ初期化中

4) 無効：合計ストレージがクォータを超過した場合、またはデータソースのテーブルもしくはフィールドが存在しない場合に、アプリケーションは無効になります。無効なアプリケーションは、削除してから再設定することしかできません。

5) 期限切れ：サブスクリプションインスタンスの場合、課金サイクルが終了するとサービスが停止します。インスタンスは 7 日間保持され、この期間中は更新のみ可能です。その他の操作はすべて無効になります。

6) 凍結：支払い遅延があるアプリケーションのステータスです。

アプリケーションの基本情報

現在のアプリケーションバージョンには、課金方法、エディション、ストレージリソース、コンピューティングリソース、インスタンス ID、リージョン、アプリケーションの説明が含まれます。

注：課金ルールの詳細については、「Billing overview for native OpenSearch instances」をご参照ください。

API エンドポイント

リージョンごとに異なる API ドメイン名があり、これは endpoint とも呼ばれます。API または SDK を使用して OpenSearch にアクセスする場合は、ここに記載されている API エンドポイントを使用してください。リージョンには、内部 API ドメイン名 (同一リージョン内の ECS インスタンス向け。VPC 環境を含む) と、パブリック API ドメイン名 (パブリックネットワーク環境向け) がそれぞれ用意されています。デプロイ環境に応じて適切なドメイン名を選択し、使用前に ping で疎通を確認してください。

China (Hangzhou) リージョンの場合、パブリック API ドメイン名は http://opensearch-cn-hangzhou.aliyuncs.com、内部 API ドメイン名は http://intranet.opensearch-cn-hangzhou.aliyuncs.com です。いずれも HTTPS をサポートしています。

データソース

OpenSearch は、次のデータソースをサポートしています：MaxCompute (formerly ODPS)、RDS (5.2 から 8.0 まで (8.0 を含む) をサポートします。この範囲外のバージョンはサポートされません)、PolarDB、および API/SDK によるデータインポート。

アプリケーションのスキーマ

スキーマ：アプリケーションのテーブル構造です。
インデックスフィールド：インデックスとして設定されるフィールドです。フィールド名がインデックス名として使用されます。

例： query=id:'cloud_search'。インデックス分析の詳細については、「テキストアナライザー」をご参照ください。
属性フィールド：属性として設定されるフィールドです。

使用方法：これらのフィールドを filter、aggregate、sort、distinct 句で使用して、フィルタリング、集計、並べ替えを実行できます。例： filter=id>100000。

デフォルト表示フィールド

デフォルト表示フィールドを使用して、各検索リクエストで返されるフィールドを指定します。

CloudMonitor

CloudMonitor は、現在のアプリケーションバージョンにおける一般的なメトリクス (例：Storage Capacity (bytes)、Storage Usage (%)、Total Documents、クエリ QPS (queries/sec)、Throttled Query QPS (queries/sec)、クエリレイテンシー (ms)、Compute Resource (LCU)、LCU Consumption per Query、Daily Peak of Compute Resource (LCU)) を表示します。メトリクスの定義とアラート設定については、「CloudMonitor Alarms」をご参照ください。

インデックスの再構築

OpenSearch は、各種データソースから同期されたデータを含め、アップロードされたデータのミラーコピーを保持します。アプリケーションのスキーマを変更する場合、またはフルデータセットをインポートする必要がある場合は、インデックスの再構築が必要です。方法は 2 つあります。1) 手動でのインデックスの再構築：通常、アプリケーションのスキーマを変更する場合や、ユーザーの全量データをインポートする場合に使用します。2) スケジュールによるインデックスの再構築：通常、MaxCompute などのデータソースから日次で全量データをインポートする場合に使用します。RDS のデータはデフォルトで同期されるため、スケジュールタスクを設定する必要はありません。

サブスクリプションへの切り替え

課金方法を従量課金からサブスクリプションに変更します。課金方法、料金、手順の詳細については、「Modify Instance Specifications」をご参照ください。

エラーログ

エラーログには、インデックスの再構築に失敗した操作や、API/SDK によるデータプッシュの失敗に関するメッセージが表示されます。API/SDK によるプッシュは非同期で処理されるため、コード側で成功レスポンスが返っても、プッシュの成功を保証するものではありません。データ処理に失敗した場合、コンソールにエラーが報告されます。エラーコードの説明については、「Error Code Reference」をご参照ください。

デコミッション済みのアプリケーション

オンラインアプリケーションは、現在検索トラフィックを処理しているバージョンです。

アプリケーションのスキーマなど、アプリケーションの設定を変更する必要がある場合、OpenSearch はオンラインアプリケーションのコピーであるオフラインアプリケーションを作成します。オフラインアプリケーションは、オンラインバージョンと同じ設定で始まります。オンラインアプリケーションに対してオフライン変更 (データソース、アプリケーションのスキーマ、インデックス構造) を実行できるほか、クエリ設定、並べ替え設定、その他の拡張機能も変更できます。ただし、オフラインアプリケーションから別のバージョンを作成することはできません。オフラインアプリケーション自体を変更することしかできません。オンラインアプリケーションとオフラインアプリケーションは継承関係にありますが、独立したエンティティです。

デコミッション済みのアプリケーション：オフラインアプリケーションを公開すると、新しいオンラインアプリケーションになり、以前のオンラインアプリケーションはデコミッション済みのアプリケーションになります。新しいオンラインアプリケーションは Published ステータスになり、再度公開することはできません。別のオフライン変更を開始して新しいオフラインアプリケーションを作成した場合にのみ、再度公開できます。

アプリケーションの削除

誤って削除するのを防ぐため、オンラインアプリケーションの名前を入力して操作を確認する必要があります。

OpenSearch では、オンラインバージョンが存在する間はアプリケーションを削除できません。アプリケーションをデコミッションするには、次の手順に従います：

オフラインアプリケーションを削除します。アプリケーション管理コンソールでアプリケーションの詳細ページに移動し、オフラインアプリケーションを選択して、[Delete Application] をクリックします。

注：オフラインアプリケーションが存在しない場合、この手順は省略できます。

オンラインアプリケーションを削除します。アプリケーション管理コンソールでアプリケーションの詳細ページに移動し、オンラインアプリケーションを選択して、[Delete Application] をクリックします。
アプリケーションが「設定保留中」ステータスになったら、削除できます。

注：削除できるのは従量課金インスタンスのみです。サブスクリプションインスタンスは削除できません。

オフライン変更

アプリケーションのスキーマ (フィールドの追加または削除、インデックスの変更または追加、属性の追加または削除) を変更する場合、または データソースを変更する場合は、オフライン変更を実行する必要があります。