Todos os produtos
Search
Central de documentação

PolarDB:Download backup files

Última atualização: Nov 05, 2026

PolarDB O PolarDB permite baixar arquivos de backup de um conjunto de backups do cluster para sua máquina local. Esse recurso é útil para armazenamento de longo prazo, consulta de dados históricos, transferência de backups (por exemplo, para o OSS) e auditoria.

Nota

Não é possível restaurar diretamente os dados de backup baixados em um cluster PolarDB for MySQL. No entanto, você pode restaurar os arquivos de backup baixados em um banco de dados MySQL autogerenciado.

Data de lançamento

24 de novembro de 2023

Nota

O recurso de download de arquivos de backup está em versão canary e será disponibilizado gradualmente.

Cobrança

Você pode baixar arquivos de backup via URL (armazenados temporariamente no DBS) ou transferi-los para seu OSS. As cobranças variam conforme o destino do download:

O DBS executa o download e a conversão do backup no lado do service, sem consumir espaço de armazenamento do cluster PolarDB. Os dados de backup ficam em um sistema independente, separado do armazenamento local do cluster. Portanto, não é necessário reservar armazenamento extra no cluster.

Nota
  • Nenhuma taxa será cobrada se uma tarefa de download falhar.

  • No console do PolarDB, acesse Settings and Management > Backup and Restoration > Backup Download List do seu cluster para visualizar o Month-to-date Backup Data Size e o Month-to-date Outbound Traffic over Internet.

Taxas de armazenamento

  • URL: Os arquivos ficam temporariamente no armazenamento interno do DBS. Não há cobrança de taxas de armazenamento.

  • OSS: Os arquivos são transferidos para o seu bucket do OSS. Para mais informações sobre as taxas de armazenamento do OSS, consulte Taxas de armazenamento do OSS.

Taxas de conversão de conjunto de backups

A conversão de um conjunto de backups para os formatos SQL, CSV, Parquet ou CSV com cabeçalho gera taxas de conversão, independentemente de o destino ser uma URL ou o OSS. Não há cota gratuita para essa conversão. O preço é de USD 0,03125 por GB.

nohup curl -C - --retry 10 "http://dbs-xxx.aliyuncs.com/xxx.tar.gz?xxx" -o /backup/examplebackup.tar.gz > /tmp/download.log &

Taxas de tráfego

  • URL:

    • Download via rede interna: Gratuito.

    • Download via internet: Há uma cota gratuita de 500 GB por cluster por mês. A transferência de dados que exceder essa cota será cobrada no modelo pay-as-you-go. As cobranças são calculadas diariamente com base na quantidade de dados baixados. Para informações sobre preços, consulte Taxas de tráfego de rede.

    Nota

    Recomendamos a aquisição de um plano de transferência de dados por assinatura para cobrir as taxas de tráfego de rede nos downloads de backups pela internet. Quanto maior a capacidade do plano, maior o desconto.

  • OSS: Os arquivos são transferidos para o seu bucket do OSS. Para informações sobre taxas de tráfego, consulte Taxas de tráfego do OSS.

Escopo

Limitações

  • O processo de download exporta a maioria das estruturas de tabela, mas não todas:

    • Suportado para exportação: informações de colunas, índices de chave primária, índices de chave não primária, índices únicos, informações de tabelas particionadas, engines de tabela, conjuntos de caracteres e collations no nível da tabela ou do banco de dados.

    • Não suportado para exportação: índices de expressão, chaves estrangeiras, colunas geradas, colunas ocultas, views, funções, stored procedures, variáveis de sistema e triggers.

  • As tarefas de conversão falharão se seus dados incluírem campos com os seguintes tipos de dados espaciais:

    GEOMETRY, POINT, LINESTRING, POLYGON, MULTIPOINT, MULTILINESTRING, MULTIPOLYGON, GEOMETRYCOLLECTION

  • Os arquivos exportados não incluem os seguintes bancos de dados de sistema:

    information_schema, mysql, performance_schema, sys, __recycle_bin__

  • Se você selecionar o OSS como destino de download, a classe de armazenamento do bucket do OSS deve ser Standard. Para alterar a classe de armazenamento, consulte Converter classes de armazenamento.

    Nota

    É necessário criar manualmente um bucket do OSS. Ignore esta etapa caso já tenha criado um bucket para armazenar arquivos de backup.

  • O download de dados só é possível a partir de um backup de nível 1. Dados de um backup de nível 2 não podem ser baixados.

  • Não é possível baixar um conjunto de backups se o Arquivamento de dados frios estiver ativado para o cluster.

  • A tarefa de download falhará se os nomes dos bancos de dados ou tabelas a serem baixados contiverem barras (/).

Procedimento

