首页/数据/NoSQL 速查/从快照恢复 _restore
Elasticsearch89 条

从快照恢复 _restore

恢复快照时可指定索引与重命名规则,恢复到新名字避免覆盖线上数据;目标索引必须不存在或处于关闭状态,升级前可先恢复到临时索引验证。

NoSQL 速查数据更新于 2026-10-12
接口POST /_snapshot/<repo>/<snapshot>/_restore
重命名rename_pattern 正则 + rename_replacement 引用分组
前置检查GET /_snapshot/<repo>/<snapshot> 看包含哪些索引与版本

示例

示例
POST /_snapshot/my_backup/snapshot_2024-07-01/_restore?wait_for_completion=false
{
  "indices": "logs-2024.06",
  "ignore_unavailable": true,
  "include_aliases": false,
  "rename_pattern": "logs-(.+)",
  "rename_replacement": "restored-logs-$1"
}

GET /_cat/recovery?v&active_only=true
恢复到已存在的索引会失败;若必须覆盖,先 close 目标索引再指定同名恢复,或恢复成新名后走别名切换。

易错点

  • 跨大版本恢复有限制,建议先恢复到临时索引验证搜索与聚合行为
  • 恢复会触发大量分片分配,与业务写入叠加时先临时降低恢复速度上限

数据来源与参考

  • Elasticsearch Guide: Restore snapshot API
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