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.
Erste Schritte mit Amazon DocumentDB Elastic Clusters
In diesem Abschnitt „Erste Schritte“ erfahren Sie, wie Sie Ihren ersten Elastic Cluster erstellen und abfragen können. Es gibt viele Möglichkeiten, eine Verbindung herzustellen und mit Elastic Clustern loszulegen. In diesem Handbuch wird ein webbasiertes Terminal verwendet AWS Cloud9, um Ihren Elastic Cluster mithilfe der Mongo-Shell direkt von der AWS Management Console aus zu verbinden und abzufragen.
Themen
Einrichten
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-Instance herstellen, finden Sie weitere Informationen unter Verbindung mit Amazon EC2 herstellen.
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
Öffnen Sie https://portal.aws.amazon.com/billing/signup
. 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. Aus Sicherheitsgründen sollten Sie einem Benutzer Administratorzugriff zuweisen und nur den Root-Benutzer verwenden, um Aufgaben auszuführen, für die Root-Benutzerzugriff erforderlich ist.
- 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.
-
Geben Sie in der Suchleiste von IAM ein und wählen Sie im Drop-down-Menü IAM aus. AWS Management Console
-
Sobald Sie sich in der IAM-Konsole befinden, wählen Sie im Navigationsbereich Benutzer aus.
-
Wählen Sie Ihren Nutzernamen aus.
-
Klicken Sie auf den Button Berechtigungen hinzufügen.
-
Wählen Sie die Option Attach existing policies directly (Vorhandene Richtlinien direkt anfügen) aus.
-
Geben Sie
AmazonDocDBFullAccess
in die Suchleiste ein und wählen Sie sie aus, sobald sie in den Suchergebnissen erscheint. -
Klicken Sie unten auf die blaue Schaltfläche mit der Aufschrift Weiter: Überprüfen.
-
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 einen elastischen Cluster
In diesem Abschnitt erklären wir, wie Sie einen brandneuen elastischen Cluster erstellen, indem Sie entweder das AWS Management Console oder AWS CLI verwenden und die folgenden Anweisungen verwenden.
Schritt 2: Erstellen Sie eine AWS Cloud9 Umgebung
AWS Cloud9 bietet ein webbasiertes Terminal, mit dem Sie mithilfe der Mongo-Shell eine Verbindung zu Ihren elastischen Amazon DocumentDB-Clustern herstellen und diese abfragen können.
Anmerkung
Hinweis: Ihre AWS Cloud9 Umgebung muss sich in derselben Sicherheitsgruppe wie Ihre Instance befinden. Sie können die Sicherheitsgruppe in der Amazon EC2 EC2-Konsole ändern.
-
Verwenden Sie Ihr AWS Konto und greifen Sie auf die AWS Management Consolezu.
-
Navigieren Sie zur AWS Cloud9 Konsole. Sie können „Cloud9" in das Suchfeld eingeben, um es zu finden.
-
Wählen Sie auf der Startseite der AWS Cloud9Umgebung die Option Umgebung erstellen aus.
-
Geben Sie auf der Seite Namensumgebung im Feld Name einen Namen Ihrer Wahl ein.
Klicken Sie auf Nächster Schritt.
-
Wählen Sie in den Umgebungseinstellungen im Abschnitt Umgebungstyp die Option Neue EC2-Instanz für die Umgebung erstellen (Direktzugriff) aus.
Wählen Sie im Abschnitt Instanztyp einen geeigneten Instanztyp für Ihr Netzwerk aus.
Wählen Sie im Bereich Plattform Amazon Linux 2 (empfohlen) aus.
-
Erweitern Sie Network settings (advanced) (Netzwerkeinstellungen (erweitert)).
Wählen Sie die VPC und eines der Subnetze aus, die Sie bei der Erstellung Ihres Elastic Clusters verwendet haben.
Klicken Sie auf Nächster Schritt.
-
Überprüfen Sie Ihre AWS Cloud9 Konfiguration.
Wenn Ihre Konfiguration korrekt ist, wählen Sie Umgebung erstellen.
Schritt 3: Installieren Sie die Mongo-Shell
Sobald Ihre AWS Cloud9 Umgebung bereit ist, können Sie eine Verbindung zu Ihrem Cluster herstellen. Installieren Sie als Nächstes die Mongo-Shell in Ihrer AWS Cloud9 Umgebung, die Sie in Schritt 3 erstellt haben. Die Mongo-Shell ist ein Befehlszeilenprogramm, mit dem Sie eine Verbindung zu Ihrem Elastic Cluster herstellen und ihn abfragen können.
Wenn Ihre AWS Cloud9 Umgebung ab Schritt 3 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 Konsole unter Ihre Umgebungen nach der Umgebung, die mit dem Namen beschriftet ist, den Sie im vorherigen Schritt festgelegt haben. Wählen Sie IDE öffnen.
-
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
-
Wenn der Vorgang abgeschlossen ist, installieren Sie die Mongo-Shell mit dem folgenden Befehl:
sudo yum install -y mongodb-org-shell
Schritt 4: Connect zu Ihrem neuen Elastic Cluster her
Stellen Sie mithilfe der Mongo-Shell, die Sie in Schritt 4 installiert haben, eine Connect zu Ihrem Cluster her.
-
Suchen Sie in der Amazon DocumentDB Management Console unter Clusters Ihren Cluster. Sortieren Sie nach Rolle, um alle Cluster mit der Rolle Elastic Cluster anzuzeigen.
-
Wählen Sie den Cluster aus, den Sie erstellt haben, indem Sie die Cluster-ID auswählen. Kopieren Sie Ihren Endpunkt aus Konnektivität und Sicherheit und fügen Sie ihn in Ihre AWS Cloud9 Umgebung ein.
-
Sobald die Verbindung hergestellt ist, sollten Sie die folgende Ausgabe sehen:
Schritt 5: Teilen Sie Ihre Sammlung; fügen Sie Daten ein und fragen Sie sie ab
Elastische Cluster bieten Unterstützung für Sharding in Amazon DocumentDB. Jetzt, da Sie mit Ihrem Cluster verbunden sind, können Sie den Cluster teilen, Daten einfügen und einige Abfragen ausführen.
-
Um eine Sammlung zu teilen, geben Sie Folgendes ein:
sh.shardCollection("db.Employee1" , { "Employeeid" : "hashed" })
-
Um ein einzelnes Dokument einzufügen, geben Sie Folgendes ein:
db.Employee1.insert({"Employeeid":1, "Name":"Joe", "LastName": "Bruin", "level": 1 })
Die folgende Ausgabe wird angezeigt:
WriteResult({ "nInserted" : 1 })
-
Um das Dokument zu lesen, das Sie geschrieben haben, geben Sie den
findOne()
Befehl ein (es wird ein einzelnes Dokument zurückgegeben):db.Employee1.findOne()
Die folgende Ausgabe wird angezeigt:
{ "_id" : ObjectId("61f344e0594fe1a1685a8151"), "EmployeeID" : 1, "Name" : "Joe", "LastName" : "Bruin", "level" : 1 }
-
Um ein paar weitere Abfragen durchzuführen, sollten Sie einen Anwendungsfall für ein Spieleprofil in Betracht ziehen. Fügen Sie zunächst einige Einträge in eine Sammlung mit dem Titel „Mitarbeiter“ ein. Geben Sie Folgendes ein:
db.Employee1.insertMany([ { "Employeeid" : 1, "name" : "Matt", "lastname": "Winkle", "level": 12}, { "Employeeid" : 2, "name" : "Frank", "lastname": "Chen", "level": 2}, { "Employeeid" : 3, "name" : "Karen", "lastname": "William", "level": 7}, { "Employeeid" : 4, "name" : "Katie", "lastname": "Schaper", "level": 3} ])
Die folgende Ausgabe wird angezeigt:
{ "acknowledged" : true, "insertedIds" : [ 1, 2, 3, 4 ] }
-
Um alle Dokumente in der Profilsammlung zurückzugeben, geben Sie den Befehl
find
() ein:db.Employee1.find()
Die Daten, die Sie in Schritt 4 eingegeben haben, werden angezeigt.
-
Um ein einzelnes Dokument abzufragen, fügen Sie einen Filter hinzu (z. B.: „Katie“). Geben Sie Folgendes ein:
db.Employee1.find({name: "Katie"})
Die folgende Ausgabe wird angezeigt:
{ "_id" : 4, "name" : "Katie", "lastname": "Schaper", "level": 3}
-
Um ein Profil zu finden und es zu ändern, geben Sie den
findAndModify
Befehl ein. In diesem Beispiel erhält der Mitarbeiter „Matt“ eine höhere Stufe von „14":db.Employee1.findAndModify({ query: { "Employeeid" : 1, "name" : "Matt"}, update: { "Employeeid" : 1, "name" : "Matt", "lastname" : "Winkle", "level" : 14 } })
Die folgende Ausgabe wird angezeigt (beachten Sie, dass sich der Pegel noch nicht geändert hat):
{ "_id" : 1, "name" : "Matt", "lastname" : "Winkle", "level" : 12, }
-
Geben Sie die folgende Abfrage ein, um den Levelanstieg zu überprüfen:
db.Employee1.find({name: "Matt"})
Die folgende Ausgabe wird angezeigt:
{ "_id" : 1, "name" : "Matt", "lastname" : "winkle", "level" : 14 }