Use the Query Test tool in the Retrieval Engine Edition console to send test queries against a deployed cluster and inspect the results. The tool supports three query types — SQL, HA3, and REST API — so you can validate index content and search behavior before releasing to production.
Prerequisites
Before you begin, ensure that you have:
A successfully deployed cluster
Get to the Query Test page
In the Retrieval Engine Edition console, go to Instance management > Management > Feature extension > Query test.
Run a query
From the Query test dropdown, select a query type, fill in the required fields, and click Search. Results appear in the panel below.
HA3 query
Select HA3 from the dropdown. The following fields appear:
| Field | Required | Description |
|---|---|---|
| Query string | Yes | The HA3 query expression |
| Clause | Yes | Additional HA3 clauses to include |
| config statement | Auto-included | Controls query configuration; added automatically |
| cluster statement | Auto-included | Specifies the target cluster; added automatically |
You do not need to add the config statement or cluster statement manually — the platform includes them by default. Add other clauses as needed.
SQL query
Select SQL from the dropdown, enter your SQL query statement, and click Search.
| Field | Required | Description |
|---|---|---|
| Query statement | Yes | A valid SQL query |
| kvpair clause | No | An optional key-value pair clause |
Fields of type date, time, and timestamp cannot be retrieved using SELECT SQL statements.
REST API query
Select RESTAPI query from the dropdown. Fill in the following fields and click Search. Results appear on the right side of the page.
| Field | Required | Description |
|---|---|---|
| Index table | Yes | The index table to query |
| Query statement | Yes | A JSON query body, entered in the left input box |
Example:
{
"query": "index_id:12"
}Interpret results
The result panel displays the search results. Review the response to verify that the returned documents match your expected results.