View a markdown version of this page

Tutoriel : Restauration d'un cluster de base de données à partir d'un instantané de cluster de base de données à l'aide du AWS CLI - Amazon Aurora
Restauration du cluster de bases de donnéesCréation de l’instance de base de données principale (écriture)

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Tutoriel : Restauration d'un cluster de base de données à partir d'un instantané de cluster de base de données à l'aide du AWS CLI

Dans ce didacticiel, vous restaurez un cluster de bases de données à partir d’un instantané de clusters de bases de données, à l’aide de l’ AWS CLI. La restauration d'un cluster de base de données à partir d'un instantané à l'aide de la procédure AWS CLI comporte deux étapes :

  1. Restauration du cluster de bases de données à l’aide de la commande restore-db-cluster-from-snapshot

  2. Création de l’instance de base de données principale (écriture) à l’aide de la commande create-db-instance

Restauration du cluster de bases de données

Vous utilisez la commande restore-db-cluster-from-snapshot. Les options suivantes sont requises :

  • --db-cluster-identifier : le nom du cluster de bases de données restauré.

  • --snapshot-identifier : le nom de l’instantané de la base depuis lequel effectuer la restauration.

  • --engine : le moteur de base de données du cluster de bases de données restauré. Il doit être compatible avec le moteur de base de données du cluster de bases de données source.

    Les choix sont les suivants :

    • aurora-mysql : Aurora compatible avec MySQL 5.7 et 8.0.

    • aurora-postgresql : compatible avec Aurora PostgreSQL.

    Dans cet exemple, nous utilisons aurora-mysql.

  • --engine-version : la version de la base de données restaurée. Dans cet exemple, nous utilisons une version MySQL-8.0 compatible.

L’exemple suivant restaure un cluster de bases de données compatible avec Aurora MySQL 8.0 nommé my-new-80-cluster à partir d’un instantané de cluster de bases de données nommé my-57-cluster-snapshot.

Pour restaurer le cluster de bases de données

  • Utilisez l’une des commandes suivantes.

    Pour 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

    Pour 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

La sortie se présente comme suit :

{
    "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": []
    }
}

Création de l’instance de base de données principale (écriture)

Pour créer l’instance de base de données principale (écriture), vous utilisez la commande create-db-instance. Les options suivantes sont requises :

  • --db-cluster-identifier : le nom du cluster de bases de données restauré.

  • --db-instance-identifier : le nom de l’instance principale de la base de données.

  • --db-instance-class : la classe d’instance de l’instance principale de la base de données. Dans cet exemple, nous utilisons db.t3.medium.

    Note

    Nous recommandons d’utiliser les classes d’instance de base de données T uniquement pour les serveurs de développement et de test, ou pour d’autres serveurs non dédiés à la production. Pour plus de détails sur les classes d’instance T, consultez Types de classes d’instance de base de données.

  • --engine : le moteur de base de données de l’instance de base de données principale. Il doit s’agir du même moteur de base de données que celui utilisé par le cluster de bases de données restauré.

    Les choix sont les suivants :

    • aurora-mysql : Aurora compatible avec MySQL 5.7 et 8.0.

    • aurora-postgresql : compatible avec Aurora PostgreSQL.

    Dans cet exemple, nous utilisons aurora-mysql.

L’exemple suivant crée une instance de base de données principale (écriture) nommée my-new-80-cluster-instance dans le cluster de bases de données compatible avec Aurora MySQL 8.0 restauré nommé my-new-80-cluster.

Pour créer l’instance de base de données principale

  • Utilisez l’une des commandes suivantes.

    Pour 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

    Pour 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

La sortie se présente comme suit :

{
    "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": []
    }
}