Arbeiten mit Amazon DocumentDB im Toolkit

PDFRSS

Amazon DocumentDB (mit MongoDB-Kompatibilität) ist ein schneller, zuverlässiger und vollständig verwalteter Datenbankservice, der die Einrichtung, den Betrieb und die Skalierung von MongoDB-kompatiblen Datenbanken in der Cloud vereinfacht.

Ausführliche Informationen zu Amazon DocumentDB, Informationen zu den ersten Schritten und Tutorials finden Sie im Amazon DocumentDB Developer Guide.

In den folgenden Abschnitten wird beschrieben, wie Sie mit Amazon DocumentDB mit dem AWS Toolkit for Visual Studio Code arbeiten.

Zugreifen auf Amazon DocumentDB über das Toolkit AWS

Gehen Sie wie folgt vor, um mit dem AWS Toolkit auf Amazon DocumentDB zuzugreifen.

Zugreifen auf Amazon DocumentDB im Toolkit AWS

1. Öffnen Sie in VS Code. AWS Toolkit for Visual Studio Code

2. Erweitern Sie im AWS Toolkit den Explorer.

3. Erweitern Sie im Explorer Amazon DocumentDB, um Ihre vorhandenen Amazon DocumentDB DocumentDB-Ressourcen anzuzeigen.

Einen instanzbasierten Cluster erstellen.

Um mit der Arbeit mit Amazon DocumentDB zu beginnen, erstellen Sie einen Cluster, indem Sie das folgende Verfahren ausführen.

Einen instanzbasierten Cluster erstellen

1. Öffnen Sie im das AWS Toolkit for Visual Studio Code Kontextmenü für Amazon DocumentDB (klicken Sie mit der rechten Maustaste darauf) und wählen Sie dann Cluster erstellen aus, um das Dialogfeld Amazon DocumentDB-Cluster erstellen in VS Code zu öffnen.

2. Wählen Sie auf dem Bildschirm Clustertyp die Option Instance Based Cluster aus.

3. Geben Sie auf dem Bildschirm Clustername einen Namen für Ihren neuen Cluster ein.

4. Wählen Sie auf dem Bildschirm Engine-Version auswählen Ihre bevorzugte Amazon DocumentDB DocumentDB-Engine-Version aus.

5. Geben Sie auf den Bildschirmen Admin-Benutzername und Passwort einen Admin-Benutzernamen und ein Admin-Passwort an, um Ihren Cluster zu schützen.

6. Wählen Sie auf dem Bildschirm „Speicherverschlüsselung angeben“ aus, ob Ihr Cluster verschlüsselt werden soll oder nicht.

7. Konfigurieren Sie auf dem Bildschirm „Anzahl der Instanzen“ Ihre bevorzugte Anzahl von Instanzen.

8. Wählen Sie auf dem Bildschirm „Instance-Klasse auswählen“ Ihre bevorzugte Instance-Klasse aus und fahren Sie dann mit der Erstellung Ihres neuen Clusters fort.

   Anmerkung

   Das Hochfahren Ihres Clusters kann mehrere Minuten dauern.

Einen Cluster-Endpunkt kopieren

Gehen Sie wie folgt vor, um Ihren Amazon DocumentDB-Cluster-Endpunkt zu kopieren.

Einen Cluster-Endpunkt kopieren

1. Erweitern Sie von der aus Amazon DocumentDB AWS Toolkit for Visual Studio Code, um Ihre Amazon DocumentDB-Cluster anzuzeigen.

2. Klicken Sie mit der rechten Maustaste auf den Cluster, aus dem Sie die Verbindungsdetails kopieren möchten, und wählen Sie dann Endpunkt kopieren, um die Cluster-Endpunktinformationen in Ihre Zwischenablage zu kopieren.

3. Ihr Cluster-Endpunkt kann jetzt in Ihre Dokumente eingefügt werden.

Im Browser öffnen

Öffnen Sie Ihre Amazon DocumentDB-Cluster in der AWS Konsole, um weitere Funktionen zur Clusterverwaltung zu erhalten. Gehen Sie wie folgt vor, um die AWS Konsole für Ihren Amazon DocumentDB-Cluster in Ihrem Standard-Webbrowser zu öffnen.

Öffnen Sie Ihren Cluster in der Konsole AWS

