Todos os produtos
Search
Central de documentação

ApsaraDB for MongoDB:Baixar arquivos de backup

Última atualização: Jul 31, 2026

Baixe os arquivos de backup do ApsaraDB for MongoDB para uma máquina local para armazenamento de longo prazo ou restaure-os em um banco de dados autogerenciado para testes de negócios ou análise de dados.

Antes de começar

  • Tarefas com falha não geram cobrança.

  • Não é possível cancelar uma tarefa de download de backup após o início da execução.

  • Apenas uma tarefa de download (em execução ou com falha) é permitida por cluster ou instância por vez.

  • Não é possível restaurar diretamente uma instância do ApsaraDB for MongoDB a partir de um arquivo de backup baixado. Para restaurar uma instância, consulte Restore an instance from a backup file.

Faturamento

  • Para instâncias com discos locais, o download de arquivos de backup por meio de uma Public Connection String ou de uma Private Connection String é gratuito.

  • Para instâncias com discos cloud, o download de backups gera custos de tráfego de saída pela internet e de computação de dados de backup.

    Taxas de tráfego

    • Download pela rede interna: Gratuito.

    • Download pela internet: Cada instância possui uma cota gratuita de 500 GB por mês. O tráfego excedente é cobrado no modelo pagamento conforme o uso. Visualize o volume de tráfego baixado na página de informações básicas da sua instância do ApsaraDB for MongoDB. Para mais detalhes sobre preços, consulte .

    • Momento da cobrança: A cobrança inicia quando o download efetivo começa, após o sucesso da tarefa de backend.

    • Economia de custos: Para downloads de grande volume, considere adquirir uma network plan por assinatura para compensar os custos de tráfego.

    • Download para OSS: OSS fees adicionais se aplicam. Para evitar cobranças contínuas de armazenamento, exclua manualmente esses arquivos quando não forem mais necessários.

    Taxas de computação de dados de backup

    Ao baixar arquivos de backup de uma instância com disco cloud, os backups de snapshot são convertidos em arquivos BSON, o que gera custos de computação de dados. Não há cota gratuita disponível. O padrão de cobrança é o seguinte:

    Região

    Taxa de computação de dados (USD/GB)

    Nuvem pública

    0,03125

    Nota

    Se a tarefa de conversão de dados falhar, nenhuma taxa de computação de dados de backup será cobrada.

Baixar backups de instâncias com disco cloud

Pré-requisitos

Sua instância do ApsaraDB for MongoDB deve atender aos seguintes requisitos:

  • Arquitetura: replica set (excluindo instâncias de nó único) ou sharded cluster.

  • Tipo de armazenamento: Disco cloud ESSD.

  • Status: Running.

  • Região: A instância deve estar em uma das regiões de nuvem pública suportadas: China (Chengdu), China (Guangzhou), China (Qingdao), China (Beijing), China (Shanghai), China (Zhangjiakou), China (Hangzhou), China (Shenzhen), China (Hong Kong), Malaysia (Kuala Lumpur), Indonesia (Jakarta), Japan (Tokyo), Singapore, Germany (Frankfurt), US (Silicon Valley) ou US (Virginia).

  • Os dados de backup não estão criptografados.

  • Caso utilize um usuário RAM, garanta que ele tenha as permissões necessárias para baixar arquivos de backup.

    Como conceder permissões a um usuário RAM

    1. Faça login no console RAM usando sua conta Alibaba Cloud.

    2. No painel de navegação à esquerda, escolha Permissions > Policies.

    3. Clique em Create Policy. Na aba JSON Editor, insira a política abaixo e clique em Confirm.

      {
        "Statement": [
          {
            "Effect": "Allow",
            "Action": "dds:Describe*",
            "Resource": "*"
          },
          {
            "Effect": "Allow",
            "Action": [
              "dbs:CreateDownload",
              "dbs:DescribeDBInstanceDownloadSize",
              "dbs:DescribeDownloadSupport"
            ],
            "Resource": "*"
          }
        ],
        "Version": "1"
      }
    4. Na caixa de diálogo Create Policy, insira um Name e Remarks para a política. Confirme o conteúdo da política e clique em Confirm novamente.

    5. No painel de navegação à esquerda, escolha Permissions > Authorize.

    6. Clique em Grant Permission e anexe a política criada ao usuário RAM. Para mais informações, consulte Grant permissions to a RAM user on the Authorization page.

    7. Clique em OK.

