Erste Schritte mit Amazon DocumentDB

Es gibt viele Möglichkeiten, eine Verbindung herzustellen und mit Amazon DocumentDB zu beginnen. Wir haben diesen Leitfaden erstellt, weil wir festgestellt haben, dass dieser Weg für Benutzer der schnellste, einfachste und einfachste Weg ist, unsere leistungsstarke Dokumentendatenbank zu nutzen. Dieses Handbuch verwendet ein webbasiertes Terminal AWS Cloud9, um Ihren Amazon DocumentDB-Cluster mithilfe der Mongo-Shell direkt von der aus zu verbinden und abzufragen. AWS Management Console Neukunden, die Anspruch auf das AWS kostenlose Kontingent haben, können Amazon DocumentDB AWS Cloud9 kostenlos nutzen. Wenn Ihre AWS Cloud9 Umgebung oder Ihr Amazon DocumentDB-Cluster Ressourcen nutzt, die über das kostenlose Kontingent hinausgehen, werden Ihnen die normalen AWS Tarife für diese Ressourcen berechnet. Mit diesem Handbuch können Sie in weniger als 15 Minuten mit Amazon DocumentDB beginnen.

Anmerkung

Die Anweisungen in diesem Handbuch beziehen sich speziell auf die Erstellung und Verbindung zu Amazon DocumentDB DocumentDB-Instance-Clustern. Informationen dazu, wie Sie elastische Amazon DocumentDB-Cluster erstellen und eine Verbindung zu diesen herstellen möchten, finden Sie unterErste Schritte mit Amazon DocumentDB Elastic Clusters.

Wenn Sie lieber von Ihrem lokalen Computer aus eine Verbindung zu Ihrer Amazon DocumentDB herstellen möchten, indem Sie eine SSH-Verbindung zu einer Amazon EC2 EC2-Instance herstellen, lesen Sie bitte die Anweisungen Connect with EC2.

Voraussetzungen

Bevor Sie Ihren ersten Amazon DocumentDB-Cluster erstellen, müssen Sie Folgendes tun:

Erstellen Sie ein Amazon Web Services (AWS) -Konto

Bevor Sie Amazon DocumentDB verwenden können, benötigen Sie ein Amazon Web Services (AWS) -Konto. Das AWS Konto ist kostenlos. Sie zahlen nur für die Services und Ressourcen, die Sie wirklich nutzen.

Wenn Sie noch keinen haben AWS-Konto, führen Sie die folgenden Schritte aus, um einen zu erstellen.

Um sich für eine anzumelden AWS-Konto

1. Öffnen Sie https://portal.aws.amazon.com/billing/signup.

2. Folgen Sie den Online-Anweisungen.

   Bei der Anmeldung müssen Sie auch einen Telefonanruf entgegennehmen und einen Verifizierungscode über die Telefontasten eingeben.

   Wenn Sie sich für eine anmelden AWS-Konto, Root-Benutzer des AWS-Kontoswird eine erstellt. Der Root-Benutzer hat Zugriff auf alle AWS-Services und Ressourcen des Kontos. Als bewährte Sicherheitsmethode weisen Sie einem Administratorbenutzer Administratorzugriff zu und verwenden Sie nur den Root-Benutzer, um Aufgaben auszuführen, die Root-Benutzerzugriff erfordern.

Richten Sie die erforderlichen AWS Identity and Access Management (IAM-) Berechtigungen ein.

Für den Zugriff auf die Verwaltung von Amazon DocumentDB DocumentDB-Ressourcen wie Clustern, Instances und Cluster-Parametergruppen sind Anmeldeinformationen erforderlich, mit denen Sie Ihre Anfragen authentifizieren AWS können. Weitere Informationen finden Sie unter Identity and Access Management für Amazon DocumentDB.

1. Geben Sie in der Suchleiste von IAM ein und wählen Sie im angezeigten Drop-down-Menü IAM aus. AWS Management Console

2. Sobald Sie sich in der IAM-Konsole befinden, wählen Sie im Navigationsbereich Benutzer aus.