(Recomendado) Usar o console

  1. Faça login no console do PolarDB. No painel de navegação à esquerda, clique em Clusters. Selecione a Region onde o cluster está implantado e clique no ID do cluster para acessar a página de detalhes do cluster.

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

  3. Na aba Data Backups, localize o conjunto de backups desejado e clique em Actions na coluna Download Cluster Backup .

    Nota
    • Por padrão, o console exibe backups dos últimos oito dias. Para visualizar backups mais antigos, altere o intervalo de tempo.

    • Caso o botão Download Cluster Backup não apareça, verifique se a versão do product ou a região do seu cluster atende ao Escopo.

  4. Na etapa Point in Time and Backup Set, selecione Download by Point in Time ou Download by Backup Set e clique em Next.

    Se optar por By Backup Set, escolha o conjunto de backups desejado na lista suspensa Backup Set.

  5. Na etapa Instance, Database, and Table, clique em Next. Isso abrirá a seção Instance Download.

  6. Na etapa Destination and Format, selecione o destino e o formato de download e conclua a configuração.

    Importante
    • Para economizar tempo, recomendamos selecionar o OSS como destino de download.

    • Uma tarefa de download de backup não pode ser cancelada após o início.

    • As tarefas de download de backup geram cobranças. Para mais informações, consulte Cobrança.

    (Recomendado) OSS

    Ao selecionar o OSS como destino de download, os dados são gravados diretamente no seu bucket do OSS. Você pode excluir os dados conforme necessário após a conclusão do download.

    1. Para usar o OSS como destino de download, certifique-se de que o OSS esteja ativado e de que você tenha criado um bucket da classe Standard na mesma região do cluster PolarDB.

    2. Insira o nome do seu bucket do OSS e um prefixo de diretório, como xx/xx.

      Nota
      • É necessário criar manualmente o bucket. Caso já tenha criado um bucket para armazenar arquivos de backup, insira o nome dele diretamente.

      • A classe de armazenamento do bucket do OSS deve ser Standard. Para alterar a classe de armazenamento, consulte Converter classes de armazenamento.

    3. Selecione um formato de download. É possível definir o formato como CSV, SQL, Parquet ou CSV com cabeçalho. Escolha o formato adequado às necessidades do seu negócio.

    4. Leia e aceite os termos e clique em Complete. Você será redirecionado para a aba Backup Download List. Aguarde a conclusão da tarefa de download.

      Nota
      • O recurso de download de backup exige que o DBS seja autorizado a acessar seus recursos na cloud. Na primeira utilização, conclua a autorização do service DBS (função Authorize > Submit) e faça a verificação MFA conforme solicitado na página. Se ainda não tiver concedido as permissões de acesso, siga as instruções no console e clique em AliyunDBSDefaultRole. Após a autorização bem-sucedida, retorne à página de configuração de download avançado e insira as informações necessárias conforme descrito nas etapas anteriores.

      • A conversão de formato consome muitos recursos. O download pode falhar se os recursos do servidor estiverem temporariamente indisponíveis. Formatos de dados especiais não suportados (por exemplo, uma tabela com tipos de dados como GEOMETRY ou POINT) também podem causar falhas. Em caso de falha na tarefa, tente executar novamente o download ou entre em contato com o suporte técnico do DBS.

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

    5. Após o envio, a tarefa de download passa pelos status Resource Queuing e Running, mudando depois para Successful ou Failure. Para visualizar o arquivo de backup: se o status da tarefa for Successful, o download foi concluído. O arquivo estará disponível no bucket do OSS correspondente.

    URL

    Ao escolher URL como destino de download, o sistema armazena temporariamente os dados convertidos no armazenamento interno do DBS. Não há cobrança de taxas de armazenamento para esse processo.

    Nota

    O download via URL envolve o empacotamento de dados, o que demanda tempo adicional. Esse tempo varia conforme o tamanho lógico do conjunto de backups. Para conjuntos muito grandes (superiores a 1 TB, por exemplo), recomendamos o download para o OSS.

    1. Selecione um formato de download. É possível definir o formato como CSV, SQL, Parquet ou CSV com cabeçalho. Escolha o formato adequado às necessidades do seu negócio.

    2. Leia e aceite os termos e clique em Complete. Você será redirecionado para a aba Backup Download List. Aguarde a conclusão da tarefa de download.

      Nota
      • O recurso de download de backup exige que o DBS seja autorizado a acessar seus recursos na cloud. Na primeira utilização, conclua a autorização do service DBS (função Authorize > Submit) e faça a verificação MFA conforme solicitado na página. Se ainda não tiver concedido as permissões de acesso, siga as instruções no console e clique em AliyunDBSDefaultRole. Após a autorização bem-sucedida, retorne à página de configuração de download avançado e insira as informações necessárias conforme descrito nas etapas anteriores.

      • A conversão de formato consome muitos recursos. O download pode falhar se os recursos do servidor estiverem temporariamente indisponíveis. Formatos de dados especiais não suportados (por exemplo, uma tabela com tipos de dados como GEOMETRY ou POINT) também podem causar falhas. Em caso de falha na tarefa, tente executar novamente o download ou entre em contato com o suporte técnico do DBS.

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

    3. Após o envio, a tarefa de download passa pelos status Resource Queuing e Running, mudando depois para Successful ou Failure. Para visualizar o arquivo de backup: se o status da tarefa for Successful, o download foi concluído. No campo Download Destination, clique em Generate URL, defina o Validity Period e clique novamente em Generate URL. Em seguida, use a URL interna ou pública gerada para baixar os dados de backup.

      Nota
      • O link de download pode ser obtido dentro de três dias após a conclusão da tarefa. A validade do link pode variar de 5 minutos a 1 dia, sendo o padrão de 2 horas.

      • As tarefas concluídas expiram após três dias, momento em que o link de download também expira. Os dados de uma tarefa expirada são excluídos automaticamente. Caso ainda precise dos dados, inicie uma nova tarefa de download para obter um novo link.

      • Salve o link de download e mantenha-o confidencial para evitar vazamento de dados.

      • O uso de ferramentas de download de terceiros pode gerar tráfego extra e cobranças adicionais. Utilize essas ferramentas com cautela. Para métodos de download recomendados, consulte Comandos de download.

