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.
Présentation des tâches opérationnelles d'Amazon DocumentDB
Cette section décrit les tâches opérationnelles de votre cluster Amazon DocumentDB et explique comment accomplir ces tâches à l'aide du. AWS CLI
Rubriques
Ajouter une réplique à un cluster Amazon DocumentDB
Après avoir créé l'instance principale pour votre cluster Amazon DocumentDB, vous pouvez ajouter une ou plusieurs répliques. Un réplica est une instance en lecture seule qui a deux finalités :
-
Évolutivité — Si vous avez un grand nombre de clients nécessitant un accès simultané, vous pouvez ajouter d'autres répliques pour le dimensionnement des lectures.
-
Haute disponibilité : en cas de défaillance de l'instance principale, Amazon DocumentDB bascule automatiquement vers une instance de réplique et la désigne comme nouvelle instance principale. Si un réplica échoue, d'autres instances dans le cluster peuvent tout de même servir des demandes jusqu'à ce que le nœud en échec puisse être récupéré.
Chaque cluster Amazon DocumentDB peut prendre en charge jusqu'à 15 répliques.
Note
Pour bénéficier d'une tolérance aux pannes maximale, vous devez déployer les réplicas dans des zones de disponibilité distinctes. Cela permet de garantir que votre cluster Amazon DocumentDB peut continuer à fonctionner, même si une zone de disponibilité complète devient indisponible.
L' AWS CLI exemple suivant montre comment ajouter une nouvelle réplique. Le paramètre --availability-zone place le réplica dans la zone de disponibilité spécifiée.
aws docdb create-db-instance \ --db-instance-identifier sample-instance \ --db-cluster-identifier sample-cluster \ --engine docdb \ --db-instance-class db.r5.large \ --availability-zone us-east-1a
Décrire les clusters et les instances
L' AWS CLI exemple suivant répertorie tous les clusters Amazon DocumentDB d'une région. Pour certaines fonctionnalités de gestion telles que la gestion du cycle de vie des clusters et des instances, Amazon DocumentDB utilise une technologie opérationnelle partagée avec Amazon. RDS Le paramètre de filterName=engine,Values=docdb filtre renvoie uniquement les clusters Amazon DocumentDB.
Pour plus d'informations sur la description et la modification des clusters, veuillez consulter Cycle de vie du cluster Amazon DocumentDB.
aws docdb describe-db-clusters --filter Name=engine,Values=docdb
Le résultat de cette opération ressemble à ceci.
{
"DBClusters": [
{
"AvailabilityZones": [
"us-east-1c",
"us-east-1b",
"us-east-1a"
],
"BackupRetentionPeriod": 1,
"DBClusterIdentifier": "sample-cluster-1",
"DBClusterParameterGroup": "sample-parameter-group",
"DBSubnetGroup": "default",
"Status": "available",
...
},
{
"AvailabilityZones": [
"us-east-1c",
"us-east-1b",
"us-east-1a"
],
"BackupRetentionPeriod": 1,
"DBClusterIdentifier": "sample-cluster-2",
"DBClusterParameterGroup": "sample-parameter-group",
"DBSubnetGroup": "default",
"Status": "available",
...
},
{
"AvailabilityZones": [
"us-east-1c",
"us-east-1b",
"us-east-1a"
],
"BackupRetentionPeriod": 1,
"DBClusterIdentifier": "sample-cluster-3",
"DBClusterParameterGroup": "sample-parameter-group",
"DBSubnetGroup": "default",
"Status": "available",
...
}
]
}
L' AWS CLI exemple suivant répertorie les instances d'un cluster Amazon DocumentDB. Pour plus d'informations sur la description et la modification des clusters, veuillez consulter Cycle de vie des instances Amazon DocumentDB.
aws docdb describe-db-clusters \ --db-cluster-identifier sample-cluster \ --query 'DBClusters[*].[DBClusterMembers]'
Le résultat se présente comme suit. Il existe deux sections dans ce résultat. L'instance principale est sample-instance-1 ("IsClusterWriter": true). Il existe également une instance de réplica, sample-instance2 ("IsClusterWriter: false").
[
[
[
{
"DBInstanceIdentifier": "sample-instance-1",
"IsClusterWriter": true,
"DBClusterParameterGroupStatus": "in-sync",
"PromotionTier": 1
},
{
"DBInstanceIdentifier": "sample-cluster-2",
"IsClusterWriter": false,
"DBClusterParameterGroupStatus": "in-sync",
"PromotionTier": 1
}
]
]
]Création d'un instantané de cluster
Un instantané de cluster est une sauvegarde complète des données de votre cluster Amazon DocumentDB. Lorsque l'instantané est créé, Amazon DocumentDB lit vos données directement depuis le volume du cluster. Pour cette raison, vous pouvez créer un instantané, même aucune instance n'est exécutée à ce moment-là dans votre cluster. Le temps nécessaire à la création d'un instantané varie en fonction de la taille du volume de votre cluster.
Amazon DocumentDB prend en charge les sauvegardes automatiques, qui ont lieu tous les jours pendant la période de sauvegarde préférée, à savoir une période de 30 minutes par jour. L' AWS CLI exemple suivant montre comment afficher la fenêtre de sauvegarde de votre cluster :
aws docdb describe-db-clusters \ --db-cluster-identifier sample-cluster \ --query 'DBClusters[*].PreferredBackupWindow'
La sortie montre la fenêtre de sauvegarde (inUTC) :
[
"00:18-00:48"
]
Vous pouvez définir la fenêtre de sauvegarde lorsque vous créez votre cluster Amazon DocumentDB. Vous pouvez également modifier le créneau de sauvegarde, comme l'illustre l'exemple suivant. Si vous ne définissez pas de fenêtre de sauvegarde, Amazon DocumentDB en attribue une automatiquement à votre cluster.
aws docdb modify-db-cluster \ --db-cluster-identifier sample-cluster \ --preferred-backup-window "02:00-02:30"
Outre les sauvegardes automatiques, vous pouvez créer manuellement un instantané de cluster à tout moment. En faisant cela, vous spécifiez le cluster que vous souhaitez sauvegarder, et un nom unique pour votre instantané, afin de pouvoir restaurer à partir de ce dernier ultérieurement.
L' AWS CLI exemple suivant montre comment créer un instantané de vos données.
aws docdb create-db-cluster-snapshot \ --db-cluster-identifier sample-cluster \ --db-cluster-snapshot-identifier sample-cluster-snapshot
Restaurer à partir d'un instantané
Vous pouvez restaurer un instantané de cluster sur un nouveau cluster Amazon DocumentDB. Pour ce faire, vous fournissez le nom de l'instantané et le nom d'un nouveau cluster. Vous ne pouvez pas effectuer de restauration à partir d'un instantané vers un cluster existant ; Amazon DocumentDB crée un nouveau cluster lors de la restauration, puis le remplit avec les données de votre instantané.
L'exemple suivant montre tous les instantanés pour le cluster sample-cluster.
aws docdb describe-db-cluster-snapshots \ --db-cluster-identifier sample-cluster \ --query 'DBClusterSnapshots[*].[DBClusterSnapshotIdentifier,SnapshotType,Status]'
Le résultat se présente comme suit. Un instantané manuel est créé manuellement, tandis qu'un instantané automatique est créé par Amazon DocumentDB dans la fenêtre de sauvegarde du cluster.
[
"sample-cluster-snapshot",
"manual",
"available"
],
[
"rds:sample-cluster",
"automated",
"available"
]
]L'exemple suivant montre comment restaurer un cluster Amazon DocumentDB à partir d'un instantané.
aws docdb restore-db-cluster-from-snapshot \ --engine docdb \ --db-cluster-identifier new-sample-cluster \ --snapshot-identifier sample-cluster-snapshot
Le nouveau cluster n'a aucune instance associée. Par conséquent, si vous souhaitez interagir avec le cluster, vous devez ajouter une instance à ce dernier.
aws docdb create-db-instance \ --db-instance-identifier new-sample-instance \ --db-instance-class db.r5.large \ --engine docdb \ --db-cluster-identifier new-sample-cluster
Vous pouvez utiliser les AWS CLI opérations suivantes pour suivre la progression de la création de clusters et d'instances. Lorsque les statuts du cluster et de l'instance sont disponibles, vous pouvez vous connecter au point de terminaison du nouveau cluster et accéder à vos données.
aws docdb describe-db-clusters \ --db-cluster-identifier new-sample-cluster \ --query 'DBClusters[*].[Status,Endpoint]'
aws docdb describe-db-instances \ --db-instance-identifier new-sample-instance \ --query 'DBInstances[*].[DBInstanceStatus]'
Supprimer une instance d'un cluster
Amazon DocumentDB stocke toutes vos données dans le volume du cluster. Les données restent dans ce volume de cluster, même si vous supprimez toutes les instances de votre cluster. Si vous avez besoin d'accéder aux données à nouveau, vous pouvez ajouter une instance au cluster à tout moment, et reprendre votre activité là où vous l'aviez laissée.
L'exemple suivant montre comment supprimer une instance de votre cluster Amazon DocumentDB.
aws docdb delete-db-instance \ --db-instance-identifier sample-instance
Suppression d’un cluster
Avant de pouvoir supprimer un cluster Amazon DocumentDB, vous devez d'abord supprimer toutes ses instances. L' AWS CLI exemple suivant renvoie des informations sur les instances d'un cluster. Si cette opération renvoie des identifiants d'instance, vous devez supprimer chacune des instances. Pour de plus amples informations, veuillez consulter Supprimer une instance d'un cluster.
aws docdb describe-db-clusters \ --db-cluster-identifier sample-cluster \ --query 'DBClusters[*].DBClusterMembers[*].DBInstanceIdentifier'
Quand il ne reste plus d'instances, vous pouvez supprimer le cluster. A ce moment-là, vous devez choisir l'une des options suivantes :
-
Créer un instantané final — Capturez toutes les données du cluster dans un instantané afin de pouvoir recréer une nouvelle instance avec ces données ultérieurement. L'exemple suivant illustre la marche à suivre :
aws docdb delete-db-cluster \ --db-cluster-identifier sample-cluster \ --final-db-snapshot-identifier sample-cluster-snapshot -
Ignorer l'instantané final : supprimez définitivement toutes les données du cluster. Cette opération ne peut pas être annulée. L'exemple suivant illustre la marche à suivre :
aws docdb delete-db-cluster \ --db-cluster-identifier sample-cluster \ --skip-final-snapshot
