Tutorial: Restaurar um cluster de banco de dados por meio de um snapshot do cluster de banco de dados usando a AWS CLI - Amazon Aurora
Restaurar o cluster de banco de dadosCriar a instância de banco de dados primária (gravadora)

Tutorial: Restaurar um cluster de banco de dados por meio de um snapshot do cluster de banco de dados usando a AWS CLI

Neste tutorial, você vai restaurar um cluster de banco de dados por meio de um snapshot do cluster de banco de dados usando a AWS CLI. A restauração de um cluster de banco de dados de um snapshot usando a AWS CLI acontece em duas etapas:

  1. Restaurar o cluster de banco de dados usando o comando restore-db-cluster-from-snapshot

  2. Criar a instância de banco de dados primária (gravadora) usando o comando create-db-instance

Restaurar o cluster de banco de dados

Use o comando restore-db-cluster-from-snapshot. São necessárias as seguintes opções:

  • --db-cluster-identifier: o nome do cluster de banco de dados restaurado.

  • --snapshot-identifier: o nome do snapshot de banco de dados do qual deseja restaurar.

  • --engine: o mecanismo de banco de dados do cluster de banco de dados restaurado. Deve ser compatível com o mecanismo de banco de dados do cluster de banco de dados de origem.

    As opções são as seguintes:

    • aurora-mysql: compatível com Aurora MySQL 5.7 e 8.0.

    • aurora-postgresql: compatível com Aurora PostgreSQL.

    Neste exemplo, usamos aurora-mysql.

  • --engine-version: a versão do cluster de banco de dados restaurado. Neste exemplo, usamos uma versão compatível com MySQL 8.0.

O exemplo a seguir restaura um cluster de banco de dados compatível com o Aurora MySQL 8.0 chamado my-new-80-cluster de um snapshot de cluster de banco de dados denominado my-57-cluster-snapshot.

Como restaurar o cluster de banco de dados

  • Use um dos seguintes comandos.

    Para Linux, macOS ou Unix:

    aws rds restore-db-cluster-from-snapshot \
    --db-cluster-identifier my-new-80-cluster \
    --snapshot-identifier my-57-cluster-snapshot \
    --engine aurora-mysql \
    --engine-version 8.0.mysql_aurora.3.02.0

    Para Windows:

    aws rds restore-db-cluster-from-snapshot ^
    --db-cluster-identifier my-new-80-cluster ^
    --snapshot-identifier my-57-cluster-snapshot ^
    --engine aurora-mysql ^
    --engine-version 8.0.mysql_aurora.3.02.0

A saída será semelhante à seguinte.

{
    "DBCluster": {
        "AllocatedStorage": 1,
        "AvailabilityZones": [
            "eu-central-1b",
            "eu-central-1c",
            "eu-central-1a"
        ],
        "BackupRetentionPeriod": 14,
        "DatabaseName": "",
        "DBClusterIdentifier": "my-new-80-cluster",
        "DBClusterParameterGroup": "default.aurora-mysql8.0",
        "DBSubnetGroup": "default",
        "Status": "creating",
        "Endpoint": "my-new-80-cluster.cluster-############.eu-central-1.rds.amazonaws.com",
        "ReaderEndpoint": "my-new-80-cluster.cluster-ro-############.eu-central-1.rds.amazonaws.com",
        "MultiAZ": false,
        "Engine": "aurora-mysql",
        "EngineVersion": "8.0.mysql_aurora.3.02.0",
        "Port": 3306,
        "MasterUsername": "admin",
        "PreferredBackupWindow": "01:55-02:25",
        "PreferredMaintenanceWindow": "thu:21:14-thu:21:44",
        "ReadReplicaIdentifiers": [],
        "DBClusterMembers": [],
        "VpcSecurityGroups": [
            {
                "VpcSecurityGroupId": "sg-########",
                "Status": "active"
            }
        ],
        "HostedZoneId": "Z1RLNU0EXAMPLE",
        "StorageEncrypted": true,
        "KmsKeyId": "arn:aws:kms:eu-central-1:123456789012:key/#######-5ccc-49cc-8aaa-############",
        "DbClusterResourceId": "cluster-ZZ12345678ITSJUSTANEXAMPLE",
        "DBClusterArn": "arn:aws:rds:eu-central-1:123456789012:cluster:my-new-80-cluster",
        "AssociatedRoles": [],
        "IAMDatabaseAuthenticationEnabled": false,
        "ClusterCreateTime": "2022-07-05T20:45:42.171000+00:00",
        "EngineMode": "provisioned",
        "DeletionProtection": false,
        "HttpEndpointEnabled": false,
        "CopyTagsToSnapshot": false,
        "CrossAccountClone": false,
        "DomainMemberships": [],
        "TagList": []
    }
}

Criar a instância de banco de dados primária (gravadora)