3. Wählen Sie Ihren Nutzernamen aus.

4. Klicken Sie auf den Button Berechtigungen hinzufügen.

5. Wählen Sie die Option Attach existing policies directly (Vorhandene Richtlinien direkt anfügen) aus.

6. Geben Sie AmazonDocDBFullAccess in die Suchleiste ein und wählen Sie sie aus, sobald sie in den Suchergebnissen erscheint.

7. Klicken Sie unten auf die blaue Schaltfläche mit der Aufschrift Weiter: Überprüfen.

8. Klicken Sie unten auf die blaue Schaltfläche mit der Aufschrift Berechtigungen hinzufügen.

Erstellen Sie eine Amazon Virtual Private Cloud (Amazon VPC)

Dieser Schritt ist nur erforderlich, wenn Sie noch keine Standard-Amazon-VPC haben. Wenn nicht, führen Sie Schritt 1 der Anleitung Erste Schritte mit Amazon VPC im Amazon VPC-Benutzerhandbuch durch. Dies dauert weniger als fünf Minuten.

Schritt 1: Erstellen Sie eine AWS Cloud9 Umgebung

AWS Cloud9 bietet ein webbasiertes Terminal, mit dem Sie mithilfe der Mongo-Shell eine Verbindung zu Ihrem Amazon DocumentDB-Cluster herstellen und ihn abfragen können.

1. AWS Management Console Navigieren Sie von dort zur AWS Cloud9 Konsole und wählen Sie Umgebung erstellen.

   

2. Geben Sie im Bereich „Details“ des Dialogfelds „Umgebung erstellen“ DocumentDBCloud9 in das Feld Name ein.

   

3. Wählen Sie im Dialogfeld Neue EC2-Instance Amazon Linux 2 aus der Dropdownliste Plattform aus.

   

   Wichtig

   Um Fehler bei der Erstellung der Amazon DocumentDB DocumentDB-Datenbank zu vermeiden, müssen Sie Amazon Linux 2 für das Feld Platforms auswählen. Wenn Sie sich im vorherigen Schritt für die Verwendung einer vorhandenen Amazon EC2 EC2-Instance entschieden haben, muss auch diese mit Amazon Linux 2 erstellt worden sein.

4. Lassen Sie für die Abschnitte Netzwerkeinstellungen und Tags die Standardeinstellung unverändert.

5. Klicken Sie unten auf dem Bildschirm auf Erstellen.

   

Ihre neue AWS Cloud9 Umgebung wird in der Tabelle Umgebungen angezeigt:

Anmerkung

Die Bereitstellung der AWS Cloud9 Umgebung kann bis zu drei Minuten dauern.

Schritt 2: Erstellen einer Sicherheitsgruppe

Diese Sicherheitsgruppe ermöglicht es Ihnen, von Ihrer AWS Cloud9 Umgebung aus eine Verbindung zu Ihrem Amazon DocumentDB-Cluster herzustellen.

1. Wählen Sie in der Amazon EC2 Management Console unter Netzwerk und Sicherheit die Option Sicherheitsgruppen aus.

   

2. Wählen Sie Sicherheitsgruppe erstellen aus.

   

3. Im Abschnitt Grundlegende Details:

   1. Geben Sie für Security group name (Name der Sicherheitsgruppe) demoDocDB ein.

   2. Geben Sie im Feld Description (Beschreibung) eine Beschreibung ein.

   3. Akzeptieren Sie für VPC die Verwendung Ihrer Standard-VPC.

   

4. Wählen Sie im Abschnitt Eingehende Regeln die Option Regel hinzufügen aus.

   1. Wählen Sie für Type (Typ) die Option Custom TCP (Benutzerdefiniertes TCP) aus.

   2. Geben Sie für Portbereich den Wert ein. 27017

   3. Wählen Sie unter Quelle die Sicherheitsgruppe für die AWS Cloud9 Umgebung aus, die nach Abschluss von Schritt 1 erstellt wurde. Um eine Liste der verfügbaren AWS Cloud9 Sicherheitsgruppen zu sehen, geben Sie cloud9 in das Suchfeld rechts neben dem Feld Quelle ein. Wählen Sie die Sicherheitsgruppe mit dem Namen aws-cloud9-<environment name> aus.

   

   Anmerkung

   Port 27017 ist der Standardport für Amazon DocumentDB.