Usar uma API

  1. DescribeDownloadSupport: Consulta se o seu cluster suporta o recurso de download de arquivos de backup.

    Nota

    Se a resposta da API indicar que o recurso não é suportado, verifique se a versão do product e a região do seu cluster atendem ao Escopo.

  2. CreateDownload: Cria uma tarefa de download de arquivo de backup.

    Nota
    • O recurso de download de backup exige a concessão das permissões AliyunDBSDefaultRole ao DBS para acessar seus recursos na cloud. Caso ainda não tenha feito isso, conceda as permissões primeiramente pelo console.

    • Quando o TargetType (tipo de destino de download) for OSS, é necessário criar manualmente o bucket de destino e garantir que sua classe de armazenamento seja Standard.

    • Quando o TargetType (tipo de destino de download) for URL, salve o TaskId (ID da tarefa) retornado para recuperar o link de download posteriormente.

    • Uma tarefa de download de backup não pode ser cancelada após o início.

    • As tarefas de download de backup geram cobranças. Para mais informações, consulte Cobrança.

  3. (Opcional) DescribeDownloadTask: Visualize o status e outros detalhes das tarefas de download de backup do seu cluster.

  4. Obtenha o arquivo de backup:

    • Se o destino for o OSS, o sistema grava os dados diretamente no seu bucket, onde podem ser visualizados.

    • Se o destino for uma URL, chame a operação DescribeDownloadBackupSetStorageInfo para obter o link de download.

      Nota
      • O link de download pode ser obtido dentro de três dias após a conclusão da tarefa. A validade do link pode variar de 5 minutos a 1 dia, sendo o padrão de 2 horas.

      • As tarefas concluídas expiram após três dias, momento em que o link de download também expira. Os dados de uma tarefa expirada são excluídos automaticamente. Caso ainda precise dos dados, inicie uma nova tarefa de download para obter um novo link.

      • Salve o link de download e mantenha-o confidencial para evitar vazamento de dados.

      • O uso de ferramentas de download de terceiros pode gerar tráfego extra e cobranças adicionais. Utilize essas ferramentas com cautela. Para métodos de download recomendados, consulte Comandos de download.

FAQ

Posso cancelar uma tarefa de download de backup em andamento?

Não. Uma tarefa de download de backup não pode ser cancelada após o início.

Como utilizo os arquivos de backup de dados e logs baixados?

Por que recebo o erro ERROR 1148 (42000): The used command is not allowed with this MySQL version?

Execute o comando show variables like 'local_infile';. Se o resultado for OFF, execute a instrução a seguir para ativar a importação de arquivos: set global local_infile = 1;. Depois disso, execute o script de importação novamente.

Por que o tamanho do backup exibido no console difere do tamanho real do arquivo baixado?

Os arquivos de backup baixados são compactados e geralmente menores que o tamanho exibido no console. A taxa de compressão depende do tipo e do conteúdo dos dados, sem um valor fixo. Para estimar o tamanho do download antecipadamente, faça login no console do PolarDB e acesse Settings and Management > Backup and Restoration > Backup Download List do seu cluster para visualizar o monthly backup conversion volume. Restaure o arquivo para verificar se os dados estão completos.

