前提条件
-
Alibaba Cloud アカウントにサインアップし、実名登録を完了します。
-
Alibaba Cloud アカウントでコンソールに初めてログインすると、アクセスキーの作成を促されます。
-
アプリケーションを作成および使用するには、アクセスキーが必要です。Alibaba Cloud アカウントのアクセスキーは空にできません。
-
Alibaba Cloud アカウントのアクセスキーを作成した後、サービスへのアクセス用に RAM ユーザーのアクセスキーも作成できます。RAM ユーザーに必要な権限を付与する方法については、「Authorization and authentication rules」をご参照ください。
-
VPC が必要です。詳細については、「VPC documentation」をご参照ください。
RAM ユーザーで Vector Search Edition インスタンスを管理するには、RAM ユーザーに AliyunSearchEngineFullAccess 権限および AliyunSearchEngineReadOnlyAccess 権限を付与する必要があります。
インスタンスの購入
-
OpenSearch コンソールに移動し、左上隅で OpenSearch - Vector Search Edition を選択します。
-
Vector Search Edition コンソールの [インスタンス管理] ページで、[インスタンスの作成] をクリックします。
-
プロダクトエディション で Vector Search Edition を選択します。リージョンを選択し、クエリノード数、クエリノードスペック、データノード数、データノードスペック、データノードあたりの合計ストレージ を設定します。VPC と vSwitch を設定します。最後に、クエリ認証用のユーザー名とパスワードを設定します(これらは Alibaba Cloud アカウントの認証情報とは別です)。その後、[今すぐ購入] をクリックします。
-
クエリノードおよびデータノードの数とスペックは、ビジネス要件に基づいて選択してください。スペックを選択すると、料金ページでコストが自動的に計算されます。
-
VPC および vSwitch は、Vector Search Edition インスタンスにアクセスする ECS インスタンスのものと一致している必要があります。一致しない場合、インスタンスへのアクセス時に
{'errors':{'code':'403','message':'Forbidden'}}エラーが発生します。 -
各データノードには無料のストレージクォータが含まれています。追加ストレージを購入することもでき、50 GB 単位で課金されます。
-
[注文の確認] ページで、サービス契約を確認します。内容に問題がなければ、[今すぐ有効化] をクリックします。
-
購入が成功したら、[管理コンソール] をクリックして、[インスタンス管理] ページで新しい Vector Search Edition インスタンスを確認します。
-
システムはデフォルト名で新しいインスタンスを作成します。名前を変更するには、[操作] 列の [管理] をクリックしてインスタンス詳細ページを開きます。
編集アイコンをクリックし、ダイアログボックスでインスタンス名を変更して、[確認] をクリックします。
クラスターの構成
新しく購入したインスタンスのステータスは、詳細ページで「構成待ち」と表示されます。システムは、購入時に指定したクエリノードおよびデータノードの数とスペックで空のクラスターを自動的にデプロイします。検索を有効にするには、次の順序でクラスターを構成する必要があります:データソースの構成 → インデックスの構成 → インデックスの再作成。
-
データソースを構成します。サポートされているデータソースには、MaxCompute データソース および API データソース があります。この例では MaxCompute データソースを使用します。[データソースの追加] をクリックし、データソースタイプ として MaxCompute を選択してから、
project、accessKeyId、accessKeySecret、Table、partitionパラメーターを設定します。また、自動フルインデックスを有効にすることもできますConfigure automatic reindexing。
検証後、[OK] をクリックしてデータソースを追加します。
-
データソースを構成したら、次へ進んで インデックススキーマ を構成します。
2.1. インデックステーブルの追加: インデックススキーマ ページで、[インデックステーブルの追加] をクリックします。
2.2. インデックステーブルの構成:
-
インデックステーブル: カスタム名を入力します。
-
データソース: 前のステップで構成したデータソースを選択します。
-
データシャード: 購入したデータノード数に基づいてシャード数を構成します。
2.3. フィールドの構成:
フィールドテーブルには、次の列が含まれます:フィールド名、フィールドタイプ、主キー、属性、属性圧縮、サマリー圧縮、サマリー範囲、アナライザ、および 詳細設定。必要に応じて各フィールドのプロパティを構成します。
属性およびフィールドコンテンツの圧縮:
-
属性フィールドの場合、圧縮はオプションであり、デフォルトで無効になっています。
file_compressorを選択して圧縮を有効にします。 -
フィールドコンテンツの場合、圧縮はオプションであり、デフォルトで無効になっています。デフォルトでは、マルチ値および STRING タイプのフィールドは
uniqを使用し、単一値の数値フィールドはequalを使用します。
-
属性圧縮を有効にする場合は、運用管理 > データノード > オンラインテーブル構成 に移動して、インデックスロード方法を編集し、パフォーマンスへの影響を軽減してください。
-
フィールドを複製できます。新しいフィールド(DUP フィールド)は、最初は元のフィールドと同じコンテンツを共有します。各フィールドに異なるコンテンツをインデックスしようとしても、元のフィールドのコンテンツが DUP フィールドのコンテンツを上書きします。DUP フィールドに異なるコンテンツをインデックスするには、その詳細設定から「copy from」設定を手動で削除する必要があります。
2.4. インデックスの構成:
インデックス設定テーブルには、次の列が含まれます:インデックス名、インデックスタイプ、含まれるフィールド、データ圧縮、詳細設定、および 操作。各インデックスの設定を表示および変更できます。
-
インデックスフィールドの場合、圧縮はオプションであり、デフォルトで無効になっています。
file_compressorを選択して圧縮を有効にします。
-
主キーインデックスは圧縮をサポートしていません。
-
インデックス圧縮を有効にする場合は、運用管理 > データノード > オンラインテーブル構成 に移動して、インデックスロード方法を編集し、パフォーマンスへの影響を軽減してください。
-
構成が完了したら、[バージョンの保存] をクリックします。表示されるダイアログボックスで備考を追加し、[公開] をクリックします。
インデックスが公開されたら、次へ進んでインデックスの再作成を開始します。
-
インデックスを再作成するには、必要なパラメーターを選択して次へ進みます。
-
API データソース:
データソース名 および 関連付けられたインデックステーブル を選択します。データソースタイプ が API データソース であることを確認してから、[次へ] をクリックします。
-
MaxCompute データソース:
データソース名 および 関連付けられたインデックステーブル を選択します。データソースタイプ が MaxCompute であることを確認します。データパーティション および タイムスタンプ パラメーターを構成してから、[次へ] をクリックします。
インデックス再作成の進捗確認
データソースおよびインデックススキーマを構成した後、O&M Center > Deployment Management でクラスタートポロジーを確認できます。
トポロジーダイアグラムには、クエリアクセス、クラスター(データノード および クエリノード を含む)、インデックステーブル、および データソース の階層的な関係が表示されます。
構成が更新された後、O&M Center > Change History > Data Source Change でインデックス再作成の進捗を追跡できます。
インデックス再作成プロセスは、init、trigger、scan、build、および switch の 5 つのステージで構成されています。各ステージが完了すると、横に緑色のチェックマークが表示されます。
インスタンス詳細ページでも、クラスターのクエリノードおよびデータノードのステータスを確認できます。すべてのステータスが正常になったら、検索テストを実行できます。
クエリノードには サービスステータス(サービス中)および 構成ステータス(構成更新済み)が表示されます。データノードにはさらに データステータス(データ更新済み)が表示されます。すべてのステータスが 100 % になると、正常な状態になります。
検索テスト
拡張機能 > 検索テスト で簡易検索を実行できます。Vector Search Edition は、HA3 句 および SQL 句 の 2 つのクエリ方法をサポートしています。
クエリ方法(例:SQL 句)を選択します。入力ボックスにクエリ(例:select * from index_a)を入力し、[検索] をクリックします。結果には、処理時間(USE_TIME)や一致した行数(ROW_COUNT)などの情報が含まれます。
-
[ドキュメント] HA3 syntax
-
[ドキュメント] SQL syntax
注意事項
-
現在、従量課金方式のみをサポートしています。
-
インスタンス購入時に設定したユーザー名およびパスワードは、インスタンス詳細ページで変更できます。
-
インスタンス購入時に、システムがクラスター名を割り当てます。この名前は現在変更できません。
-
インデックスの再作成は、プロセス中に消費されたリソースに基づいて課金されます。詳細については、「billing overview」をご参照ください。