Como baixe arquivos de backup do cluster - PolarDB: Central de Documentação do Alibaba Cloud

PolarDB permite baixe 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 baixe de arquivos de backup está em versão canary e será disponibilizado gradualmente.

Faturamento

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

Nota

Nenhuma taxa será cobrada se uma tarefa de baixe falhar.
No console do PolarDB, acesse Settings and Management > Backup and Restoration > Backup Download List do seu cluster para visualize o monthly backup conversion volume e o monthly outbound internet traffic.

Taxas de armazenamento

URL: Os arquivos ficam armazenados 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 disponível para essa conversão. O preço é de USD 0,03125 por GB.

Taxas de tráfego

URL:
- Baixe via rede interna: Gratuito.
- Baixe via internet: Uma cota gratuita de 500 GB por cluster por mês é fornecida. A transferência de dados que exceder a cota gratuita será cobrada no modelo de pagamento conforme o uso. As cobranças são calculadas diariamente com base na quantidade de dados baixados. Para informações sobre preços, consulte Taxas 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 baixe de backups pela internet. Quanto maior a capacidade do plano de transferência de dados, maior será 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.

Pré-requisitos

Cluster: Este recurso está disponível apenas para a Cluster Edition dos clusters da Enterprise Edition.
Região: 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, EUA (Vale do Silício), EUA (Virgínia) e Alemanha (Frankfurt).

Nota
Este recurso estará disponível em outras regiões em breve.
Outros:
- O usuário RAM deve ter permissões para baixe arquivos de backup. Para conceder permissões a um usuário RAM, consulte Permissões de usuário RAM.
- Os dados de backup não podem estar criptografados. Não é possível baixe arquivos de backup de clusters PolarDB criptografados.
- Apenas uma tarefa de baixe (em execução ou com falha) é permitida por cluster ou instância por vez.

Limitações

O processo de baixe 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 exclusivos, informações de tabelas particionadas, mecanismos 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 do sistema:

information_schema, mysql, performance_schema, sys, __recycle_bin__
Caso selecione o OSS como destino do baixe, a classe de armazenamento do bucket do OSS deve ser Standard. Para alterar a classe de armazenamento, consulte Converter classes de armazenamento.

Nota
Você deve crie manualmente um bucket do OSS. Ignore esta etapa se já tiver criado um bucket para armazenar arquivos de backup.
O baixe de dados é permitido apenas a partir de um backup de nível 1. Não é possível baixe dados de um backup de nível 2.
Se o arquivamento de dados frios estiver ativado para o cluster, não será possível baixe um conjunto de backups.
A tarefa de baixe falhará se os nomes dos bancos de dados ou tabelas a serem baixados contiverem barras (/).

Procedimento

(Recomendado) Usar o console

Faça login no console do PolarDB. No painel de navegação à esquerda, clique em Clusters. Selecione a região onde o cluster está localizado e clique em no ID do cluster para acesse a página de detalhes do cluster.
No painel de navegação à esquerda, clique em Settings and Management > Backup and Restoration.
Na aba Data Backups, localize o conjunto de backups desejado e clique em Download Cluster Backup na coluna Actions.
Nota
- Por padrão, o console exibe backups dos últimos oito dias. Para visualize backups mais antigos, altere o intervalo de tempo.
- Se o botão Download Cluster Backup não for exibido, verifique se a versão do produto ou a região do seu cluster atende aos pré-requisitos.
Na etapa Point in Time and Backup Set, selecione Download by Point in Time ou Download by Backup Set e clique em Next.

Se selecione By Backup Set, escolha um conjunto de backups de destino na lista suspensa Backup Set.
Na etapa Instance, Database, and Table, clique em Next. A opção Instance Download vem pré-selecionada e não pode ser alterada.
Na etapa Destination and Format, selecione o destino e o formato do baixe e conclua a configuração.
Importante
- Para economizar tempo, recomendamos selecione o OSS como destino do baixe.
- Não é possível cancele uma tarefa de baixe de backup após o início.
- As tarefas de baixe de backup geram cobranças. Para mais informações, consulte Faturamento.
(Recomendado) OSS

Ao selecione o OSS como destino do baixe, os dados são gravados diretamente no seu bucket do OSS. Você pode exclua os dados conforme necessário após a conclusão do baixe.
1. Insira o nome do seu bucket do OSS e um prefixo de diretório, como xx/xx.
  Nota
  
  Você deve crie manualmente um bucket do OSS. 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.
