Schnellstart: Erstellen eines Azure DocumentDB-Clusters mithilfe des Azure-Portals

In dieser Schnellstartanleitung erstellen Sie einen neuen Azure DocumentDB-Cluster. Dieser Cluster enthält alle Ihre typischen MongoDB-Ressourcen: Datenbanken, Sammlungen und Dokumente. Der Cluster bietet einen eindeutigen Endpunkt für verschiedene Tools und Treiber, um eine Verbindung mit Azure DocumentDB herzustellen und alltägliche Vorgänge auszuführen.

Voraussetzungen

• Ein Azure-Abonnement

  • Wenn Sie nicht über ein Azure-Abonnement verfügen, erstellen Sie ein kostenloses Konto

Erstellen eines Clusters

Zunächst müssen Sie einen Azure DocumentDB-Cluster erstellen, der als Grundlage für das Speichern und Verwalten Ihrer NoSQL-Daten dient.

1. Melden Sie sich beim Azure-Portal an (https://portal.azure.com).

2. Wählen Sie im Menü des Azure-Portals oder auf der Startseite die Option Ressource erstellen aus.

3. Suchen Sie auf der Seite "Neu" nach Azure DocumentDB, und wählen Sie sie aus.

   

4. Wählen Sie auf der Seite "Azure DocumentDB-Cluster erstellen" und im Abschnitt " Grundlagen " die Option "Konfigurieren" im Abschnitt " Clusterebene " aus.

   

5. Konfigurieren Sie auf der Seite "Skalieren " diese Optionen, und wählen Sie dann " Speichern " aus, um ihre Änderungen auf der Clusterebene beizubehalten.

   	Wert
   Cluster-Ebene	M30 tier, 2 vCore, 8-GiB RAM
   Speicherplatz pro Shard	128 GiB

   

6. Gehen Sie zurück in den Abschnitt "Grundlagen" und konfigurieren Sie die folgenden Optionen:

   	Wert
   Subscription	Wählen Sie Ihr Azure-Abonnement aus.
   Ressourcengruppe	Erstellen Sie eine neue Ressourcengruppe, oder wählen Sie eine vorhandene Ressourcengruppe aus
   Clustername	Geben Sie einen global eindeutigen Namen an.
   Ort	Wählen Sie eine unterstützte Azure-Region für Ihre Subscription
   MongoDB-Version	Auswählen 8.0
   Admin-Benutzername	Erstellen eines Benutzernamens für den Zugriff auf den Cluster als Benutzeradministrator
   Passwort	Verwenden eines eindeutigen Kennworts, das dem Benutzernamen zugeordnet ist

   

   Tipp

   Notieren Sie die Werte, die Sie für Benutzername und Kennwort verwenden. Diese Werte werden weiter unten in diesem Leitfaden verwendet. Weitere Informationen zu gültigen Werten finden Sie unter Clusterbeschränkungen.

7. Klicken Sie auf Weiter: Netzwerk.

8. Konfigurieren Sie im Abschnitt "Firewallregeln " auf der Registerkarte "Netzwerk " die folgenden Optionen:

   	Wert
   Konnektivitätsmethode	Public access
   Zulassen des öffentlichen Zugriffs von Azure-Diensten und -Ressourcen in Azure auf diesen Cluster	Aktiviert

9. Fügen Sie eine Firewallregel für Ihr aktuelles Clientgerät hinzu, um Zugriff auf den Cluster zu gewähren, indem Sie +Aktuelle Client-IP-Adresse hinzufügen auswählen.

   

   Tipp

   In vielen Unternehmensumgebungen werden IP-Adressen des Entwicklercomputers aufgrund von VPN-Einstellungen oder anderer Unternehmensnetzwerkeinstellungen ausgeblendet. In diesen Fällen können Sie vorübergehend den Zugriff auf alle IP-Adressen zulassen, indem Sie den 0.0.0.0 - 255.255.255.255 IP-Adressbereich als Firewallregel hinzufügen. Verwenden Sie diese Firewallregel nur vorübergehend als Teil von Verbindungstests und -entwicklung.

10. Klicken Sie auf Überprüfen + erstellen.

11. Überprüfen Sie die von Ihnen angegebenen Einstellungen, und wählen Sie dann Erstellen aus. Die Erstellung des Clusters dauert einige Minuten. Warten Sie, bis die Ressourcenbereitstellung abgeschlossen ist.

12. Wählen Sie schließlich "Zur Ressource wechseln " aus, um im Portal zum Azure DocumentDB-Cluster zu navigieren.

Abrufen von Clusteranmeldeinformationen

Rufen Sie die Anmeldeinformationen ab, die Sie zum Herstellen einer Verbindung mit dem Cluster verwenden.

1. Wählen Sie auf der Clusterseite die Option "Verbindungszeichenfolgen" im Ressourcenmenü aus.

2. Kopieren oder aufzeichnen Sie im Abschnitt "Verbindungszeichenfolgen " den Wert aus dem Feld "Verbindungszeichenfolge ".

Von Bedeutung

Die Verbindungszeichenfolge im Portal enthält nicht den Kennwortwert. Sie müssen den <password> Platzhalter durch die Anmeldeinformationen ersetzen, die Sie beim Erstellen des Clusters eingegeben haben, oder das Kennwort interaktiv eingeben.

Herstellen einer Verbindung mit der MongoDB-Shell über den Schnellstart

Um eine direkte Verbindung mit Azure DocumentDB mithilfe der MongoDB-Shell herzustellen, verwenden Sie die Schnellstartoberfläche, die auf der Seite der Ressource im Azure-Portal verfügbar ist.

1. Wählen Sie auf der Clusterressourcenseite schnellstart (Vorschau) im Navigationsmenü aus.

2. Wählen Sie dann "MongoDB-Shell öffnen" aus.

3. Warten Sie, bis die MongoDB-Shell-Umgebung gestartet wird.

4. Sobald die Umgebung fertig ist, geben Sie Y ein, um die Benachrichtigung zu akzeptieren.

   Hinweis

   Wenn nach der Annahme der Benachrichtigung ein Problem beim Herstellen einer Verbindung mit der MongoDB-Shell auftritt, stellen Sie sicher, dass Azure Cloud Shell Zugriff auf Ihren Cluster hat.

5. Geben Sie nun Ihr Kennwort ein, um Ihren Cluster mit Cloud Shell zu verbinden.

Durchführen von Testabfragen

Stellen Sie sicher, dass Sie erfolgreich mit Ihrem Cluster verbunden sind, indem Sie eine Reihe von Testbefehlen und Abfragen ausführen.

1. Überprüfen Sie den Verbindungsstatus, indem Sie den connectionStatus Befehl ausführen.

   db.runCommand({connectionStatus: 1})
   

   {
     ...
     ok: 1
   }
   

2. Listen Sie die Datenbanken in Ihrem Cluster auf.

   show dbs
   

3. Wechseln sie zu einer bestimmten Datenbank. Ersetzen Sie den <database-name> Platzhalter durch den Namen einer beliebigen Datenbank in Ihrem Cluster.

   use <database-name>
   

   Tipp

   Wenn der Datenbankname beispielsweise inventory wäre, dann wäre der Befehl use inventory.

4. Listen Sie die Sammlungen in der Datenbank auf.

   show collections
   

5. Suchen Sie die ersten fünf Elemente in einer bestimmten Auflistung. Ersetzen Sie den <collection-name> Platzhalter durch den Namen einer beliebigen Sammlung in Ihrem Cluster.

   db.<collection-name>.find().limit(5)
   

   Tipp

   Wenn der Auflistungsname beispielsweise equipment lautet, dann lautet der Befehl db.equipment.find().limit(5).

Bereinigen von Ressourcen

Wenn Sie mit dem Azure DocumentDB-Cluster fertig sind, können Sie die azure-Ressourcen löschen, die Sie erstellt haben, damit keine weiteren Gebühren anfallen.

1. Suchen Sie über die Suchleiste des Azure-Portals nach Ressourcengruppen, und wählen Sie die entsprechende Option aus.

   

2. Wählen Sie in der Liste die Ressourcengruppe aus, die Sie für diesen Schnellstart verwendet haben.

   

3. Wählen Sie auf der Ressourcengruppenseite die Option Ressourcengruppe löschen aus.

4. Geben Sie im Dialogfeld zum Bestätigen des Löschvorgangs den Namen der Ressourcengruppe ein, um zu bestätigen, dass Sie sie löschen möchten. Wählen Sie abschließend Löschen aus, um die Ressourcengruppe endgültig zu löschen.

   

Verwandte Inhalte

• Herstellen einer Verbindung von der MongoDB-Shell
• Herstellen einer Verbindung über Azure Cloud Shell
• Migrieren von Daten zu Azure DocumentDB