Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Dieser Abschnitt behandelt betriebliche Aufgaben für Ihren Amazon DocumentDB-Cluster und wie Sie diese Aufgaben mit dem AWS CLI erledigen können.
Themen
Hinzufügen eines Replikats zu einem Amazon DocumentDB-Cluster
Nachdem Sie die primäre Instance für Ihren Amazon DocumentDB-Cluster erstellt haben, können Sie ein oder mehrere Replikate hinzufügen. Ein Replikat ist eine schreibgeschützte Instance, die zwei Zwecken dient:
-
Skalierbarkeit — Wenn Sie über eine große Anzahl von Clients verfügen, die gleichzeitigen Zugriff benötigen, können Sie weitere Replikate für die Leseskalierung hinzufügen.
-
Hochverfügbarkeit — Wenn die primäre Instance ausfällt, wechselt Amazon DocumentDB automatisch zu einer Replikat-Instance und bestimmt diese als neue primäre Instanz. Wenn ein Replikat ausfällt, können andere Instances im Cluster nach wie vor für die Bearbeitung von Anfragen verwendet werden, bis der ausgefallene Knoten wiederhergestellt werden kann.
Jeder Amazon DocumentDB-Cluster kann bis zu 15 Replikate unterstützen.
Anmerkung
Für maximale Fehlertoleranz sollten Sie Replikate in separaten Availability Zones bereitstellen. Dadurch wird sichergestellt, dass Ihr Amazon DocumentDB-Cluster auch dann weiter funktioniert, wenn eine gesamte Availability Zone nicht verfügbar ist.
Das folgende AWS CLI Beispiel zeigt, wie ein neues Replikat hinzugefügt wird. Der --availability-zone-Parameter platziert das Replikat in der angegebenen Availability Zone.
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
Beschreibung von Clustern und Instanzen
Das folgende AWS CLI Beispiel listet alle Amazon DocumentDB-Cluster in einer Region auf. Für bestimmte Verwaltungsfunktionen wie Cluster- und Instance-Lebenszyklusmanagement nutzt Amazon DocumentDB Betriebstechnologie, die mit Amazon RDS gemeinsam genutzt wird. Der filterName=engine,Values=docdb Filterparameter gibt nur Amazon DocumentDB-Cluster zurück.
Weitere Informationen zum Beschreiben und Ändern von Clustern finden Sie im Amazon DocumentDB-Cluster-Lebenszyklus.
aws docdb describe-db-clusters --filter Name=engine,Values=docdb
Die Ausgabe dieser Operation sieht in etwa folgendermaßen aus.
{
"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",
...
}
]
}
Das folgende AWS CLI Beispiel listet die Instances in einem Amazon DocumentDB-Cluster auf. Weitere Informationen zum Beschreiben und Ändern von Clustern finden Sie im Lebenszyklus einer Amazon DocumentDB DocumentDB-Instanz.
aws docdb describe-db-clusters \ --db-cluster-identifier sample-cluster \ --query 'DBClusters[*].[DBClusterMembers]'
Die Ausgabe sieht wie unten aus. Diese Ausgabe enthält zwei Instances. Die Primär-Instance ist sample-instance-1 ("IsClusterWriter": true). Es gibt auch eine Replikat-Instance, nämlich 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
}
]
]
]Einen Cluster-Snapshot erstellen
Ein Cluster-Snapshot ist eine vollständige Sicherung der Daten in Ihrem Amazon DocumentDB-Cluster. Wenn der Snapshot erstellt wird, liest Amazon DocumentDB Ihre Daten direkt aus dem Cluster-Volume. Aus diesem Grund können Sie einen Snapshot erstellen, auch wenn zum jeweiligen Zeitpunkt keine Instances in Ihrem Cluster ausgeführt werden. Die zum Erstellen eines Snapshots erforderliche Zeit hängt von der Größe Ihres Cluster-Volumes ab.
Amazon DocumentDB unterstützt automatische Backups, die täglich während des bevorzugten Backup-Fensters — einem Zeitraum von 30 Minuten am Tag — durchgeführt werden. Das folgende AWS CLI Beispiel zeigt, wie Sie das Backup-Fenster für Ihren Cluster anzeigen können:
aws docdb describe-db-clusters \ --db-cluster-identifier sample-cluster \ --query 'DBClusters[*].PreferredBackupWindow'
Die Ausgabe zeigt das Sicherungszeitfenster (in UTC):
[
"00:18-00:48"
]
Sie können das Backup-Fenster definieren, wenn Sie Ihren Amazon DocumentDB-Cluster erstellen. Sie können das Sicherungszeitfenster auch ändern, wie im folgenden Beispiel gezeigt wird. Wenn Sie kein Backup-Fenster definieren, weist Amazon DocumentDB Ihrem Cluster automatisch eines zu.
aws docdb modify-db-cluster \ --db-cluster-identifier sample-cluster \ --preferred-backup-window "02:00-02:30"
Zusätzlich zu automatischen Sicherungen können Sie jederzeit manuell einen Cluster-Snapshot erstellen. Wenn Sie dies tun, müssen Sie das zu sichernde Cluster festlegen und dem Snapshot einen eindeutigen Namen geben, damit er später für Wiederherstellungszwecke verwendet werden kann.
Das folgende AWS CLI Beispiel zeigt, wie Sie einen Snapshot Ihrer Daten erstellen.
aws docdb create-db-cluster-snapshot \ --db-cluster-identifier sample-cluster \ --db-cluster-snapshot-identifier sample-cluster-snapshot
Wiederherstellung aus einem Snapshot
Sie können einen Cluster-Snapshot in einem neuen Amazon DocumentDB-Cluster wiederherstellen. Dazu geben Sie den Namen des Snapshots und den Namen eines neuen Clusters an. Sie können keine Wiederherstellung von einem Snapshot in einem vorhandenen Cluster durchführen. Stattdessen erstellt Amazon DocumentDB bei der Wiederherstellung einen neuen Cluster und füllt ihn dann mit Ihren Snapshot-Daten.
Das folgende Beispiel zeigt alle Snapshots für den Cluster sample-cluster.
aws docdb describe-db-cluster-snapshots \ --db-cluster-identifier sample-cluster \ --query 'DBClusterSnapshots[*].[DBClusterSnapshotIdentifier,SnapshotType,Status]'
Die Ausgabe sieht ungefähr wie folgt aus. Ein manueller Snapshot ist ein Snapshot, den Sie manuell erstellt haben, wohingegen ein automatisierter Snapshot von Amazon DocumentDB innerhalb des Cluster-Backup-Fensters erstellt wird.
[
"sample-cluster-snapshot",
"manual",
"available"
],
[
"rds:sample-cluster",
"automated",
"available"
]
]Das folgende Beispiel zeigt, wie ein Amazon DocumentDB-Cluster aus einem Snapshot wiederhergestellt wird.
aws docdb restore-db-cluster-from-snapshot \ --engine docdb \ --db-cluster-identifier new-sample-cluster \ --snapshot-identifier sample-cluster-snapshot
Dem neuen Cluster sind keine Instances zugeordnet. Wenn Sie mit dem Cluster interagieren möchten, müssen Sie ihm also eine Instance hinzufügen.
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
Sie können die folgenden AWS CLI Operationen verwenden, um den Fortschritt der Cluster- und Instance-Erstellung zu überwachen. Wenn die Cluster- und Instance-Status verfügbar sind, können Sie eine Verbindung zum neuen Endpunkt des Clusters herstellen und auf Ihre Daten zugreifen.
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]'
Eine Instanz aus einem Cluster entfernen
Amazon DocumentDB speichert all Ihre Daten im Cluster-Volume. Die Daten bleiben in diesem Cluster-Volume erhalten. Dies gilt auch dann, wenn Sie alle Instances von Ihrem Cluster entfernen. Wenn Sie erneut auf die Daten zugreifen müssen, können Sie jederzeit dem Cluster eine Instance hinzufügen und da weitermachen, wo Sie aufgehört haben.
Das folgende Beispiel zeigt, wie Sie eine Instance aus Ihrem Amazon DocumentDB-Cluster entfernen.
aws docdb delete-db-instance \ --db-instance-identifier sample-instance
Löschen eines Clusters
Bevor Sie einen Amazon DocumentDB-Cluster löschen können, müssen Sie zunächst alle zugehörigen Instances entfernen. Das folgende AWS CLI Beispiel gibt Informationen über die Instances in einem Cluster zurück. Wenn diese Operation Instance-Kennungen zurückgibt, müssen Sie die einzelnen Instances löschen. Weitere Informationen finden Sie unter Eine Instanz aus einem Cluster entfernen.
aws docdb describe-db-clusters \ --db-cluster-identifier sample-cluster \ --query 'DBClusters[*].DBClusterMembers[*].DBInstanceIdentifier'
Wenn keine Instances mehr vorhanden sind, können Sie das Cluster löschen. Sie müssen dann eine der folgenden Optionen wählen:
-
Einen endgültigen Snapshot erstellen — Erfassen Sie alle Clusterdaten in einem Snapshot, sodass Sie später eine neue Instanz mit diesen Daten neu erstellen können. Das Verfahren wird im folgenden Beispiel beschrieben:
aws docdb delete-db-cluster \ --db-cluster-identifier sample-cluster \ --final-db-snapshot-identifier sample-cluster-snapshot -
Den letzten Snapshot überspringen — Alle Clusterdaten werden dauerhaft gelöscht. Diese Aktion ist unwiderruflich. Das Verfahren wird im folgenden Beispiel beschrieben:
aws docdb delete-db-cluster \ --db-cluster-identifier sample-cluster \ --skip-final-snapshot