5. Wählen Sie für das Feld Ziel in den Regeln für ausgehende Nachrichten die Option Benutzerdefiniert aus. Suchen Sie im Feld daneben nach der Sicherheitsgruppe namensdemoDocDB, die Sie gerade erstellt haben. Möglicherweise müssen Sie Ihren Browser aktualisieren, damit die Amazon EC2 EC2-Konsole den Quellnamen automatisch ausfüllt. demoDocDB

   

6. Akzeptieren Sie alle anderen Standardeinstellungen und wählen Sie Create security group.

   

Schritt 3: Erstellen Sie einen Amazon DocumentDB-Cluster

In diesem Schritt erstellen Sie einen Amazon DocumentDB-Cluster mit der Sicherheitsgruppe, die Sie im vorherigen Schritt erstellt haben.

Anmerkung

Die Anweisungen in diesem Schritt beziehen sich speziell auf die Erstellung instanzbasierter Amazon DocumentDB DocumentDB-Cluster. Informationen zum Erstellen elastischer Amazon DocumentDB-Cluster finden Sie unterErste Schritte mit Amazon DocumentDB Elastic Clusters.

1. Wählen Sie in der Amazon DocumentDB-Managementkonsole unter Clusters die Option Create aus.

   

2. Wählen Sie auf der Seite Amazon DocumentDB-Cluster erstellen im Abschnitt Clustertyp die Option Instance Based Clusters (dies ist die Standardoption).

   

3. Wählen Sie im Abschnitt Konfiguration 1 Instance aus. Die Auswahl einer Instanz trägt zur Kostenminimierung bei. Wenn es sich um ein Produktionssystem handeln würde, würden wir empfehlen, dass Sie drei Instanzen bereitstellen, um eine hohe Verfügbarkeit zu gewährleisten. Sie können die Standardeinstellungen für die anderen Einstellungen im Abschnitt Konfiguration beibehalten.

   

4. Behalten Sie für Konnektivität die Standardeinstellung „Keine Verbindung zu einer EC2-Rechenressource herstellen“ bei.

   

5. Geben Sie im Abschnitt Authentifizierung die Anmeldeinformationen ein.

   

6. Aktivieren Sie die Option Erweiterte Einstellungen anzeigen.

   

7. Wählen Sie im Abschnitt Netzwerkeinstellungen für VPC-Sicherheitsgruppen DemoDocDB (VPC) aus, wenn Sie einen Test- oder Democluster erstellen. Wenn Sie einen Cluster für ein Produktionssystem erstellen, wählen Sie Standard (VPC). Wenn Sie eine bestimmte VPC-Sicherheitsgruppe erstellen möchten, finden Sie weitere Informationen unter Sicherheitsgruppen im Amazon Virtual Private Cloud Cloud-Benutzerhandbuch.

   

8. Wählen Sie Cluster erstellen.

   

Amazon DocumentDB stellt jetzt Ihren Cluster bereit, was einige Minuten dauern kann. Sie können eine Verbindung zu Ihrem Cluster herstellen, wenn sowohl der Cluster- als auch der Instance-Status als angezeigt werden. available

Anmerkung

Informationen zu Cluster-Statuswerten finden Sie Cluster-Statuswerte im Kapitel Monitoring Amazon DocumentDB.

Informationen zu Instance-Statuswerten finden Sie Instance-Statuswerte im Kapitel Monitoring Amazon DocumentDB.

Schritt 4: Installieren Sie die Mongo-Shell

Sie werden nun die Mongo-Shell in Ihrer AWS Cloud9 Umgebung installieren, die Sie in Schritt 1 erstellt haben. Die Mongo-Shell ist ein Befehlszeilenprogramm, mit dem Sie eine Verbindung zu Ihrem Amazon DocumentDB-Cluster herstellen und ihn abfragen können.

