Opensearch数据迁移：快照迁移数据全流程（下）

#作者：stackofumbrella

使用快照迁移数据

注意事项

不要启用include_global_state: true，除非明确知道恢复集群元数据可能导致的配置冲突。
快照不能跨大版本恢复如1.x → 2.x可能失败，需先升级再迁移。
如果使用安全插件（如 OpenSearch Security），需在目标集群重建角色、用户、权限。
快照不包含Kibana索引（.kibana*）的可视化配置以外的数据，如需迁移Kibana内容，建议单独导出/导入。
确保目标集群有足够的磁盘空间和分片容量。

在源集群注册快照仓库

在配置文件中开启path.repo选项
OpenSearch默认不启用任何快照仓库需手动配置，然后重启opensearch

$ mkdir /usr/share/opensearch/opensearch-backup $ chown -R opensearch:opensearch /usr/share/opensearch/opensearch-backup $ vim opensearch.yml path.repo: ["/usr/share/opensearch/opensearch-backup"]

通过REST API注册快照仓库

# my_backup是仓库名称，可自定义 curl -X PUT -ku admin:admin "https://192.168.131.158:9201/_snapshot/my_backup" \ -H 'Content-Type: application/json' \ -d '{ "type": "fs", "settings": { "location": "/usr/share/opensearch/opensearch-backup", "compress": true } }'

返回结果

验证仓库是否注册成功

$ curl -X GET -ku admin:admin "https://192.168.131.158:9201/_snapshot/my_backup"

返回结果

在源集群创建快照文件

创建快照

创建快照是异步操作

curl -X PUT -ku admin:admin "https://192.168.131.158:9201/_snapshot/my_backup/snapshot_20251223" \ -H 'Content-Type: application/json' \ -d '{ "indices": "test,test2", # 可选，多个索引以逗号隔开，留空则备份所有索引 "ignore_unavailable": true, "include_global_state": false, # 强烈建议设为false，避免恢复时覆盖集群设置 "partial": false }'

返回结果

查看同步状态

由于测试数据较少，同步很快完成了，无法显示异步效果

curl -X GET -ku admin:admin "https://192.168.131.158:9201/_snapshot/my_backup/snapshot_20251223/_status"

返回结果

将快照数据复制到目标集群可访问位置
需手动将/usr/share/opensearch/opensearch-backup下的内容（包括index-、meta-.dat、snap-*.dat等）复制到目标集群的对应目录

$ cd /usr/share/opensearch/ $ tar -zcf opensearch-backup.tar.gz opensearch-backup $ ls -lh

然后将打包好的文件通过scp或其他方式拷贝到目标集群的某个目录下

在目标集群配置相同的快照仓库

在配置文件中开启path.repo选项，这里配置的数据目录，可以和源集群目录不一样

$ mkdir /usr/share/opensearch/opensearch-backup $ chown -R opensearch:opensearch /usr/share/opensearch/opensearch-backup $ vim opensearch.yml path.repo: ["/usr/share/opensearch/opensearch-backup"]

通过REST API注册相同名称的快照仓库

仓库名称必须与源集群一致，否则无法识别快照

curl -X PUT -ku admin:admin "https://192.168.131.158:9202/_snapshot/my_backup" \ -H 'Content-Type: application/json' \ -d '{ "type": "fs", "settings": { "location": "/usr/share/opensearch/opensearch-backup", "compress": true } }'

返回结果

验证仓库是否注册并导入成功

$ curl -X GET -ku admin:admin "https://192.168.131.158:9202/_snapshot/my_backup/_all"

返回结果

看到snapshot_20251223已经能够识别到

在目标集群恢复快照

提前打开窗口监控恢复进度

watch -n 1 curl -X GET -ku admin:admin "https://192.168.131.158:9202/_cat/recovery?v"

恢复指定索引

curl -X POST -ku admin:admin "https://192.168.131.158:9202/_snapshot/my_backup/snapshot_20251223/_restore" \ -H 'Content-Type: application/json' \ -d '{ "indices": "test,test2", "ignore_unavailable": true, "include_global_state": false, "rename_pattern": "^(.*)$", "rename_replacement": "restored_$1" # 可选：重命名避免冲突，由于目标集群为空，所以rename这两个参数不使用 }'

返回结果

同时监控状态返回结果

在dashboard中查询数据

GET test/_search { "query": { "match_all": {} } } GET test2/_search { "query": { "match_all": {} } }

可以看到迁移过来的两个索引已经和源集群有一样的数据了