Posso restaurar diretamente um arquivo de backup baixado em outro cluster PolarDB?

Não, não é possível restaurar diretamente um arquivo de backup baixado em outro cluster PolarDB. Primeiro, restaure o arquivo de backup em um banco de dados MySQL autogerenciado e, em seguida, utilize o Data Transmission Service (DTS) para Migrar um banco de dados MySQL autogerenciado para o PolarDB for MySQL.

Apêndice

Permissões de usuário RAM

Este recurso utiliza o RAM para gerenciar permissões. Configure essas permissões para controlar quais usuários RAM podem obter links de download.

Conceder permissão de download a usuários RAM

Se não conseguir usar o recurso de download de backup (por exemplo, não consegue criar ou consultar tarefas de download), verifique se o seu usuário RAM possui as permissões de gerenciamento para recuperação de desastres de dados (AliyunDBSFullAccess). Para mais informações sobre como conceder permissões, consulte Gerenciar permissões de usuário RAM.

Bloquear links de download para usuários RAM

Se um usuário RAM precisar de permissões para usar recursos de backup e restauração, mas não deva obter links de download de arquivos de backup, Crie uma política personalizada para negar a permissão de chamar a operação de API que recupera esses links. O script abaixo é um exemplo de política:

nohup curl -C - --retry 10 "http://dbs-xxx.aliyuncs.com/xxx.tar.gz?xxx" -o /backup/examplebackup.tar.gz > /tmp/download.log &

Após criar a política personalizada, anexe-a ao usuário RAM. Assim, o usuário ficará impedido de obter links de download.

Permitir que usuários somente leitura baixem backups

Por motivos de segurança, um usuário RAM com apenas permissões somente leitura para o PolarDB (AliyunPolardbReadOnlyAccess) não consegue baixar arquivos de backup.

Nesse caso, se o usuário RAM precisar baixar arquivos de backup, conceda a ele permissões somente leitura para recuperação de desastres de dados (AliyunDBSReadOnlyAccess). Com essa permissão, o usuário poderá visualizar links de download de tarefas de backup concluídas. Para mais informações sobre como conceder permissões, consulte Gerenciar permissões de usuário RAM.

Comandos de download

Nota
  • Se a velocidade de download cair abaixo de 64 KB/s, a transferência pode ser interrompida. Garanta uma conexão de rede estável durante o download.

  • Ao baixar arquivos de backup para um disco montado com ossfs, talvez seja necessário ajustar o parâmetro multipart_size do ossfs. Por padrão, esse parâmetro suporta arquivos de até 100 GB. Arquivos maiores que 100 GB causarão falha no download. Para mais informações sobre o ossfs e seus parâmetros, consulte ossfs e Opções de montagem.

  • Recomendamos o uso dos comandos wget e curl para baixar arquivos de backup. Outras ferramentas de terceiros podem causar downloads duplicados, resultando em um volume de dados transferidos maior que o tamanho do arquivo. Como o download utiliza tráfego de rede pública, você será cobrado pelo excesso de transferência de dados.

wget

nohup curl -C - --retry 10 "http://dbs-xxx.aliyuncs.com/xxx.tar.gz?xxx" -o /backup/examplebackup.tar.gz > /tmp/download.log &

Parâmetros

Parâmetro

Descrição

nohup

Garante que o download continue mesmo se o terminal for fechado ou a sessão desconectada. O processo encerra automaticamente após a conclusão do download.

-c

Ativa o download retomável.

-t

Especifica o número de tentativas. Se definido como 0, as tentativas são ilimitadas.

-O

Define o caminho de destino e o nome do arquivo baixado.

Exemplo

nohup curl -C - --retry 10 "http://dbs-xxx.aliyuncs.com/xxx.tar.gz?xxx" -o /backup/examplebackup.tar.gz > /tmp/download.log &

curl

nohup curl -C - --retry 10 "http://dbs-xxx.aliyuncs.com/xxx.tar.gz?xxx" -o /backup/examplebackup.tar.gz > /tmp/download.log &

Parâmetros

Parâmetro

Descrição

nohup

Garante que o download continue mesmo se o terminal for fechado ou a sessão desconectada. O processo encerra automaticamente após a conclusão do download.

-C -

Ativa automaticamente o download retomável.

--retry

Especifica o número de tentativas. Se definido como 10, o comando tentará 10 vezes.

-o

Define o caminho de destino e o nome do arquivo baixado.

Exemplo

nohup curl -C - --retry 10 "http://dbs-xxx.aliyuncs.com/xxx.tar.gz?xxx" -o /backup/examplebackup.tar.gz > /tmp/download.log &