1. Erweitern Sie von der aus Amazon DocumentDB AWS Toolkit for Visual Studio Code, um Ihre Amazon DocumentDB-Cluster anzuzeigen.

2. Klicken Sie mit der rechten Maustaste auf den Cluster, den Sie in der AWS Konsole anzeigen möchten, und wählen Sie dann Im Browser öffnen.

3. Die AWS Konsole wird im Amazon DocumentDB-Cluster in Ihrem Standard-Webbrowser geöffnet.

Erweiterung eines vorhandenen Clusters

Gehen Sie wie folgt vor, um Ihre Amazon DocumentDB-Cluster durch Hinzufügen von Instances zu skalieren.

Hinzufügen einer Instance zur Erweiterung Ihres Clusters

1. Erweitern Sie von der aus Amazon DocumentDB AWS Toolkit for Visual Studio Code, um Ihre Amazon DocumentDB-Cluster anzuzeigen.

2. Klicken Sie mit der rechten Maustaste auf den Cluster, den Sie erweitern möchten, und wählen Sie Instance hinzufügen, um das Dialogfeld Instance hinzufügen in VS Code zu öffnen.

3. Wenn Sie dazu aufgefordert werden, geben Sie einen Namen für Ihre neue Instanz in das Textfeld ein und drücken Sie dann die Enter Eingabetaste, um fortzufahren.

4. Wenn Sie dazu aufgefordert werden, wählen Sie eine Instanzklasse aus der Liste aus, um fortzufahren.

5. Der AWS Explorer zeigt den Erstellungsstatus an und aktualisiert, wenn die neue Instanz bereit ist.

Stoppen eines Clusters

Stoppen Sie Ihren Amazon DocumentDB-Cluster, indem Sie das folgende Verfahren ausführen.

Anmerkung

Solange Ihr Cluster gestoppt ist, sind die meisten Clusterverwaltungsfunktionen nicht verfügbar.

Ihren Amazon DocumentDB-Cluster beenden

1. Erweitern Sie von der aus Amazon DocumentDB AWS Toolkit for Visual Studio Code, um Ihre Amazon DocumentDB-Cluster anzuzeigen.

2. Wählen Sie die Schaltfläche „Cluster beenden“ neben dem Cluster, den Sie beenden möchten, oder klicken Sie mit der rechten Maustaste auf den Cluster und wählen Sie Cluster beenden.

3. Wenn Sie dazu aufgefordert werden, wählen Sie Ja, um Ihren Cluster zu beenden, oder Abbrechen, um den Stoppvorgang abzubrechen und den Cluster weiterlaufen zu lassen.

4. Der AWS Explorer zeigt den Status Ihres Clusters an und aktualisiert, wenn der Cluster gestoppt wurde.

Eine Instanz neu starten

Der Neustart einer Instanz ist nützlich, um Fehler zu beheben und kleinere Änderungen vorzunehmen, ohne dass sich dies auf Ihren gesamten Cluster auswirkt. Gehen Sie wie folgt vor, um eine Amazon DocumentDB DocumentDB-Instance neu zu starten.

Neustarten einer Cluster-Instance

1. Erweitern Sie von der aus Amazon DocumentDB AWS Toolkit for Visual Studio Code, um Ihre Amazon DocumentDB-Cluster anzuzeigen.

2. Klicken Sie mit der rechten Maustaste auf die Cluster-Instance, die Sie neu starten möchten, und wählen Sie dann Reboot Instance.

3. Wenn Sie dazu aufgefordert werden, wählen Sie Ja, um Ihre Instance neu zu starten, oder Abbrechen, um den Neustartvorgang abzubrechen und Ihre Instance gestoppt zu lassen.

4. Der AWS Explorer zeigt den Status Ihres Clusters an und aktualisiert, wenn Ihre Instance neu gestartet wurde.

Eine Instance löschen

Gehen Sie wie folgt vor, um eine Amazon DocumentDB-Cluster-Instance zu löschen.

Anmerkung

Das Löschen einer Instance hat keine Auswirkungen auf die Daten in Ihrem Cluster. Wenn Sie die primäre Instanz löschen, übernimmt eine der Replikatinstanzen die Rolle der beschreibbaren Instanz.

Löschen einer Clusterinstanz

