Use Modify Offline Application to change the data source of an application or update its schema—including creating or deleting fields, modifying or creating indexes, creating or deleting attribute fields, and creating or deleting default display fields.
Changes are applied to the offline version only. The online version continues serving traffic while you modify and build the offline version.
How it works
OpenSearch maintains two separate versions of an application:
Online version: the live version that serves search traffic
Offline version: a staging version where you apply schema and data source changes
When you run Modify Offline Application, OpenSearch creates or updates the offline version without affecting the online version. After you verify the offline version, publish it to replace the online version.
Note: Incremental data pushed to the online application via API is not synchronized to the offline application while the offline application is being created.
Prerequisites
Before you begin, ensure that you have:
Access to the OpenSearch Industry Algorithm Edition console
An existing application instance
Modify an offline application
Step 1: Open the application details
In the OpenSearch Industry Algorithm Edition console, go to the Instance Management page.
Find the target application instance and click Details in the Actions column.
Step 2: Start the modification
On the Online Application tab of the Application Details page, click Modify Offline Application.
What happens next depends on whether an offline version already exists:
| Scenario | Behavior |
|---|---|
| No offline version exists | The Modify Application page opens directly. After you save your changes, an offline version is created and coexists with the online version. |
| An offline version already exists | The Modify Offline Application page opens, showing the current offline version details. Click Configure to open the Modify Application page. After you confirm your changes, the previous offline version is deleted and a new offline version is created. |
Step 3: Modify the schema
On the Modify Application page, update the application configuration as needed:
Edit fields
Note: Industry Algorithm Edition applications support adding tables. Standard type applications only support non-partitioned tables.
Edit indexes, attribute fields, or default display fields
Edit the data source and mapping
Step 4: Modify the sorting of search results
Step 5: Modify the query analysis
Step 6: Configure data sync and publishing
After you finish your changes, specify how incremental data sync and publishing are handled.
Incremental data sync
You may choose not to synchronize incremental data; instead, push full data to the offline application by synchronizing the data source or calling API operations.
Auto-publish
If auto-publish is enabled, the offline version is published to the online environment automatically after the build completes. If you turn this off, go to the Offline Application tab of the Application Details page and click Publish to publish manually.
Usage notes
Modifying the offline version does not affect the online version. To change the online version directly, delete the offline version first.
Invalid online version: If the online version is in the Invalid state, delete the application and reconfigure it from scratch.