tencent cloud

PrevNext

文档反馈

请输入关键字

Recent Pages

文档
Elasticsearch Service
    文档
    Download PDF

    使用 COS 进行备份及恢复

    最后更新时间：2024-12-03 15:47:58
    下载PDF

      创建仓库

      您可以通过如下命令创建仓库：
      PUT _snapshot/my_cos_backup
      {
          "type": "cos",
          "settings": {
              "app_id": "xxxxxxx",
              "access_key_id": "xxxxxx",
              "access_key_secret": "xxxxxxx",
              "bucket": "xxxxxx",
              "region": "ap-guangzhou",
              "compress": true,
              "chunk_size": "500mb",
              "base_path": "/"
          }
      }
      app_id：腾讯云账号 APPID。
      access_key_id：腾讯云 API 密钥 SecretId。
      access_key_secret：腾讯云 API 密钥 SecretKey。
      bucket：COS Bucket 名字，名字不能带-{appId}后缀。
      region：COS Bucket 地域，此地域必须与 ES 集群为同一地域。地域编码可参考 地域和可用区。
      compress：默认为 true，对索引元数据存储进行压缩。
      base_path：备份目录。

      列出仓库信息

      您可通过GET _snapshot获取仓库信息，也可使用GET _snapshot/my_cos_backup获取指定的仓库信息。

      创建快照备份

      备份所有索引

      将 ES 集群内所有索引备份到my_cos_backup仓库下，并命名为snapshot_1。
      PUT _snapshot/my_cos_backup/snapshot_1
      这个命令会立刻返回，并在后台异步执行直到结束。如果希望创建快照命令阻塞执行，可以添加wait_for_completion参数。命令执行的时间与索引大小相关。
      PUT _snapshot/my_cos_backup/snapshot_1?wait_for_completion=true

      备份指定索引

      您可以在创建快照的时候指定要备份的索引。参数 indices 的值为多个索引的时候，需要用,隔开且不能有空格。
      PUT _snapshot/my_cos_backup/snapshot_2
      {
          "indices": "index_1,index_2"
      }

      查询快照

      查询单个快照信息：
      GET _snapshot/my_cos_backup/snapshot_1
      该命令会返回快照的相关信息：
      说明：
      当信息中的 state 字段为SUCCESS 时，说明快照备份完成。
      {
          "snapshots": [
              {
                  "snapshot": "snapshot_1",
                  "uuid": "zUSugNiGR-OzH0CCcgcLmQ",
                  "version_id": 5060499,
                  "version": "5.6.4",
                  "indices": [
                      "index_1",
                      "index_2"
                  ],
                  "state": "SUCCESS",
                  "start_time": "2018-05-04T11:44:15.975Z",
                  "start_time_in_millis": 1525434255975,
                  "end_time": "2018-05-04T11:45:29.395Z",
                  "end_time_in_millis": 1525434329395,
                  "duration_in_millis": 73420,
                  "failures": [],
                  "shards": {
                      "total": 3,
                      "failed": 0,
                      "successful": 3
                  }
              }
          ]
      }

      删除快照

      删除指定的快照：
      DELETE _snapshot/my_cos_backup/snapshot_1
      注意：
      如果存在还未完成的快照，删除快照命令依旧会执行，并取消未完成快照的创建进程。

      从快照恢复

      1. 将快照中备份的所有索引都恢复到 ES 集群中。
      POST _snapshot/my_cos_backup/snapshot_1/_restore
      如果 snapshot_1 包括5个索引，则这5个索引都会被恢复到 ES 集群中。
      您还可以使用附加的选项对索引进行重命名。该选项允许您通过模式匹配索引名称，并通过恢复进程提供一个新名称。如果您想在不替换现有数据的前提下，恢复旧数据来验证内容或进行其他操作，则可以使用该选项。
      2. 从快照里恢复单个索引并提供一个替换的名称。
      POST /_snapshot/my_cos_backup/snapshot_1/_restore
      {
       "indices": "index_1",
       "rename_pattern": "index_(.+)",
       "rename_replacement": "restored_index_$1"
      }
      indices：只恢复 index_1 索引，忽略快照中存在的其他索引。
      rename_pattern：查找所提供的模式能匹配上的正在恢复的索引。
      rename_replacement：将匹配的索引重命名成替代的模式。

      查询快照恢复状态

      可通过执行_recovery命令，查看快照恢复的状态并监控快照恢复的进度。
      1. 您可以在恢复的指定索引中单独调用下述 API。
      GET index_1/_recovery
      2. 该命令会返回指定索引各分片的恢复状况。
      {
       "sonested": {
           "shards": [
               {
                   "id": 1,
                   "type": "SNAPSHOT",
                   "stage": "INDEX",
                   "primary": true,
                   "start_time_in_millis": 1525766148333,
                   "total_time_in_millis": 8718,
                   "source": {
                       "repository": "my_cos_backup",
                       "snapshot": "snapshot",
                       "version": "5.6.4",
                       "index": "index_1"
                   },
                   "target": {
                       "id": "TlzmxJHwSqyv4rhyQfRkow",
                       "host": "10.0.0.6",
                       "transport_address": "10.0.0.6:9300",
                       "ip": "10.0.0.6",
                       "name": "node-1"
                   },
                   "index": {
                       "size": {
                           "total_in_bytes": 1374967573,
                           "reused_in_bytes": 0,
                           "recovered_in_bytes": 160467084,
                           "percent": "11.7%"
                       },
                       "files": {
                           "total": 132,
                           "reused": 0,
                           "recovered": 20,
                           "percent": "15.2%"
                       },
                       "total_time_in_millis": 8716,
                       "source_throttle_time_in_millis": 0,
                       "target_throttle_time_in_millis": 0
                   },
                   "translog": {
                       "recovered": 0,
                       "total": 0,
                       "percent": "100.0%",
                       "total_on_start": 0,
                       "total_time_in_millis": 0
                   },
                   "verify_index": {
                       "check_index_time_in_millis": 0,
                       "total_time_in_millis": 0
                   }
               }
           ]
       }
      }
      type：描述恢复的本质，该分片是在从一个快照恢复。
      source：哈希描述作为恢复来源的特定快照和仓库。
      percent：描述恢复的状态。该特定分片目前已经恢复了94%的文件，即将全部恢复。
      输出会列出所有目前正在恢复的索引，以及这些索引里的所有分片。每个分片里会有启动/停止时间、持续时间、恢复百分比、传输字节数等统计值。

      取消快照恢复

      DELETE /restored_index_1
      如果 restored_index_1 正在恢复中，则该删除命令会停止恢复，同时删除所有已经恢复到集群中的数据。
      联系我们

      联系我们，为您的业务提供专属服务。

      联系我们
      技术支持

      如果你想寻求进一步的帮助，通过工单与我们进行联络。我们提供7x24的工单服务。

      提交工单
      7x24 电话支持
      Copyright © 2013-2024 Tencent Cloud. All Rights Reserved.
      隐私条款服务条款缓存条款