クラスターをデプロイした後、その検索機能の使用を開始できます。OpenSearch Retrieval Engine Edition は、コンソールに組み込みのクエリテスト機能を提供しており、クエリのテストに役立ちます。さまざまな検索句を設定して、検索要件に基づいてクエリをカスタマイズし、テストできます。
操作手順
-
OpenSearch Retrieval Engine Edition コンソールで、[インスタンス] ページに移動します。インスタンスのリストで対象のインスタンスを見つけ、[操作] 列の [クエリテスト] をクリックします。
-
[クエリテスト] ページで、クエリタイプ ([SQL クエリ]、[Havenask クエリ]、または [REST API クエリ]) を選択します。必要に応じて句を追加できます。クエリを設定した後、[検索] をクリックして結果を表示します。
Havenask クエリ
ドロップダウンリストから [Havenask クエリ] を選択します。対応する query 文字列と clauses の入力フィールドが表示されます。Havenask クエリでは query 文が必須です。句の中の config 文と cluster 文も必須であり、デフォルトで追加されます。必要に応じて他の句を追加できます。
句セクションの右側にある [+] ボタンをクリックして、ドロップダウンメニューを開きます。このメニューから、追加する句を選択できます。選択肢には、kvpairs 句、フィルター句、pkfilter 句、aggregate 句、属性句、virtual_attribute 句、distinct 句、ソート句、レイヤー句 があります。
Havenask クエリの結果：
たとえば、クエリフィールドに id:'100532569311552725' と入力します。config 句のデフォルトは start:0,hit:10,format:json で、cluster 句のデフォルトは general です。[検索] をクリックすると、ページに完全なクエリ文と、結果数や所要時間などの結果統計が表示されます。また、id、fb_datetime、fb_boolean、fb_string など、一致したドキュメントのフィールド値も一覧表示されます。右上隅の [表示フィールド] 入力ボックスを使用して返されるフィールドの数を制御し、[URL の表示] スイッチを切り替えてリクエスト URL を表示します。
SQL クエリ
ドロップダウンリストから [SQL クエリ] を選択します。必須項目である query フィールドにクエリ文を入力し、[検索] をクリックします。
必要に応じて kvpair 句を追加できます。
sql= 入力ボックスに、select * from index_a where id = 7370577090061071286 などのクエリ文を入力します。
SQL クエリの結果：
クエリを実行すると、結果エリアの上部に query=select * from index_a &&kvpair=format:full_json のような完全なクエリ文字列が表示されます。その下には、実行時間 (USE_TIME) と行数 (ROW_COUNT) が表示されます。取得されたデータは TABLE INFO テーブルに表示されます。右上隅の [表示フィールド] 入力ボックスを使用して、表示される列数を 10 に設定するなどして制御します。[URL の表示] スイッチを切り替えて完全なリクエスト URL を表示し、[Raw] スイッチを切り替えて生の応答内容を表示します。
DATE、TIME、または TIMESTAMP データ型のフィールドからデータを取得するために SELECT 文を使用することはできません。
REST API クエリ
ドロップダウンリストから [REST API クエリ] を選択すると、[インデックステーブル] ドロップダウンリストが表示されます。左側のペインは JSON 形式のクエリを入力するためのもので、右側のペインには結果が表示されます。[インデックステーブル] ドロップダウンリストからインデックステーブルを選択し、左側の JSON 入力エリアにクエリを入力して、[検索] をクリックします。
REST API のクエリ文字列を入力し、[検索] をクリックします。結果が右側に表示されます：
この例では、index_odps インデックステーブルが選択されています。クエリは、XML 形式で一致するレコードを 1 件返します。レコードには、id、name、age、price、crate_data、get_marry などのフィールドと、それに対応する値が含まれています。
{
"query": "index_id:12"
}