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.
# Didacticiel : Restauration d’un cluster de bases de données à partir d’un instantané de cluster de bases de données, à l’aide de l’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. Pour restaurer un cluster de bases de données à partir d’un instantané avec la AWS CLI, suivez les deux étapes suivantes :
1. [Restauration du cluster de bases de données](#tut-restore-cluster.CLI.restore) à l’aide de la commande [restore-db-cluster-from-snapshot](https://docs.aws.amazon.com/cli/latest/reference/rds/restore-db-cluster-from-snapshot.html)
1. [Création de l’instance de base de données principale (écriture)](#tut-restore-cluster.CLI.create) à l’aide de la commande [create-db-instance](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-instance.html)
## 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 compatible avec MySQL-8.0.
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](Concepts.DBInstanceClass.Types.md).
+ `--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": []
}
}
```