Todos os produtos
Search

Este produto

    ApsaraDB for MongoDB:Baixar arquivos de backup

    Central de documentação

    ApsaraDB for MongoDB:Baixar arquivos de backup

    Última atualização: Jun 26, 2026

    Baixe arquivos de backup do ApsaraDB for MongoDB para uma máquina local para armazenamento de longo prazo, testes de negócios ou análise de dados. Também é possível restaurar os arquivos baixados em um banco de dados MongoDB autogerenciado.

    Precauções

    • Execute apenas uma tarefa de download por vez para cada instância. Se uma tarefa anterior ainda estiver em execução ou tiver falhado, não inicie uma nova.

    • Não cancele uma tarefa de download após o início.

    • Não restaure diretamente uma instância do ApsaraDB for MongoDB a partir de arquivos de backup baixados. Para restaurar uma instância, consulte Restauração de dados.

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

    Faturamento

    As regras de faturamento dependem do tipo de armazenamento da instância: disco em nuvem ou disco local.

    • Downloads via strings de conexão pública ou privada são gratuitos.

    • Em instâncias com disco em nuvem, há cobrança pelo tráfego de saída pela internet e pela conversão do conjunto de backup.

      Taxas de tráfego

      • Download pela rede interna: Gratuito.

      • Download pela internet: Cada instância possui cota gratuita de 500 GB por mês. O tráfego excedente é cobrado no modelo pagamento conforme o uso.

      • Início do faturamento: A cobrança começa quando o download se inicia, após a conclusão bem-sucedida da tarefa em segundo plano.

      • Economia de custos: Para downloads de grande volume, adquira um plano de rede por assinatura para reduzir custos de tráfego.

      • Download para o OSS: Ao baixar para o Object Storage Service (OSS), aplicam-se taxas adicionais do OSS. Exclua os arquivos de backup do OSS quando não forem mais necessários para evitar custos desnecessários de armazenamento.

      Taxas de conversão de conjunto de backup

      Para instâncias com disco em nuvem, cobra-se uma taxa pela conversão de backups de snapshot em arquivos BSON ao usar o recurso "download backup file". Não há cota gratuita. O padrão de faturamento é:

      Região

      Taxa de conversão (USD/GB)

      Nuvem pública

      0,03125

    Baixar backups de instâncias com disco em nuvem

    Esta seção descreve como baixar arquivos de backup de instâncias com disco em nuvem do ApsaraDB for MongoDB. Baixe esses arquivos para um bucket do Object Storage Service (OSS) ou obtenha uma URL de download.

    Aplicabilidade

    A instância deve atender a todos os requisitos abaixo:

    Requisito

    Detalhes

    Arquitetura

    Conjunto de réplicas (exceto instâncias de nó único) ou cluster fragmentado.

    Tipo de armazenamento

    Disco em nuvem ESSD.

    Status da instância

    Em execução.

    Criptografia de backup

    Os dados de backup não devem estar criptografados.

    Região

    Apenas nuvem pública. Regiões suportadas: China (Chengdu), China (Guangzhou), China (Qingdao), China (Pequim), China (Xangai), China (Zhangjiakou), China (Hangzhou), China (Shenzhen), China (Hong Kong), Malásia (Kuala Lumpur), Indonésia (Jacarta), Japão (Tóquio), Singapura, Alemanha (Frankfurt), EUA (Vale do Silício) e EUA (Virgínia).

    Permissões de usuário RAM

    Se usar um usuário RAM, ele deve ter as permissões necessárias.

    Dados suportados e não suportados

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

    Não suportado:

    • Bancos de dados de sistema admin, local e config.

    • Coleções de sistema com nomes iniciados por system..

    • Visualizações e funções.

    • Coleções de séries temporais.

    • Nomes de banco de dados ou coleção contendo barra (/) — a tarefa falhará se algum for encontrado.

    Conceder permissões a um usuário RAM

    Se usar uma conta de usuário RAM, anexe uma política personalizada com as seguintes permissões antes de iniciar uma tarefa de download.

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

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

    3. Clique em Create Policy. Na aba JSON Editor, insira o conteúdo da política abaixo e clique em OK.

      {
  "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 uma Note para a política. Confirme o conteúdo e clique em OK.

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

    6. Clique em Grant Permission e anexe a política ao usuário RAM. Para mais detalhes, consulte Conceder permissões a um usuário RAM na página de autorização.

    7. Clique em OK.

    Iniciar uma tarefa de download

    1. Acesse a página de instâncias de conjunto de réplicas do ApsaraDB for MongoDB ou de instâncias de cluster fragmentado. No canto superior esquerdo, selecione a região e o grupo de recursos e clique no ID da instância desejada.

    2. No painel de navegação à esquerda, clique em Backup and Restoration.

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

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

    5. Na etapa 2 Instance, Database, and Table, mantenha a configuração padrão (download da instância) e clique em Next.

    6. Na etapa 3 Destination and Format, escolha um destino de download.

      Destino

      Etapas

      OSS (Recomendado)

      1. Selecione OSS.

      2. Insira o nome do bucket OSS de destino e o prefixo do diretório. Apenas a classe de armazenamento Standard é suportada. Para alterar a classe de armazenamento de um bucket existente, consulte Alterar a classe de armazenamento.

      3. Em Download Format, mantenha o valor padrão BSON.

      4. Se esta for a primeira vez que usa este recurso, clique em Authorize e depois em Agree to Authorization para conceder ao ApsaraDB for MongoDB acesso ao OSS.

      URL

      1. Selecione URL.

      2. Selecione o formato de download.

      3. Após o sucesso da tarefa, gere manualmente um link de download. O link tem validade limitada.

    7. Leia e aceite os termos e clique em Complete. Você será redirecionado para a aba Backup Download List, onde poderá monitorar o status da tarefa.

    Recuperar o arquivo de backup

    Método OSS: Quando o status da tarefa mudar para Successful, o arquivo de backup aparecerá automaticamente no bucket e diretório OSS especificados.

    Método URL: Quando o status da tarefa mudar para Successful, você terá 3 dias para clicar em Generate Link na coluna Download Target. Defina um período de validade de 5 minutos a 1 dia (padrão: 2 horas). O sistema fornecerá uma URL de download interna ou pública.

    Importante

    O sistema exclui automaticamente os dados temporários quando o link expira ou após 3 dias caso nenhum link seja gerado. Para recuperar o arquivo após esse período, inicie uma nova tarefa de download.

    Downloads podem falhar devido a problemas temporários de alocação de recursos ou dados não suportados. Se uma tarefa falhar, tente novamente ou entre em contato com o suporte técnico.

    Após obter a URL de download, use wget ou curl para baixar o arquivo. Consulte Comandos de download.

    Baixar backups de instâncias com disco local

    Este procedimento aplica-se a instâncias com disco local executando MongoDB 4.2 ou versões anteriores. Backups físicos e lógicos são suportados. Backups de snapshot não são suportados.

    Se a instância não atender a esses requisitos, consulte O que fazer se sua instância não suportar downloads de backup.

    Iniciar uma tarefa de download

    1. Acesse a página de instâncias de conjunto de réplicas do ApsaraDB for MongoDB ou de instâncias de cluster fragmentado. No canto superior esquerdo, selecione a região e o grupo de recursos e clique no ID da instância desejada.

    2. No painel de navegação à esquerda, clique em Backup and Restoration.

    3. Na aba Full Backup, localize o arquivo de backup desejado e clique em Download na coluna Actions.

    4. Na caixa de diálogo Download Backup, copie a Public Connection String ou a Private Connection String.

    5. Clique em OK.

    Após obter a URL de download, use wget ou curl para baixar o arquivo. Consulte Comandos de download.

    Comandos de download

    Se a conexão de rede for instável, o download com a Public Connection String pode atingir o tempo limite. Para evitar isso, use a Private Connection String se a instância do Elastic Compute Service (ECS) e a instância do ApsaraDB for MongoDB estiverem na mesma região e conectadas via rede clássica ou na mesma virtual private cloud (VPC).

    Download no Windows ou macOS

    Cole a URL de download na barra de endereços do navegador e pressione Enter. O navegador baixará o arquivo automaticamente.

    Download no Linux

    Execute o seguinte comando:

    wget -c '<backup-file-download-url>' -O <custom-filename>.<extension>

    Parâmetro

    Descrição

    -c

    Ativa o modo de download retomável.

    -O <custom-filename>.<extension>

    Salva o arquivo com o nome especificado. O nome original do arquivo de backup pode exceder o limite de caracteres de alguns sistemas de arquivos — use -O para renomeá-lo. A extensão geralmente é _qp.xb ou .tar.gz. Use a mesma extensão presente na URL de download.
    Coloque a URL de download entre aspas simples ( ' ). Se a URL contiver caracteres especiais e não estiver entre aspas, o shell interpretará a URL incorretamente e o download falhará.

    Exemplo:

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

    Perguntas frequentes

    O que fazer se a instância não suportar downloads de backup

    Se a instância não suportar o download de arquivos de backup, use uma das abordagens abaixo conforme seu objetivo:

    Objetivo

    Solução

    Restaurar para uma nova instância do ApsaraDB for MongoDB

    Download desnecessário. Consulte Restaurar dados para uma instância do ApsaraDB for MongoDB.

    Restaurar para um banco de dados autogerenciado ou outra instância do ApsaraDB for MongoDB

    Use o Data Transmission Service (DTS) para migrar os dados. Consulte Soluções de migração para bancos de dados MongoDB autogerenciados ou instâncias do ApsaraDB for MongoDB.

    Exportar dados para armazenamento de longo prazo

    Use a ferramenta mongodump. Consulte a documentação oficial do mongodump.

    Como retomar um download interrompido

    No Linux, adicione -t 0 ao comando wget junto com -c. Isso faz o wget tentar novamente indefinidamente até concluir o download:

    wget -c -t 0 '<backup-file-download-url>' -O <custom-filename>.<extension>

    No Windows ou macOS, use a opção de retomada na página de gerenciamento de downloads do navegador.

    Erro 403 Forbidden

    Verifique se a URL de download está entre aspas simples (') no comando wget. URLs com caracteres especiais sem aspas são a causa mais comum desse erro.