1. Wenn Ihre AWS Cloud9 Umgebung ab Schritt 1 noch geöffnet ist, kehren Sie zu dieser Umgebung zurück und fahren Sie mit Anweisung 3 fort. Wenn Sie Ihre AWS Cloud9 Umgebung verlassen haben, suchen Sie in der AWS Cloud9 Managementkonsole unter Umgebungen nach der Umgebung mit der Bezeichnung DocumentDBCloud9. Wählen Sie in der Spalte Cloud9 IDE die Option Öffnen aus.

   

2. Erstellen Sie in der Befehlszeile die Repository-Datei mit dem folgenden Befehl:

   echo -e "[mongodb-org-4.0] \nname=MongoDB Repository\nbaseurl=https://repo.mongodb.org/yum/amazon/2013.03/mongodb-org/4.0/x86_64/\ngpgcheck=1 \nenabled=1 \ngpgkey=https://www.mongodb.org/static/pgp/server-4.0.asc" | sudo tee /etc/yum.repos.d/mongodb-org-4.0.repo

3. Wenn der Vorgang abgeschlossen ist, installieren Sie die Mongo-Shell mit dem folgenden Befehl:

   sudo yum install -y mongodb-org-shell

Wichtig

Wenn Sie während der Installation der Mongo-Shell Fehler erhalten haben, überprüfen Sie, welche Plattform Sie bei der Cloud9-Konfiguration ausgewählt haben. Sie müssen Amazon Linux 2 für das Feld Platforms in Cloud9 auswählen. Wenn Sie sich dafür entschieden haben, stattdessen eine bestehende Amazon EC2 EC2-Instance zu verwenden, muss auch diese mit Amazon Linux 2 erstellt worden sein.

Schritt 5: Connect zu Ihrem Amazon DocumentDB-Cluster her

Sie stellen nun mithilfe der Mongo-Shell, die Sie in Schritt 4 installiert haben, eine Verbindung zu Ihrem Amazon DocumentDB-Cluster her.

1. Suchen Sie auf der Amazon DocumentDB-Managementkonsole unter Clusters Ihren Cluster. Wählen Sie den Cluster aus, den Sie erstellt haben, indem Sie auf die Cluster-ID klicken.

   

2. E ncryption-in-transit ist in Amazon DocumentDB standardmäßig aktiviert. Sie können TLS optional deaktivieren. Um das aktuelle Zertifikat herunterzuladen, das für die Authentifizierung bei Ihrem Cluster erforderlich ist, kopieren Sie auf der Registerkarte Konnektivität und Sicherheit im Bereich Connect unter Das für die Authentifizierung bei Ihrem Cluster erforderliche Zertifikat der Amazon DocumentDB Certificate Authority (CA) herunterladen die angegebene Verbindungszeichenfolge. Gehen Sie zurück zu Ihrer AWS Cloud9 Umgebung und fügen Sie die Verbindungszeichenfolge ein.

   

3. Kehren Sie in der Amazon DocumentDB DocumentDB-Konsole zu Ihrem Cluster zurück, kopieren Sie auf der Registerkarte Konnektivität und Sicherheit im Bereich Connect unter Mit der Mongo-Shell mit diesem Cluster verbinden die angegebene Verbindungszeichenfolge. Lassen Sie das Kopieren aus, <insertYourPassword> sodass Sie beim Herstellen der Verbindung von der Mongo-Shell zur Eingabe des Kennworts aufgefordert werden.

   

   Gehen Sie zurück zu Ihrer AWS Cloud9 Umgebung und fügen Sie die Verbindungszeichenfolge ein.

Wenn Sie Ihr Passwort eingeben und Ihre rs0:PRIMARY> Eingabeaufforderung erscheint, sind Sie erfolgreich mit Ihrem Amazon DocumentDB-Cluster verbunden.

Anmerkung

Informationen zur Fehlerbehebung finden Sie unter Problembehandlung bei Amazon DocumentDB.