Dados suportados e não suportados

  • Não suportado:

    • Os bancos de dados do sistema admin, local e config.

    • Coleções do sistema cujos nomes começam com system..

    • Views e funções.

    • Coleções de séries temporais.

    • A tarefa de download falhará se os nomes do banco de dados ou da coleção contiverem barras (/).

  • Suportado: Coleções que não sejam de séries temporais e informações de índice.

Procedimento

  1. Acesse a lista de backups

    1. Acesse a página de Instâncias de Replica Set do ApsaraDB for MongoDB ou a página de Instâncias de Sharded Cluster do ApsaraDB for MongoDB. Selecione o grupo de recursos e a região e clique no ID da instância desejada.

    2. No painel de navegação à esquerda da página da instância, clique em Backup and Restoration.

    3. Na aba Backup Download List, clique em Download Instance Backup File.

  2. Inicie uma tarefa de download: Na aba Backup Download, clique em Download Instance Backup File.

  3. Configure os parâmetros para download do backup da instância

    1. Na etapa Point in Time and Backup Set, selecione um Backup Set para baixar e clique em Next.

    2. Na etapa Instance, Database, and Table, mantenha as configurações padrão para baixar o backup da instância e clique em Next.

    3. Na etapa Destination and Format, configure o destino e o formato do download.

      Destino

      Configuração

      OSS (Recomendado)

      1. Selecione Write data to your OSS.

      2. Insira o nome do bucket e o prefixo do diretório do bucket OSS de destino.

        Apenas a classe de armazenamento Standard é suportada para OSS. Para alterar a classe de armazenamento, consulte Convert storage classes.

      3. Selecione um Download Format. O formato padrão é BSON.

      4. Se esta for a primeira vez que você usa este recurso, clique em Go to Authorize > Agree to Authorization conforme solicitado para conceder ao ApsaraDB for MongoDB permissões de acesso ao OSS.

      URL

      1. Selecione URL.

      2. Escolha um formato de download.

      3. Após o sucesso da tarefa, gere manualmente um link de download. O link é válido por um período limitado.

  4. Confirme e execute a tarefa: Leia e concorde com os termos e clique em Complete. Você será redirecionado para a aba Backup Download List, onde poderá monitorar o status da tarefa.

  5. Obtenha o arquivo de backup

    • Método OSS: Aguarde até que o status da tarefa mude para Successful. O arquivo é armazenado automaticamente no bucket e diretório OSS especificados.

    • Método URL: Após o status da tarefa mudar para Successful, clique em Generate Link na coluna Destination dentro do período de validade de 3 dias. Defina um período de validade do link (de 5 minutos a 1 dia; o padrão é 2 horas) para obter a URL de download. Quando a tarefa e o link expirarem, os dados temporários serão excluídos automaticamente e será necessário iniciar uma nova tarefa de download.

    Importante

    As tarefas de download podem falhar devido a problemas temporários de alocação de recursos durante a conversão de dados ou formatos de dados não suportados. Se uma tarefa falhar, tente novamente ou entre em contato com a equipe de suporte técnico de Recuperação de Desastres de Dados.

  6. Use uma ferramenta de linha de comando para baixar o arquivo

    Após obter a URL:

    • Recomendamos o uso de uma ferramenta de linha de comando, como wget ou curl, para baixar o arquivo. Para mais informações, consulte Appendix 1: Download commands neste tópico.

    • Para arquivos pequenos, copie a URL da internet para a barra de endereços de um navegador e baixe o arquivo.

Baixar backups de instâncias com disco local