Para criar a instância de banco de dados primária (gravadora), use o comando create-db-instance. São necessárias as seguintes opções:

  • --db-cluster-identifier: o nome do cluster de banco de dados restaurado.

  • --db-instance-identifier: o nome da instância de banco de dados primária.

  • --db-instance-class: o nome da classe da instância de banco de dados primária. Neste exemplo, usamos db.t3.medium.

    nota

    Recomendamos usar as classes de instância de banco de dados T somente para servidores de desenvolvimento e teste, ou outros servidores que não sejam de produção. Para obter mais detalhes sobre as classes de instâncias T, consulte Tipos de classe de instância de banco de dados.

  • --engine: o mecanismo de banco de dados da instância de banco de dados primária. Ele deve ser o mesmo mecanismo de banco de dados usado pelo cluster de banco de dados restaurado.

    As opções são as seguintes:

    • aurora-mysql: compatível com Aurora MySQL 5.7 e 8.0.

    • aurora-postgresql: compatível com Aurora PostgreSQL.

    Neste exemplo, usamos aurora-mysql.

O exemplo a seguir cria uma instância de banco de dados primária (gravadora) chamada my-new-80-cluster-instance no cluster de banco de dados restaurado compatível com o Aurora MySQL 8.0 denominado my-new-80-cluster.

Como criar a instância de banco de dados primária

  • Use um dos seguintes comandos.

    Para Linux, macOS ou Unix:

    aws rds create-db-instance \
    --db-cluster-identifier my-new-80-cluster \
    --db-instance-identifier my-new-80-cluster-instance \
    --db-instance-class db.t3.medium \
    --engine aurora-mysql

    Para Windows:

    aws rds create-db-instance ^
    --db-cluster-identifier my-new-80-cluster ^
    --db-instance-identifier my-new-80-cluster-instance ^
    --db-instance-class db.t3.medium ^
    --engine aurora-mysql

A saída será semelhante à seguinte.

{
    "DBInstance": {
        "DBInstanceIdentifier": "my-new-80-cluster-instance",
        "DBInstanceClass": "db.t3.medium",
        "Engine": "aurora-mysql",
        "DBInstanceStatus": "creating",
        "MasterUsername": "admin",
        "AllocatedStorage": 1,
        "PreferredBackupWindow": "01:55-02:25",
        "BackupRetentionPeriod": 14,
        "DBSecurityGroups": [],
        "VpcSecurityGroups": [
            {
                "VpcSecurityGroupId": "sg-########",
                "Status": "active"
            }
        ],
        "DBParameterGroups": [
            {
                "DBParameterGroupName": "default.aurora-mysql8.0",
                "ParameterApplyStatus": "in-sync"
            }
        ],
        "DBSubnetGroup": {
            "DBSubnetGroupName": "default",
            "DBSubnetGroupDescription": "default",
            "VpcId": "vpc-2305ca49",
            "SubnetGroupStatus": "Complete",
            "Subnets": [
                {
                    "SubnetIdentifier": "subnet-########",
                    "SubnetAvailabilityZone": {
                        "Name": "eu-central-1a"
                    },
                    "SubnetOutpost": {},
                    "SubnetStatus": "Active"
                },
                {
                    "SubnetIdentifier": "subnet-########",
                    "SubnetAvailabilityZone": {
                        "Name": "eu-central-1b"
                    },
                    "SubnetOutpost": {},
                    "SubnetStatus": "Active"
                },
                {
                    "SubnetIdentifier": "subnet-########",
                    "SubnetAvailabilityZone": {
                        "Name": "eu-central-1c"
                    },
                    "SubnetOutpost": {},
                    "SubnetStatus": "Active"
                }
            ]
        },
        "PreferredMaintenanceWindow": "sat:02:41-sat:03:11",
        "PendingModifiedValues": {},
        "MultiAZ": false,
        "EngineVersion": "8.0.mysql_aurora.3.02.0",
        "AutoMinorVersionUpgrade": true,
        "ReadReplicaDBInstanceIdentifiers": [],
        "LicenseModel": "general-public-license",
        "OptionGroupMemberships": [
            {
                "OptionGroupName": "default:aurora-mysql-8-0",
                "Status": "in-sync"
            }
        ],
        "PubliclyAccessible": false,
        "StorageType": "aurora",
        "DbInstancePort": 0,
        "DBClusterIdentifier": "my-new-80-cluster",
        "StorageEncrypted": true,
        "KmsKeyId": "arn:aws:kms:eu-central-1:534026745191:key/#######-5ccc-49cc-8aaa-############",
        "DbiResourceId": "db-5C6UT5PU0YETANOTHEREXAMPLE",
        "CACertificateIdentifier": "rds-ca-2019",
        "DomainMemberships": [],
        "CopyTagsToSnapshot": false,
        "MonitoringInterval": 0,
        "PromotionTier": 1,
        "DBInstanceArn": "arn:aws:rds:eu-central-1:123456789012:db:my-new-80-cluster-instance",
        "IAMDatabaseAuthenticationEnabled": false,
        "PerformanceInsightsEnabled": false,
        "DeletionProtection": false,
        "AssociatedRoles": [],
        "TagList": []
    }
}