When you need to change the schema of an existing index table — such as adding, updating, or removing fields — you must complete a three-stage workflow: edit the index schema and publish a new version, update the index configuration, then reindex. The index table remains queryable immediately after reindexing completes.
Prerequisites
Before you begin, ensure that you have:
An OpenSearch Retrieval Engine Edition application with at least one index table
The permissions required to modify index configurations and trigger reindexing
Edit the index schema
On the O&M Management page, click Change Index Table.
Find the index table to modify, then click View/Modify in the Actions column.
Make your changes in the
index_config_editversion. When done, click Save Version and publish the version. After publishing, the system generates a new version namedindex_config_v2. The version number increments by one with each publish.
Click Next.
Update the index configuration
Configure the following parameters, then click Next.
| Parameter | Description |
|---|---|
| Data Source Name | The name of the data source to use for reindexing |
| Index Table | The index table to update |
| Index Table Version | The target version of the index table |
| Dictionary Configuration Version | The version of the dictionary configuration to apply |
| Destination Cluster | The cluster where the reindexed data will be written |
Reindex
Select a data source and click Next. Choose the option that matches your reindexing scenario.
MaxCompute data source
Select MaxCompute Data Source for Data Source Type.
API data source — start from empty
Select API Data Source for Data Source Type, then select Empty Data for Data Source.
API data source — restore from existing index
Select API Data Source for Data Source Type, then select Restore Data from Index for Data Source.
If you select API Data Source, you must retain the data in the current full index version. For details, see Restore data from index. The timestamp configuration must meet the verification rules: you cannot set it to a point in time after the API data source was added.
Monitor reindexing progress
After reindexing starts, you are redirected to the Change History page. Track progress on the Data Source Changes tab.
The index table is available for online queries immediately after reindexing completes.