2. Selecione um formato de baixe. É possível defina o formato como CSV, SQL, Parquet ou CSV com cabeçalho. Escolha o formato de acordo com os requisitos do seu negócio.
3. 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 baixe.
  Nota
  
  O recurso de baixe de backup exige que o DBS seja autorizado a acessar seus recursos de nuvem. Se ainda não tiver concedido as permissões de acesso, siga as instruções no console e clique em Authorize > Submit. Após a autorização bem-sucedida, retorne à página de configuração avançada de baixe e insira as informações necessárias conforme descrito nas etapas anteriores.
  
  A conversão de formato consome muitos recursos. Um baixe pode falhar se os recursos do servidor estiverem temporariamente indisponíveis. Formatos de dados especiais não suportados também podem causar falhas no baixe. Em caso de falha na tarefa, tente execute a tarefa de baixe novamente ou entre em contato com o suporte técnico do DBS.
  
  Nenhuma taxa é cobrada para tarefas com falha.
4. Depois que o status da tarefa mudar para Successful, visualize o arquivo de backup no bucket do OSS correspondente.
URL

Ao selecione URL como destino do baixe, o sistema armazena temporariamente os dados convertidos no armazenamento interno do DBS. Nenhuma taxa de armazenamento é cobrada por esse processo.

Nota
O baixe via URL envolve o empacotamento de dados, o que requer tempo adicional. O tempo necessário depende do tamanho lógico do conjunto de backups. Se o conjunto de backups for grande (por exemplo, maior que 1 TB), recomendamos fazer o baixe para o OSS.
1. Selecione um formato de baixe. É possível defina o formato como CSV, SQL, Parquet ou CSV com cabeçalho. Escolha o formato de acordo com os requisitos 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 baixe.
  Nota
  
  O recurso de baixe de backup exige que o DBS seja autorizado a acessar seus recursos de nuvem. Se ainda não tiver concedido as permissões de acesso, siga as instruções no console e clique em Authorize > Submit. Após a autorização bem-sucedida, retorne à página de configuração avançada de baixe e insira as informações necessárias conforme descrito nas etapas anteriores.
  
  A conversão de formato consome muitos recursos. Um baixe pode falhar se os recursos do servidor estiverem temporariamente indisponíveis. Formatos de dados especiais não suportados também podem causar falhas no baixe. Em caso de falha na tarefa, tente execute a tarefa de baixe novamente ou entre em contato com o suporte técnico do DBS.
  
  Nenhuma taxa é cobrada para tarefas com falha.
3. Visualize o arquivo de backup: Se o status da tarefa de baixe for Successful, o baixe foi concluído. Na coluna Download Destination, clique em Generate URL, defina o Validity Period e clique em Generate URL. Em seguida, use a URL interna ou pública gerada para baixe os dados de backup.
  Nota
  
  Obtenha o link de baixe dentro de três dias após a conclusão da tarefa. O período de validade do link pode ser defina de 5 minutos a 1 dia. O período de validade padrão é de 2 horas.
  
  As tarefas concluídas expiram após três dias, momento em que o link de baixe também expira. Os dados de uma tarefa expirada são excluídos automaticamente após a expiração. Se ainda precisar dos dados, inicie uma nova tarefa de baixe para obter um novo link.
  
  Salve o link de baixe e mantenha-o confidencial para evitar vazamento de dados.
  
  O uso de ferramentas de baixe de terceiros pode gerar tráfego extra de baixe e resultar em cobranças adicionais. Utilize essas ferramentas com cautela. Para informações sobre métodos de baixe recomendados, consulte Comandos de baixe.

Usar uma API

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

Nota
Se a resposta da API indicar que o recurso não é suportado, verifique se a versão do produto e a região do seu cluster atendem aos pré-requisitos.
CreateDownload: Crie uma tarefa de baixe de arquivo de backup.
Nota
- O recurso de baixe de backup exige que você conceda as permissões AliyunDBSDefaultRole ao DBS para acessar seus recursos de nuvem. Se ainda não tiver concedido essas permissões, faça-o primeiramente pelo console.
- Quando TargetType (tipo de destino do baixe) for OSS, você deve primeiro crie manualmente o bucket de destino e garantir que sua classe de armazenamento seja Standard.
- Quando TargetType (tipo de destino do baixe) for URL, salve o TaskId (ID da tarefa) retornado para recuperar o link de baixe.
- Não é possível cancele uma tarefa de baixe de backup após o início.
- As tarefas de baixe de backup geram cobranças. Para mais informações, consulte Faturamento.
(Opcional) DescribeDownloadTask: Visualize o status e outros detalhes das tarefas de baixe de backup do seu cluster.
Obtenha o arquivo de backup:
- Se o destino do baixe for o OSS, o sistema grava os dados diretamente no seu bucket do OSS, onde você pode visualize-os.
- Se o destino do baixe for uma URL, chame a operação DescribeDownloadBackupSetStorageInfo para obter o link de baixe.
  Nota
  - Obtenha o link de baixe dentro de três dias após a conclusão da tarefa. O período de validade do link pode ser defina de 5 minutos a 1 dia. O período de validade padrão é de 2 horas.
  - As tarefas concluídas expiram após três dias, momento em que o link de baixe também expira. Os dados de uma tarefa expirada são excluídos automaticamente após a expiração. Se ainda precisar dos dados, inicie uma nova tarefa de baixe para obter um novo link.
  - Salve o link de baixe e mantenha-o confidencial para evitar vazamento de dados.
  - O uso de ferramentas de baixe de terceiros pode gerar tráfego extra de baixe e resultar em cobranças adicionais. Utilize essas ferramentas com cautela. Para informações sobre métodos de baixe recomendados, consulte Comandos de baixe.