Pré-requisitos

  1. O download de arquivos de backup é permitido apenas para instâncias com disco local executando MongoDB 4.2 ou anterior.

  2. Apenas arquivos de Physical Backup e Logical Backup podem ser baixados. Backups do tipo Snapshot Backup não podem ser baixados. Para baixar arquivos de backup de outras instâncias, consulte What do I do if my instance does not support backup file downloads?.

Procedimento

  1. Acesse a lista de backups

    1. Acesse a página de Instâncias de Replica Set do ApsaraDB for MongoDB ou a página de Instâncias de Sharded Cluster do ApsaraDB for MongoDB. Selecione o grupo de recursos e a região e clique no ID da instância desejada.

    2. No painel de navegação à esquerda da página da instância, clique em Backup and Restoration.

  2. Inicie uma tarefa de download

    1. Na aba Full Backup, localize o arquivo de backup que deseja baixar e clique em Download na coluna Actions.

    2. Na caixa de diálogo Download Backup, Copy e anote a Public Connection String ou a Private Connection String conforme necessário.

    3. Clique em Confirm.

  3. Use uma ferramenta de linha de comando para baixar o arquivo

    Após obter a URL:

    • Recomendamos o uso de uma ferramenta de linha de comando, como wget ou curl, para baixar o arquivo. Para mais informações, consulte Appendix 1: Download commands neste tópico.

    • Para arquivos pequenos, copie a URL da internet para a barra de endereços de um navegador e baixe o arquivo.

Apêndice 1: Comandos de download

Nota

Se sua conexão de rede for instável, o download via Public Connection String pode atingir o tempo limite. Para resolver esse problema:

  • Se sua instância ECS e a instância do ApsaraDB for MongoDB estiverem na mesma região e ambas usarem a rede clássica, ou estiverem na mesma VPC (com o mesmo ID de VPC), baixe o arquivo de backup para a instância ECS através da Private Connection String.

  • Utilize um cliente que suporte downloads retomáveis. No Linux, use o comando wget mostrado abaixo.

Download no Windows ou macOS

Cole a URL de download na barra de endereços do seu navegador e pressione Enter para baixar o arquivo de backup.

Download no Linux

Execute o seguinte comando para baixar um arquivo de backup:

wget -c '<Download URL of the backup file>' -O <Custom filename><Suffix>

Parâmetros:

  • -c: habilita o modo de download retomável.

  • -O: salva o arquivo baixado com o nome especificado.

  • <Suffix>: A extensão do arquivo é tipicamente _qp.xb ou .tar.gz. Certifique-se de que a extensão seja a mesma presente na URL de download.

Exemplo:

wget -c 'http://rdsbak-hz-v3.oss-cn-hangzhou-internal.aliyuncs.com/custins5475****/hins1907****_data_20210906103710_qp.xb?Expires=......' -O backupfile._qp.xb

Perguntas frequentes

Downloads de backup não suportados

Se sua instância não suportar o download de arquivos de backup, considere estas alternativas:

Downloads interrompidos

No Linux, adicione o parâmetro -t 0 ao comando wget juntamente com o parâmetro -c. Se o download for interrompido, o wget tentará novamente indefinidamente e retomará o download. No Windows e macOS, geralmente é possível retomar o download a partir da página de gerenciamento de downloads do seu navegador.

Erro 403 Forbidden

Verifique se o comando de download está correto. Coloque a URL de download entre aspas simples (').

Como baixo dados de uma instância expirada ou bloqueada?

Quando uma instância por assinatura expira, ela é bloqueada e não é possível conectar-se ao banco de dados. Para baixar dados da instância, renove-a primeiro e depois use um dos seguintes métodos:

  • Use o utilitário mongodump para conectar-se à instância e baixar os dados. O mongodump funciona com todos os tipos de instância. Para mais informações, consulte mongodump.

  • Use o recurso de download de backup descrito neste tópico. Este recurso está disponível apenas para instâncias de replica set e sharded cluster baseadas em ESSD. Para mais informações, consulte Escopo de aplicação acima.