Restaurar um backup em uma instância de banco de dados do Amazon RDS para MySQL

O Amazon RDS oferece suporte à importação de bancos de dados MySQL usando arquivos de backup. Você pode criar um backup do banco de dados, armazená-lo no Amazon S3 e, depois, restaurar o arquivo de backup em uma nova instância de banco de dados do Amazon RDS que executa o MySQL.

O cenário descrito nesta seção restaura um backup de um banco de dados on-premises. Você pode usar essa técnica para bancos de dados em outros locais, como o Amazon EC2 ou serviços de nuvem que não são da AWS, desde que o banco de dados esteja acessível.

Você pode localizar o cenário compatível no diagrama a seguir.

A importação de arquivos de backup do Amazon S3 é compatível com o MySQL em todas as Regiões da AWS.

Recomendamos que você importe o banco de dados para o Amazon RDS usando arquivos de backup se o banco de dados on-premises estiver offline enquanto o arquivo de backup for criado, copiado e restaurado. Se não for possível deixar o banco de dados offline, use a replicação de log binário (binlog) para atualizar o banco de dados depois de migrar para o Amazon RDS por meio do Amazon S3, conforme explicado neste tópico. Para ter mais informações, consulte Configurar a replicação da posição do arquivo de log binário com uma instância de origem externa. Também é possível usar o AWS Database Migration Service para migrar seu banco de dados para o Amazon RDS. Para ter mais informações, consulte O que é o AWS Database Migration Service?

Visão geral da configuração para importar arquivos de backup do Amazon S3 para o Amazon RDS

Estes são os componentes necessários para configurar a importação de arquivos de backup do Amazon S3 para o Amazon RDS:

Se você já tiver um bucket do Amazon S3, você pode usá-lo. Se você não tiver um bucket do Amazon S3, crie um novo. Se você quiser criar um novo bucket, consulte Criar um bucket.

Use a ferramenta Percona XtraBackup para criar seu backup. Para ter mais informações, consulte Criar o backup de banco de dados.

Se você já tiver uma função do IAM, você pode usá-la. Se você não tiver uma função do IAM, crie uma nova manualmente. Se preferir, crie uma nova função do IAM para você em sua conta por meio do assistente ao restaurar o banco de dados usando o AWS Management Console. Se você quiser criar manualmente uma nova função do IAM ou anexar políticas de confiança e de permissões a uma função do IAM existente, consulte Criação manual de uma função do IAM. Caso queira ter uma nova função do IAM criada para você, siga o procedimento em Console.

Criar o backup de banco de dados

Use o software Percona XtraBackup para criar seu backup. É recomendável utilizar a versão mais recente do Percona XtraBackup. Você pode instalar o Percona XtraBackup no Download Percona XtraBackup.

Você pode criar um backup completo de seus arquivos de banco de dados MySQL usando o Percona XtraBackup. Ou, se você já usa o Percona XtraBackup para fazer o backup dos arquivos do banco de dados MySQL, pode fazer upload dos arquivos e diretórios de backup completos e incrementais.

Para ter mais informações sobre como fazer backup de seu banco de dados com o Percona XtraBackup, consulte Percona XtraBackup - documentation e The xtrabackup binary no site da Percona.

Criar um backup completo com o Percona XtraBackup

Para criar um backup completo dos arquivos do banco de dados MySQL que podem ser restaurados a partir do Amazon S3, use o utilitário Percona XtraBackup (xtrabackup) para fazer backup do seu banco de dados.

Por exemplo, o seguinte comando cria um backup de um banco de dados MySQL e armazena os arquivos na pasta /on-premises/s3-restore/backup.

xtrabackup --backup --user=<myuser> --password=<password> --target-dir=</on-premises/s3-restore/backup>

Se você deseja compactar o backup em um único arquivo (que pode ser dividido posteriormente, se necessário), salve o backup em um dos seguintes formatos:

O comando a seguir cria um backup do seu banco de dados MySQL dividido em vários arquivos Gzip.

xtrabackup --backup --user=<myuser> --password=<password> --stream=tar \
   --target-dir=</on-premises/s3-restore/backup> | gzip - | split -d --bytes=500MB \
   - </on-premises/s3-restore/backup/backup>.tar.gz

O comando a seguir cria um backup do seu banco de dados MySQL dividido em vários arquivos tar.

xtrabackup --backup --user=<myuser> --password=<password> --stream=tar \
   --target-dir=</on-premises/s3-restore/backup> | split -d --bytes=500MB \
   - </on-premises/s3-restore/backup/backup>.tar

O comando a seguir cria um backup do seu banco de dados MySQL dividido em vários arquivos xbstream.

xtrabackup --backup --user=<myuser> --password=<password> --stream=xbstream \
   --target-dir=</on-premises/s3-restore/backup> | split -d --bytes=500MB \
   - </on-premises/s3-restore/backup/backup>.xbstream

ERROR:/bin/tar: This does not look like a tar archive

Usar backups incrementais com o Percona XtraBackup

Se você já usa o Percona XtraBackup para fazer backups completos e incrementais de seus arquivos de banco de dados MySQL, não precisa criar um backup completo e fazer upload dos arquivos de backup no Amazon S3. Em vez disso, você pode economizar muito tempo copiando os diretórios e arquivos de backup existentes no bucket do Amazon S3. Para ter mais informações sobre como criar backups incrementais usando o Percona XtraBackup, consulte Backups incrementais.