Perguntas frequentes

Posso cancele uma tarefa de baixe de backup em andamento?

Não. Não é possível cancele uma tarefa de baixe de backup após o início.

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

Você pode restaurar os arquivos de backup baixados em um banco de dados MySQL autogerenciado.

Por que recebo o erro ERROR 1148 (42000): The used command is not allowed with this MySQL version ao restaurar um arquivo de backup baixado em um banco de dados MySQL local?

Execute a consulta show variables like 'local_infile'; no seu banco de dados MySQL. Se o resultado for OFF, execute a seguinte instrução para ative 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 mostrado no console é diferente do tamanho real do arquivo de backup baixado?

Os arquivos de backup baixados são compactados e geralmente são menores que o tamanho do backup exibido no console. Restaure o arquivo para verifique 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, você deve restaurar o arquivo de backup em um banco de dados MySQL autogerenciado e, em seguida, usar o Data Transmission Service (DTS) para migrar os dados do banco de dados MySQL autogerenciado para o PolarDB for MySQL.

Apêndice

Permissões de usuário RAM

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

Conceder permissão de baixe a usuários RAM

Se não conseguir usar o recurso de baixe de backup (por exemplo, não conseguir crie ou consultar tarefas de baixe), 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 Gerencie permissões de usuário RAM.

Bloquear links de baixe para usuários RAM

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

{
    "Version": "1",
    "Statement": [
        {
            "Effect": "Deny",
            "Action": "dbs:DescribeDownloadBackupSetStorageInfo",
            "Resource": "*"
        }
    ]
}

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

Permitir que usuários somente leitura baixe backups

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

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

Comandos de baixe

Nota

Se a velocidade de baixe for inferior a 64 KB/s, o baixe pode ser interrompido. Garanta uma conexão de rede estável durante o baixe.
Ao baixe 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. Se um arquivo de backup for maior que 100 GB, o baixe falhará. 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 baixe arquivos de backup. O uso de outras ferramentas de terceiros pode causar baixe duplicados, fazendo com que a quantidade de dados baixados seja maior que o tamanho do arquivo de backup. Você também será cobrado pela transferência excessiva de dados, pois o baixe utiliza tráfego de rede pública.

wget

nohup wget -c -t 0 "backup_file_download_URL" -O /path/to/destination_filename > /path/to/download.log &

Parâmetros

Parâmetro	Descrição
nohup	Garante que o baixe continue mesmo se o terminal for fechado ou a sessão for desconectada. O processo é encerrado automaticamente após a conclusão do baixe.
-c	Ative o baixe retomável.
-t	Especifica o número de tentativas. Se este parâmetro for defina como 0, o número de tentativas será ilimitado.
-O	Especifica o caminho de destino e o nome do arquivo para o arquivo baixado.

Exemplo

nohup wget -c -t 0 "http://dbs-xxx.aliyuncs.com/xxx.tar.gz?xxx" -O /backup/examplebackup.tar.gz > /tmp/download.log &

curl

nohup curl -C - --retry 10 "backup_file_download_URL" -o custom_filename > /path/to/download.log &

Parâmetros

Parâmetro	Descrição
nohup	Garante que o baixe continue mesmo se o terminal for fechado ou a sessão for desconectada. O processo é encerrado automaticamente após a conclusão do baixe.
-C -	Ative automaticamente o baixe retomável.
--retry	Especifica o número de tentativas. Se este parâmetro for defina como 10, o comando tentará 10 vezes.
-o	Especifica o caminho de destino e o nome do arquivo para o 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 &

Data de lançamento

Faturamento

Taxas de armazenamento

Taxas de conversão de conjunto de backups

Taxas de tráfego

Pré-requisitos

Limitações

Procedimento

(Recomendado) Usar o console

(Recomendado) OSS

URL

Usar uma API

Perguntas frequentes

Apêndice

Permissões de usuário RAM

Conceder permissão de baixe a usuários RAM

Bloquear links de baixe para usuários RAM

Permitir que usuários somente leitura baixe backups

Comandos de baixe

wget

curl