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
Es gibt viele Möglichkeiten, eine Verbindung herzustellen und mit Amazon DocumentDB zu beginnen. Dieses Handbuch ist der schnellste, einfachste und einfachste Weg für Benutzer, mit unserer leistungsstarken Dokumentendatenbank zu beginnen. In diesem Handbuch wird verwendet [AWS CloudShell](https://docs.aws.amazon.com/cloudshell/latest/userguide/welcome.html), um eine Verbindung herzustellen und Ihren Amazon DocumentDB-Cluster direkt vom AWS-Managementkonsole abzufragen. Neukunden, die Anspruch auf das AWS kostenlose Kontingent haben, können Amazon DocumentDB CloudShell kostenlos nutzen. Wenn Ihre AWS CloudShell 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 fünf Minuten mit Amazon DocumentDB beginnen.
**Anmerkung**
Die Anweisungen in diesem Handbuch beziehen sich speziell auf das Erstellen und Herstellen einer Verbindung zu instanzbasierten Amazon DocumentDB-Clustern, in denen Amazon DocumentDB und verfügbar sind. AWS CloudShell
Informationen dazu, wie Sie elastische Amazon DocumentDB-Cluster erstellen und eine Verbindung zu diesen herstellen möchten, finden Sie unter[Erste Schritte mit Amazon DocumentDB Elastic Clusters](elastic-get-started.md).
Wenn Sie in Regionen AWS China ansässig sind, finden Sie weitere Informationen unter[Amazon EC2 automatisch Connect](connect-ec2-auto.md).
**Topics**
+ [Voraussetzungen](#quickstart-prerequisites)
+ [Schritt 1: Erstellen eines Clusters](#get-start-cluster)
+ [Schritt 2: Connect zu Ihrem Cluster her](#get-start-connectcluster)
+ [Schritt 3: Daten einfügen und abfragen](#get-start-insert-query)
+ [Schritt 4: Erkunden](#get-start-congrats)
## 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/die Anmeldung.](https://portal.aws.amazon.com/billing/signup)
1. Folgen Sie den Online-Anweisungen.
Während der Anmeldung erhalten Sie einen Telefonanruf oder eine Textnachricht und müssen einen Verifizierungscode über die Telefontasten eingeben.
Wenn Sie sich für eine anmelden AWS-Konto, *Root-Benutzer des AWS-Kontos*wird 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](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html#root-user-tasks).
**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](security-iam.md).
1. Geben Sie in der Suchleiste von IAM ein und wählen Sie im angezeigten Drop-down-Menü **IAM** aus. AWS-Managementkonsole
1. Sobald Sie sich in der IAM-Konsole befinden, wählen Sie im **Navigationsbereich Benutzer** aus.
1. Wählen Sie Ihren Nutzernamen aus.
1. Klicken Sie auf **Berichtigung hinzufügen**.
1. Wählen Sie **Richtlinien direkt anhängen** aus.
1. Geben Sie `AmazonDocDBFullAccess` in die Suchleiste ein und wählen Sie sie aus, sobald sie in den Suchergebnissen erscheint.
1. Klicken Sie auf **Weiter**.
1. Klicken Sie auf **Berichtigung hinzufügen**.
****
Ihr AWS Konto enthält in jeder Region eine Standard-VPC. Wenn Sie sich für die Verwendung einer Amazon VPC entscheiden, führen Sie die Schritte im Thema [Amazon VPC erstellen](https://docs.aws.amazon.com/vpc/latest/userguide/create-vpc.html) im *Amazon VPC-Benutzerhandbuch* aus.
## Schritt 1: Erstellen eines Clusters
In diesem Schritt erstellen Sie einen Amazon DocumentDB-Cluster.
1. Melden Sie sich bei der AWS-Managementkonsole an und öffnen Sie die Amazon DocumentDB DocumentDB-Konsole unter [https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb).
1. Wählen Sie in der Amazon DocumentDB-Managementkonsole unter **Clusters** die Option **Create** aus.
![\[Leeres Cluster-Dashboard mit Optionen zum Erstellen eines neuen Clusters und zum Verwalten von Ressourcen.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/ec-gs-start.png)
1. Wählen Sie auf der Seite Amazon DocumentDB-Cluster erstellen im Abschnitt **Clustertyp** die Option **Instance-based cluster** (dies ist die Standardoption).
![\[Auswahl des Clustertyps mit hervorgehobener Option „Instanzbasierter Cluster“ und Beschreibung beider Clustertypen.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/create-cluster/cluster-type.png)
**Anmerkung**
Die andere Option in dieser Kategorie ist **Elastic Cluster**. Weitere Informationen zu Amazon DocumentDB Elastic Clusters finden Sie unter [Verwendung elastischer Amazon DocumentDB-Cluster](docdb-using-elastic-clusters.md)
1. Im Abschnitt **Cluster-Konfiguration**:
1. Geben Sie als **Cluster-ID** einen eindeutigen Namen ein, z. **mydocdbcluster** B. Beachten Sie, dass die Konsole alle Clusternamen unabhängig davon, wie sie eingegeben wurden, in Kleinbuchstaben ändert.
1. **Wählen Sie für **Engine-Version 5.0.0** aus.**
![\[Konfigurationsformular für einen Datenbankcluster mit Feldern für den Bezeichner und die Engine-Version.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/create-cluster/cluster-config.png)
1. Wählen Sie im Abschnitt **Cluster-Speicherkonfiguration** **Amazon DocumentDB Standard** aus (dies ist die Standardoption).
![\[Auswahl des Speichertyps mit hervorgehobener Amazon DocumentDB DocumentDB-Standardoption und Beschreibung beider Speichertypen.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/create-cluster/cluster-storage.png)
**Anmerkung**
Die andere Option in dieser Kategorie ist **Amazon DocumentDB I/O-Optimized**. Weitere Informationen zu den beiden Optionen finden Sie unter [Amazon DocumentDB-Cluster-Speicherkonfigurationen](db-cluster-storage-configs.md)
1. Im Abschnitt **Instanzkonfiguration**:
1. Wählen Sie für **DB-Instance-Klasse** die Option **Speicheroptimierte Klassen (einschließlich R-Klassen)** aus (dies ist die Standardeinstellung).
Bei der anderen Instance-Option handelt es sich um **Klassen mit NVMe -backed.** Weitere Informationen hierzu finden Sie unter [NVMe-gestützte Instances](db-instance-nvme.md).
1. Wählen Sie für **Instance-Klasse** **db.t3.medium** aus. Dies ist für die kostenlose Testversion berechtigt. AWS
1. Wählen Sie für **Anzahl der Instanzen** die Option **1** Instanz 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.
![\[Konfigurationsformular für eine Datenbank-Instance mit Feldern für die DB-Instance-Klasse, die unterstützte Instance-Klasse und die Anzahl der Instances.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/create-cluster/instance-config.png)
1. Behalten Sie im Abschnitt **Konnektivität** die Standardeinstellung „**Keine Verbindung zu einer EC2 Rechenressource herstellen**“ bei.
![\[Konnektivitätseinstellungen für die Datenbank mit Optionen, um eine Verbindung zu einer EC2 Rechenressource herzustellen oder keine Verbindung herzustellen.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/create-cluster/cluster-connectivity-no-ec2.png)
1. Geben Sie im Abschnitt **Authentifizierung** einen Benutzernamen für den Hauptbenutzer ein und wählen Sie dann **Selbstverwaltet** aus. Geben Sie ein Passwort ein und bestätigen Sie es.
Wenn Sie stattdessen **Verwaltet in** wählen AWS Secrets Manager, finden Sie [Passwortverwaltung mit Amazon DocumentDB und AWS Secrets Manager](docdb-secrets-manager.md) weitere Informationen unter.
![\[Auswahl des Authentifizierungstyps, wobei AWS Secrets Manager die Option Verwaltet in markiert und beide Authentifizierungstypen beschrieben werden.\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/create-cluster/cluster-auth-self.png)
1. Behalten Sie alle anderen Optionen als Standard bei und wählen Sie **Create cluster** aus.
Amazon DocumentDB stellt jetzt Ihren Cluster bereit, was einige Minuten dauern kann.
**Anmerkung**
Informationen zu Cluster-Statuswerten finden Sie [Werte für den Cluster-Status](monitoring_docdb-cluster_status.md#monitoring_docdb-status_values) im Kapitel Monitoring Amazon DocumentDB.
## Schritt 2: Connect zu Ihrem Cluster her
Stellen Sie mithilfe AWS CloudShell von Connect zu Ihrem Amazon DocumentDB-Cluster her.
1. Suchen Sie auf der Amazon DocumentDB-Managementkonsole unter **Clusters den Cluster**, den Sie erstellt haben. Wählen Sie Ihren Cluster aus, indem Sie auf das Kontrollkästchen neben dem Cluster klicken.
![\[Amazon DocumentDB-Cluster-Managementschnittstelle, die einen regionalen Cluster mit Details zur primären Instanz anzeigt\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/cluster-connect-cloud-shell.png)
1. Klicken Sie **auf Mit Cluster verbinden** (neben dem Dropdownmenü **Aktionen**). **Diese Schaltfläche ist erst aktiviert, wenn Sie auf das Kontrollkästchen neben Ihrem Cluster geklickt haben und der Status sowohl des regionalen Clusters als auch der primären Instance (s) als Verfügbar angezeigt wird.** Der **Befehlsbildschirm CloudShell Ausführen** wird angezeigt.
1. Geben Sie im Feld **Neuer Umgebungsname** einen eindeutigen Namen ein, z. B. „Test“, und klicken Sie auf **Erstellen und ausführen**. VPC-Umgebungsdetails werden automatisch für Ihre Amazon DocumentDB DocumentDB-Datenbank konfiguriert.
![\[Befehlsbildschirm „Cluster-Cluster CloudShell Run“ mit Aufforderung zum neuen Umgebungsnamen\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/ec-gs-run-command.png)
1. Wenn Sie dazu aufgefordert werden, geben Sie das Passwort ein, das Sie in Schritt 1: Amazon DocumentDB-Cluster erstellen (Unterschritt 7) erstellt haben.
![\[CloudShell Cluster-Bildschirm, der das Benutzerpasswort anfordert\]](http://docs.aws.amazon.com/de_de/documentdb/latest/developerguide/images/ec-gs-cs-password.png)
Nachdem Sie Ihr Passwort eingegeben haben und Ihre Aufforderung lautet`rs0 [direct: primary] >`, sind Sie erfolgreich mit Ihrem Amazon DocumentDB-Cluster verbunden.
**Anmerkung**
Informationen zur Fehlerbehebung finden Sie unter [Problembehandlung bei Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/troubleshooting.html).
## Schritt 3: 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.insertOne({"hello":"DocumentDB"})
```
Sie erhalten die folgende Ausgabe:
```
{
acknowledged: true,
insertedId: ObjectId('673657216bdf6258466b128c')
}
```
1. 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()
```
Sie erhalten die folgende Ausgabe:
```
{ "_id" : ObjectId("5e401fe56056fda7321fbd67"), "hello" : "DocumentDB" }
```
1. 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 ein`profiles`. 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 }
])
```
Sie erhalten die folgende Ausgabe:
```
{ acknowledged: true, insertedIds: { '0': 1, '1': 2, '2': 3, '3': 4 } }
```
1. Verwenden Sie den `find()` Befehl, um alle Dokumente in der Profilsammlung zurückzugeben. Geben Sie Folgendes ein:
```
db.profiles.find()
```
Sie erhalten eine Ausgabe, die den Daten entspricht, die Sie in Schritt 3 eingegeben haben.
1. Verwenden Sie mithilfe eines Filters eine Abfrage für ein einzelnes Dokument. Geben Sie Folgendes ein:
```
db.profiles.find({name: "Katie"})
```
Sie erhalten die folgende Ausgabe:
```
{ "_id" : 4, "name" : "Katie", "status": "active", "level": 3, "score":27}
```
1. Versuchen wir nun, ein Profil zu finden und es mit dem `findAndModify` Befehl zu ändern. Wir geben dem Benutzer Matt zusätzliche 10 Punkte mit dem folgenden Code:
```
db.profiles.findAndModify({
query: { name: "Matt", status: "active"},
update: { $inc: { score: 10 } }
})
```
Sie erhalten die folgende Ausgabe (beachten Sie, dass sein Punktestand noch nicht gestiegen ist):
```
{
[{_id : 1, name : 'Matt', status: 'active', level: 12, score: 202}]
```
1. Sie können mit der folgenden Abfrage überprüfen, ob sich sein Punktestand geändert hat:
`db.profiles.find({name: "Matt"})`
Sie erhalten die folgende Ausgabe:
```
{ "_id" : 1, "name" : "Matt", "status" : "active", "level" : 12, "score" : 212 }
```
## Schritt 4: Erkunden
Herzlichen Glückwunsch\$1 Sie haben den Leitfaden Erste Schritte für Amazon DocumentDB DocumentDB-Instance-basierte Cluster erfolgreich abgeschlossen.
Was kommt als Nächstes? Erfahren Sie, wie Sie diese Datenbank mit einigen ihrer beliebten Funktionen optimal nutzen können:
+ [Amazon DocumentDB verwalten](https://docs.aws.amazon.com/documentdb/latest/developerguide/managing-documentdb.html)
+ [Skalierung](https://docs.aws.amazon.com/documentdb/latest/developerguide/operational_tasks.html)
+ [Sichern und Wiederherstellen](https://docs.aws.amazon.com/documentdb/latest/developerguide/backup_restore.html)
**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](https://docs.aws.amazon.com/documentdb/latest/developerguide/db-cluster-delete.html).