Todos os produtos
Search
Central de documentação

Elasticsearch:Back up and restore data using a shared OSS repository

Última atualização: Jun 27, 2026

Um repositório OSS compartilhado permite restaurar dados de snapshots automáticos de um cluster Elasticsearch para outro na mesma região e sob a mesma conta Alibaba Cloud. O cluster de destino referencia o repositório de snapshots do cluster de origem, e a restauração dos dados ocorre mediante a execução de comandos no Kibana Dev Tools.

Adicionar uma referência de repositório OSS compartilhado

O cluster de destino só pode referenciar um repositório de um cluster de origem que execute a mesma versão do Elasticsearch ou uma versão anterior. A restauração entre versões diferentes pode falhar devido a incompatibilidades no formato dos dados. Por exemplo, o Elasticsearch 6.7.0 não oferece suporte aos índices de múltiplos tipos presentes na versão 5.5.3, o que pode causar problemas na restauração. Se tanto o cluster de origem quanto o de destino forem da Commercial Edition 6.7.0, certifique-se de que ambos executem a versão mais recente do kernel ou que a versão do kernel do cluster de destino seja superior à do cluster de origem.

  1. Faça login no console do Alibaba Cloud Elasticsearch.

  2. No painel de navegação à esquerda, clique em Elasticsearch Clusters.

  3. Na barra de menu superior, selecione um grupo de recursos e uma região.

  4. Na página Elasticsearch Clusters, clique no ID do cluster de destino.

  5. No painel de navegação à esquerda, clique em Data Backup.

  6. Na seção Shared OSS Repositories, clique em Create Now. Se esta não for a primeira referência de repositório adicionada, clique em Create Shared Repository.

  7. Na página Create Shared Repository, selecione o cluster de origem. O cluster de origem deve atender às seguintes condições: estar na mesma região do cluster de destino, pertencer à mesma conta Alibaba Cloud e executar uma versão igual ou anterior à do cluster de destino.

  8. Clique em OK. Após a criação da referência, o cluster de origem aparece na página, juntamente com o status do repositório referenciado.

    Após adicionar a referência do repositório, o cluster de destino pode entrar brevemente no estado Initializing . Durante esse período, não é possível modificar a configuração do cluster, incluindo a lista de permissões do Kibana. Aguarde o retorno do status do cluster para Normal antes de executar outras operações.

    A lista de repositórios é obtida diretamente do cluster. Se o cluster estiver em modificação, com problemas de saúde ou sob alta carga, o repositório pode ficar inacessível. Para obter os endereços de todos os repositórios, execute o comando GET _snapshot no console do Kibana do cluster de origem.

Restaurar dados de índice

Um repositório OSS compartilhado cria apenas uma referência e não restaura dados automaticamente. Para restaurar os dados, execute os comandos de restauração no console do Kibana do cluster de destino. Para mais informações, consulte Conectar-se a um cluster Elasticsearch pelo Kibana.

  1. No painel de navegação à esquerda do console do Kibana, clique em Dev Tools.

  2. Obtenha informações sobre todos os snapshots no repositório referenciado.

    No exemplo a seguir, aliyun_snapshot_from_es-cn-a é o nome do repositório referenciado. Substitua-o pelo nome real do seu repositório.

    GET /_cat/snapshots/aliyun_snapshot_from_es-cn-a?v

    A resposta lista todos os snapshots no repositório especificado.

  3. Com base no ID do snapshot obtido na etapa anterior, execute o seguinte comando para restaurar um índice específico.

    Certifique-se de que o índice especificado esteja fechado ou não exista no cluster de destino. Caso contrário, ocorrerá um erro de conflito de nome de índice durante a restauração. Restaurar um índice de sistema que comece com . pode causar falha no acesso ao Kibana. Não restaure índices de sistema.

    • Restaurar um único índice

      POST _snapshot/aliyun_snapshot_from_es-cn-a/<snapshot_id>/_restore
      {"indices": "file-2019-08-25"}
    • Restaurar vários índices

      POST _snapshot/aliyun_snapshot_from_es-cn-a/<snapshot_id>/_restore
      {"indices": "kibana_sample_data_ecommerce,kibana_sample_data_logs"}
    • Restaurar todos os índices (exceto índices de sistema)

      POST _snapshot/aliyun_snapshot_from_es-cn-a/<snapshot_id>/_restore
      {"indices":"*,-.monitoring*,-.security*,-.kibana*,-.apm*,-.ds-ilm-history-*,-.tasks","ignore_unavailable":"true"}

      O padrão de exclusão acima abrange índices de sistema comuns, mas diferentes versões de cluster podem ter índices adicionais. Ajuste a lista de exclusão conforme necessário. Execute o comando a seguir para listar os índices de sistema, que começam com ., e atualize a lista de exclusão adequadamente:

      GET _cat/indices/.*?v