Schritt 6: Daten einfügen und abfragen

Nachdem Sie nun mit Ihrem Cluster verbunden sind, können Sie einige Abfragen ausführen, um sich mit der Verwendung einer Dokumentendatenbank vertraut zu machen.

1. Um ein einzelnes Dokument einzufügen, geben Sie Folgendes ein:

   db.collection.insert({"hello":"DocumentDB"})

2. Sie erhalten die folgende Ausgabe:

   WriteResult({ "nInserted" : 1 })

3. Sie können das Dokument lesen, das Sie mit dem findOne() Befehl geschrieben haben (weil er nur ein einziges Dokument zurückgibt). Geben Sie Folgendes ein:

   db.collection.findOne()

4. Sie erhalten die folgende Ausgabe:

   { "_id" : ObjectId("5e401fe56056fda7321fbd67"), "hello" : "DocumentDB"
                           }

5. Um ein paar weitere Abfragen durchzuführen, sollten Sie einen Anwendungsfall für Spieleprofile in Betracht ziehen. Fügen Sie zunächst einige Einträge in eine Sammlung mit dem Titel einprofiles. Geben Sie Folgendes ein:

   db.profiles.insertMany([
                       { "_id" : 1, "name" : "Matt", "status": "active", "level": 12, "score":202},
                       { "_id" : 2, "name" : "Frank", "status": "inactive", "level": 2, "score":9},
                       { "_id" : 3, "name" : "Karen", "status": "active", "level": 7, "score":87},
                       { "_id" : 4, "name" : "Katie", "status": "active", "level": 3, "score":27}
                       ])

6. Sie erhalten die folgende Ausgabe:

   { "acknowledged" : true, "insertedIds" : [ 1, 2, 3, 4 ] }

7. Verwenden Sie den find() Befehl, um alle Dokumente in der Profilsammlung zurückzugeben. Geben Sie Folgendes ein:

   db.profiles.find()

8. Sie erhalten eine Ausgabe, die den Daten entspricht, die Sie in Schritt 5 eingegeben haben.

9. Verwenden Sie mithilfe eines Filters eine Abfrage für ein einzelnes Dokument. Geben Sie Folgendes ein:

   db.profiles.find({name: "Katie"})

10. Sie sollten diese Ausgabe zurückbekommen:

    { "_id" : 4, "name" : "Katie", "status": "active", "level": 3,
                            "score":27}

11. Versuchen wir nun, ein Profil zu finden und es mit dem findAndModify Befehl zu ändern. Wir geben dem Benutzer Matt weitere zehn Punkte mit dem folgenden Code:

    db.profiles.findAndModify({
                    query: { name: "Matt", status: "active"},
                    update: { $inc: { score: 10 } }
                })

12. Sie erhalten die folgende Ausgabe (beachten Sie, dass seine Punktzahl noch nicht gestiegen ist):

    {
            "_id" : 1,
            "name" : "Matt",
            "status" : "active",
            "level" : 12,
            "score" : 202
    }

13. Sie können mit der folgenden Abfrage überprüfen, ob sich sein Punktestand geändert hat:

    db.profiles.find({name: "Matt"})

14. Sie erhalten die folgende Ausgabe:

    { "_id" : 1, "name" : "Matt", "status" : "active", "level" : 12, "score"
                            : 212 }

Schritt 7: Erkunden

Herzlichen Glückwunsch! Sie haben den Leitfaden Erste Schritte mit Amazon DocumentDB erfolgreich abgeschlossen.

Was kommt als Nächstes? Erfahren Sie, wie Sie diese Datenbank mit einigen ihrer beliebten Funktionen voll ausschöpfen können:

• Amazon DocumentDB verwalten

• Skalierung

• Sichern und Wiederherstellen

Anmerkung

Für den Cluster, den Sie im Rahmen dieser Übung „Erste Schritte“ erstellt haben, fallen weiterhin Kosten an, sofern Sie ihn nicht löschen. Anweisungen finden Sie unter Löschen eines Amazon DocumentDB-Clusters.