1. Erweitern Sie von der aus Amazon DocumentDB AWS Toolkit for Visual Studio Code, um Ihre Amazon DocumentDB-Cluster anzuzeigen.

2. Klicken Sie mit der rechten Maustaste auf die Cluster-Instance, die Sie löschen möchten, und wählen Sie dann Löschen, um das delete-cluster-instance Bestätigungsdialogfeld in VS Code zu öffnen.

3. Folgen Sie der Bestätigungsaufforderung und drücken Sie dann die Enter Taste, um Ihre Clusterinstanz zu löschen.

4. Der AWS Explorer zeigt den Status Ihrer Cluster-Instance an und aktualisiert, wenn Ihre Instance gelöscht wurde.

Tags anzeigen, hinzufügen und entfernen

Tags werden verwendet, um Ressourcen in Ihrer Umgebung zu organisieren und nachzuverfolgen. Um die mit Ihrem Amazon DocumentDB-Cluster verknüpften Tags anzuzeigen oder zu bearbeiten, führen Sie eines der folgenden Verfahren aus.

Cluster-Tags anzeigen

1. Erweitern Sie von der aus Amazon DocumentDB AWS Toolkit for Visual Studio Code, um Ihre Amazon DocumentDB-Cluster anzuzeigen.

2. Klicken Sie mit der rechten Maustaste auf den Cluster, für den Sie Tags anzeigen möchten, und wählen Sie dann Tags... um den your cluster name Dialog „Tags für“ zu öffnen.

3. Ihre Tags werden im Dialogfenster angezeigt. Wenn Ihrem Cluster keine Tags zugeordnet sind, wird die Meldung [Keine Tags zugewiesen] angezeigt.

Hinzufügen von Tags zu Ihrem Cluster

1. Erweitern Sie von der aus Amazon DocumentDB AWS Toolkit for Visual Studio Code, um Ihre Amazon DocumentDB-Cluster anzuzeigen.

2. Klicken Sie mit der rechten Maustaste auf den Cluster, für den Sie Tags hinzufügen möchten, und wählen Sie dann Tags... um den your cluster name Dialog „Tags für“ zu öffnen.

3. Wählen Sie Tag hinzufügen... Schaltfläche, um das Dialogfeld „Tag hinzufügen“ in VS Code zu öffnen.

4. Geben Sie ein neues Tag in das Textfeld ein und drücken Sie dann die Eingabetaste, um fortzufahren.

5. Geben Sie einen Wert in das Textfeld ein und drücken Sie dann die Eingabetaste, um das Schlüssel/Wert-Paar zu Ihrem Cluster hinzuzufügen.

Tags aus Ihrem Cluster entfernen

1. Erweitern Sie von der aus Amazon DocumentDB AWS Toolkit for Visual Studio Code, um Ihre Amazon DocumentDB-Cluster anzuzeigen.

2. Klicken Sie mit der rechten Maustaste auf den Cluster, aus dem Sie Tags entfernen möchten, und wählen Sie dann Tags... um den your cluster name Dialog „Tags für“ zu öffnen.

3. Wählen Sie das Tag entfernen... Schaltfläche, um das your cluster name Dialogfeld „Tag aus“ entfernen in VS Code zu öffnen.

4. Wählen Sie das Tag, das Sie entfernen möchten, aus der bereitgestellten Liste aus, um das Tag aus Ihrem Cluster zu entfernen.

Eine Instance-Klasse ändern

Gehen Sie wie folgt vor, um die Klasse einer Amazon DocumentDB-Cluster-Instance zu ändern.

Ändern einer Instance-Klasse

1. Erweitern Sie von der aus Amazon DocumentDB AWS Toolkit for Visual Studio Code, um Ihre Amazon DocumentDB-Cluster anzuzeigen.

2. Klicken Sie mit der rechten Maustaste auf die Cluster-Instance, die Sie ändern möchten, und wählen Sie dann Modify Class... um das Dialogfeld „Instanzklasse auswählen“ in VS Code zu öffnen.

3. Wählen Sie eine neue Klasse für Ihre Instanz aus der Liste aus, um die Klasse zu aktualisieren.

4. Der AWS Explorer zeigt den Status Ihrer Cluster-Instance an und aktualisiert, wenn die Klasse Ihrer Instance aktualisiert wurde.