All Products
Search
Document Center

OpenSearch:Migrate an application schema

Last Updated:Jul 03, 2026

You can quickly migrate an application schema from an existing application to a new instance in OpenSearch.

Notes

  • Use this method to migrate an application schema between instances in different regions, with different specifications, or of different types.

  • If the template from the source application contains a custom analyzer, you must create the same analyzer in the destination application before you import the template. Otherwise, the import fails with the error "analyzer[xxx] not support" (error code: Schema.InvalidAnalyzer).

  • This process migrates only the application schema, not the data. If the source application has a configured data source, you must re-add the data source in the new instance. If no data source is configured, you can push data to the new instance by using an API. OpenSearch does not provide a one-click data migration feature.

Procedure

  1. Log in to the Alibaba Cloud OpenSearch console and navigate to Instance Management. Find the source application in the list and click Details.

  2. On the instance details page, click Export Template to export the application configuration, including the table schema, index configuration, and data source configuration.

  3. After you export the template, your browser automatically downloads a .txt file.

  4. Return to the Instance Management page. Find the destination application in the list and click Configure.

  5. On the Configure Application page, click Import Template.

  6. In the Use Template dialog, click Upload Local File and select the downloaded .txt file.

  7. After you upload the file, you can modify the application schema. If no changes are required, click Next and then Finish.