Quando copiar os arquivos existentes de backup completo e incremental para um bucket do Amazon S3, copie recursivamente o conteúdo do diretório de base. Esse conteúdo inclui o backup completo e também todo o backup incremental dos diretórios e arquivos. Essa cópia deve preservar a estrutura de diretórios no bucket do Amazon S3. O Amazon RDS percorre todos os arquivos e diretórios. O Amazon RDS usa o arquivo xtrabackup-checkpoints incluído em cada backup incremental para identificar o diretório de base e ordenar os backups incrementais por intervalo de número de sequência de log (LSN).

Considerações sobre backup para o Percona XtraBackup

O Amazon RDS consome seus arquivos de backup com base no nome do arquivo. Nomeie seus arquivos de backup com a extensão de arquivo apropriada com base no formato do arquivo, como .xbstream para arquivos armazenados usando o formato Percona xbstream.

O Amazon RDS consome os arquivos de backup em ordem alfabética assim como na ordem numérica natural. Use a opção split ao emitir o comando xtrabackup para garantir que os arquivos de backup sejam gravados e nomeados na ordem apropriada.

O Amazon RDS não oferece suporte a backups parciais criados com o Percona XtraBackup. Você não pode usar as seguintes opções para criar um backup parcial quando faz backup dos arquivos de origem de seu banco de dados: --tables, --tables-exclude, --tables-file, --databases, --databases-exclude ou --databases-file.

O Amazon RDS oferece suporte a backups incrementais criados com o Percona XtraBackup. Para ter mais informações sobre como criar backups incrementais usando o Percona XtraBackup, consulte Backups incrementais.

Criação manual de uma função do IAM

Se você não tiver um perfil do IAM, crie um novo manualmente. No entanto, se você restaurar o banco de dados usando o AWS Management Console, recomendamos que siga o procedimento em Console e deixe que o RDS crie esse perfil do IAM para você.

Para criar manualmente uma nova função do IAM para importar seu banco de dados do Amazon S3, crie uma função para delegar permissões do Amazon RDS para seu bucket do Amazon S3. Quando você cria um perfil do IAM, você anexa as políticas de confiança e permissões. Para importar os arquivos de backup do Amazon S3, use políticas de confiança e de permissões semelhantes aos exemplos a seguir. Para ter mais informações sobre como criar a função, consulte Criar uma função para delegar permissões a um AWSserviço da .

As políticas de confiança e permissões exigem que você forneça um Nome do recurso da Amazon (ARN). Para ter mais informações sobre como formatar o ARN, consulte Nomes de recurso da Amazon (ARNs) e AWS namespaces de serviço da .

{
    "Version": "2012-10-17",
    "Statement":
    [{
        "Effect": "Allow",
        "Principal": {"Service":  "rds.amazonaws.com"},
        "Action": "sts:AssumeRole"
    }]
}

{
    "Version":"2012-10-17",
    "Statement":
    [
        {
            "Sid":"AllowS3AccessRole",
            "Effect":"Allow",
            "Action":"iam:PassRole",
            "Resource":"arn:aws:iam::iam_user_id:role/S3Access"
        }
    ]
}

{
    "Version": "2012-10-17",
    "Statement":
    [
        {
        "Effect": "Allow",
        "Action":
            [
                "s3:ListBucket",
                "s3:GetBucketLocation"
            ],
        "Resource": "arn:aws:s3:::amzn-s3-demo-bucket"
        },
        {
        "Effect": "Allow",
        "Action":
            [
                "s3:GetObject"
            ],
        "Resource": "arn:aws:s3:::amzn-s3-demo-bucket/prefix*"
        },
        { // If your bucket is encrypted, include the following permission. This permission allows decryption of your AWS KMS key.
        "Effect": "Allow",
        "Action":
            [
                "kms:Decrypt"
            ],
        "Resource": [
            "arn:aws:kms:region:customer_id:key/key_id*"
            ]
        }
    ]
}

Importar dados do Amazon S3 para uma nova instância de banco de dados MySQL

Você pode importar dados do Amazon S3 para uma nova instância de banco de dados do MySQL usando o AWS Management Console, a AWS CLI ou a API do RDS.

aws rds restore-db-instance-from-s3 \
    --allocated-storage 250 \
    --db-instance-identifier myidentifier \
    --db-instance-class db.m5.large \
    --engine mysql \
    --master-username admin \
    --manage-master-user-password \
    --s3-bucket-name amzn-s3-demo-bucket \
    --s3-ingestion-role-arn arn:aws:iam::account-number:role/rolename \
    --s3-prefix bucketprefix \
    --source-engine mysql \
    --source-engine-version 8.0.32 \
    --max-allocated-storage 1000

aws rds restore-db-instance-from-s3 ^
    --allocated-storage 250 ^
    --db-instance-identifier myidentifier ^
    --db-instance-class db.m5.large ^
    --engine mysql ^
    --master-username admin ^
    --manage-master-user-password ^
    --s3-bucket-name amzn-s3-demo-bucket ^
    --s3-ingestion-role-arn arn:aws:iam::account-number:role/rolename ^
    --s3-prefix bucketprefix ^
    --source-engine mysql ^
    --source-engine-version 8.0.32 ^
    --max-allocated-storage 1000

Limitações e recomendações para importar arquivos de backup do Amazon S3 para o Amazon RDS

Veja a seguir algumas limitações e recomendações para importar arquivos de backup do Amazon S3: