Amazon DocumentDB - Entwicklerhandbuch...Amazon DocumentDB Entwicklerhandbuch...

688
Amazon DocumentDB Entwicklerhandbuch

Transcript of Amazon DocumentDB - Entwicklerhandbuch...Amazon DocumentDB Entwicklerhandbuch...

  • Amazon DocumentDBEntwicklerhandbuch

  • Amazon DocumentDB Entwicklerhandbuch

    Amazon DocumentDB: EntwicklerhandbuchCopyright © 2021 Amazon Web Services, Inc. and/or its affiliates. All rights reserved.

    Amazon's trademarks and trade dress may not be used in connection with any product or service that is not Amazon's,in any manner that is likely to cause confusion among customers, or in any manner that disparages or discreditsAmazon. All other trademarks not owned by Amazon are the property of their respective owners, who may or may notbe affiliated with, connected to, or sponsored by Amazon.

  • Amazon DocumentDB Entwicklerhandbuch

    Table of ContentsWas ist Amazon DocumentDB? ............................................................................................................ 1

    Übersicht ................................................................................................................................... 1Clusters ..................................................................................................................................... 2Instances ................................................................................................................................... 3Regionen und AZs ...................................................................................................................... 4

    Regions ............................................................................................................................. 4Availability Zones ................................................................................................................ 4

    Preise ....................................................................................................................................... 5Monitoring ................................................................................................................................. 6Interfaces .................................................................................................................................. 6

    AWS Management Console ................................................................................................. 6AWS CLI ........................................................................................................................... 6Die mongo-Shell ................................................................................................................. 6MongoDB-Treiber ............................................................................................................... 7

    Die nächsten Themen ................................................................................................................. 7So funktioniert es ....................................................................................................................... 7

    Amazon DocumentDB-Endpunkte .......................................................................................... 8TLS Support ..................................................................................................................... 11Amazon DocumentDB-Speicher .......................................................................................... 11Amazon DocumentDB-Replikation ....................................................................................... 12Zuverlässigkeit von Amazon DocumentDB ............................................................................ 12Leseeinstellungsoptionen ................................................................................................... 13TTL löscht ....................................................................................................................... 16Gebührenpflichtige Ressourcen ........................................................................................... 16

    Was ist eine Dokumentdatenbank? .............................................................................................. 18Anwendungsfälle ............................................................................................................... 19Informationen zu Dokumenten ............................................................................................ 19Arbeiten mit Dokumenten ................................................................................................... 23

    Leitfaden „Erste Schritte“ .................................................................................................................... 33Prerequisites ............................................................................................................................ 33Schritt 1: Erstellen einer AWS Cloud9-Umgebung .......................................................................... 34Schritt 2: Erstellen einer Sicherheitsgruppe ................................................................................... 37Schritt 3: Erstellen eines Amazon DocumentDB-Clusters ................................................................. 39Schritt 4: Installieren der mongo-Shell .......................................................................................... 42Schritt 5: Verbinden Sie sich mit Ihrem Amazon DocumentDB bündeln .............................................. 43Schritt 6: Daten einfügen und abfragen ........................................................................................ 44Schritt 7: Entdecken .................................................................................................................. 45

    Schnelleinstieg mit AWS CloudFormation ............................................................................................. 46Prerequisites ............................................................................................................................ 46

    Erforderliche IAM-Berechtigungen ........................................................................................ 46Amazon EC2-Schlüsselpaar ............................................................................................... 47

    Starten eines Amazon DocumentDB AWS CloudFormation Stapel .................................................... 48Zugreifen auf den Amazon DocumentDB-Cluster ........................................................................... 51Beendigungsschutz und Löschschutz ........................................................................................... 51

    MongoDB 4.0-Kompatibilität ................................................................................................................ 53Neuerungen in Amazon DocumentDB 4.0 ..................................................................................... 53Erste Schritte mit Amazon DocumentDB 4.0 ................................................................................. 54Upgraden oder Migrieren zu Amazon DocumentDB 4.0 .................................................................. 54Funktionsunterschiede ............................................................................................................... 54

    Funktionsunterschiede zwischen Amazon DocumentDB 3.6 und 4.0 .......................................... 54Funktionsunterschiede zwischen Amazon DocumentDB 4.0 und MongoDB 4.0 ........................... 55

    Transaktionen ................................................................................................................................... 56Voraussetzungen ...................................................................................................................... 56Bewährte Methoden .................................................................................................................. 56

    iii

  • Amazon DocumentDB Entwicklerhandbuch

    Limitations ............................................................................................................................... 56Überwachung und Diagnose ....................................................................................................... 57Transaktionsisolationsstufe ......................................................................................................... 58Anwendungsfälle ....................................................................................................................... 58

    Transaktionen mit mehreren Anweisungen ............................................................................ 58Multi-Collection-Transaktionen ............................................................................................. 59Transaktions-API-Beispiele für die Callback-API ..................................................................... 61Beispiele für Transaktions-APIs für die Core-API ................................................................... 61

    Unterstützte -Befehle ................................................................................................................. 83Nicht unterstützte Funktionen ...................................................................................................... 83Sessions .................................................................................................................................. 84

    Kausale Konsistenz ........................................................................................................... 84Wiederholbare Schreibvorgänge .......................................................................................... 85

    Transaktionsfehler ..................................................................................................................... 85Bewährte Methoden .......................................................................................................................... 86

    Grundlegende Anleitungen für die Ausführung ............................................................................... 86Instance-Größenbestimmung ...................................................................................................... 87Arbeiten mit Indizes .................................................................................................................. 88

    Erstellen von Indizes ......................................................................................................... 88Index-Selektivität ............................................................................................................... 88Auswirkungen von Indizes auf das Schreiben von Daten ......................................................... 89Identifizieren von fehlenden Indizes ..................................................................................... 89Identifizieren von ungenutzten Indizes .................................................................................. 89

    Bewährte Sicherheitsmethoden ................................................................................................... 89Kostenoptimierung ..................................................................................................................... 90Verwendung von Metriken zur Identifizierung von Problemen mit der Leistung .................................... 90

    Anzeigen von Leistungsmetriken ......................................................................................... 90Festlegen eines CloudWatch-Alarms .................................................................................... 91Auswerten von Leistungsmetriken ........................................................................................ 91Optimieren von Abfragen ................................................................................................... 92

    TTL- und Zeitreihen-Workloads ................................................................................................... 92Migrations ................................................................................................................................ 93Arbeiten mit Cluster-Parametergruppen ........................................................................................ 93Aggregation-Pipeline-Abfragen .................................................................................................... 93batchInsert und batchUpdate .............................................................................................. 93

    Funktionsunterschiede mit MongoDB ................................................................................................... 95Funktionelle Vorteile von Amazon DocumentDB ............................................................................ 95

    Implizite Transaktionen ...................................................................................................... 95Aktualisierung bzgl. der Funktionsunterschiede .............................................................................. 96

    Array-Indizierung ............................................................................................................... 96Multikey-Indizes ................................................................................................................ 97Null-Zeichen in Zeichenfolgen ............................................................................................. 98Rollenbasierte Zugriffssteuerung ........................................................................................ 98$regex Indizierung ........................................................................................................... 98Projektion für verschachtelte Dokumente .............................................................................. 98

    Funktionsunterschiede mit MongoDB ........................................................................................... 98Admin-Datenbanken und Sammlungen ................................................................................. 99cursormaxTimeMS ........................................................................................................... 99explain() .......................................................................................................................... 99Einschränkungen für Feldnamen ........................................................................................ 99Indexerstellungen ............................................................................................................ 100Suche mit leerem Schlüssel im Pfad .................................................................................. 100MongoDB APIs, -Operationen und -Datentypen ................................................................... 100mongodump und mongorestore Dienstprogramme ............................................................ 100Ergebnissortierung ........................................................................................................... 101Wiederholbare Schreibvorgänge ........................................................................................ 101Sparse-Index .................................................................................................................. 101

    iv

  • Amazon DocumentDB Entwicklerhandbuch

    Speicherkomprimierung .................................................................................................... 102Verwendung von $elemMatch innerhalb eines $all-Ausdrucks ................................................ 102$distinct und $elemMatch Indizierung .......................................................................... 102$lookup ........................................................................................................................ 102

    Unterstützte MongoDB APIs, Operationen und Datentypen .................................................................... 106Datenbank-Befehle .................................................................................................................. 106

    Administrative Befehle ...................................................................................................... 107Aggregation .................................................................................................................... 107Authentication ................................................................................................................. 108Diagnose-Befehle ............................................................................................................ 108Abfrage- und Schreiboperationen ....................................................................................... 108Befehle zur Rollenverwaltung ............................................................................................ 109Sitzungsbefehle ............................................................................................................... 109Benutzerverwaltung ......................................................................................................... 110

    Abfrage- und Projektions-Operatoren .......................................................................................... 110Array-Operatoren ............................................................................................................. 110Bitwise-Operatoren .......................................................................................................... 111Kommentar-Operator ....................................................................................................... 111Vergleichsoperatoren ....................................................................................................... 111Element-Operatoren ......................................................................................................... 111Auswertungsabfrage-Operatoren ........................................................................................ 112Logische Operatoren ....................................................................................................... 112Projektions-Operatoren ..................................................................................................... 112

    Update-Operatoren .................................................................................................................. 112Array-Operatoren ............................................................................................................. 113Bitwise-Operatoren .......................................................................................................... 113Feld-Operatoren .............................................................................................................. 113Update-Modifikatoren ....................................................................................................... 114

    Geospatial .............................................................................................................................. 114Geometry-Spezifizierer ..................................................................................................... 114Abfrageauswahl .............................................................................................................. 114

    Cursor-Methoden ..................................................................................................................... 115Aggregation-Pipeline-Operatoren ............................................................................................... 116

    Akkumulator-Ausdrücke .................................................................................................... 116Arithmetische Operatoren ................................................................................................. 117Array-Operatoren ............................................................................................................. 117Boolesche Operatoren ..................................................................................................... 118Vergleichsoperatoren ....................................................................................................... 118Operatoren für bedingte Ausdrücke .................................................................................... 118Datentyp-Operator ........................................................................................................... 119Datums-Operatoren ......................................................................................................... 119Literal-Operator ............................................................................................................... 119Merge-Operator ............................................................................................................... 120Natürlicher Operator ........................................................................................................ 120Satzoperatoren ............................................................................................................... 120Stage-Operatoren ............................................................................................................ 120Zeichenfolgen-Operatoren ................................................................................................. 121Systemvariablen .............................................................................................................. 122Textsuche-Operatoren ...................................................................................................... 122Operatoren für die Typkonvertierung .................................................................................. 122Variablen Operatoren ....................................................................................................... 123

    Datentypen ............................................................................................................................. 123Indizes und Indexeigenschaften ................................................................................................. 124

    Indexes .......................................................................................................................... 124Indexeigenschaften .......................................................................................................... 124

    Migration zu Amazon DocumentDB .................................................................................................... 125Migrieren zwischen Versionen ................................................................................................... 125

    v

  • Amazon DocumentDB Entwicklerhandbuch

    Schritt 1: Aktivieren von Change Streams ........................................................................... 125Schritt 2: Ändern der Aufbewahrungsdauer für Change Streams ............................................. 126Schritt 3: Migrieren Ihrer Indizes ........................................................................................ 126Schritt 4: Erstellen einer AWS DMS-Replikations-Instance ..................................................... 127Schritt 5: Erstellen eines AWS DMS-Quellendpunkts ............................................................. 128Schritt 6: Erstellen eines AWS DMS-Zielendpunkts ............................................................... 130Schritt 7: Erstellen und Ausführen einer Migrationsaufgabe .................................................... 131Schritt 8: Ändern des Anwendungsendpunkts in den Amazon DocumentDB-Cluster 4.0 .............. 133

    Migrationstools ........................................................................................................................ 133AWS Database Migration Service ...................................................................................... 133Befehlszeilen-Dienstprogramme ......................................................................................... 133

    Discovery ............................................................................................................................... 134Planung: Amazon DocumentDB Cluster-Voraussetzungen ............................................................. 137Migrationsansätze .................................................................................................................... 139

    Offline ............................................................................................................................ 139Online ............................................................................................................................ 140Hybrid ............................................................................................................................ 141

    Migrationsquellen .................................................................................................................... 142Konnektivität bei der Migration .................................................................................................. 143Testing .................................................................................................................................. 145

    Migrationsplan – Überlegungen zum Test ............................................................................ 145Leistungstests ......................................................................................................................... 147Failover-Tests ......................................................................................................................... 147Weitere Ressourcen ................................................................................................................ 147

    Sicherheit ....................................................................................................................................... 149Datenschutz ........................................................................................................................... 149

    Verschlüsselung von -Daten im Ruhezustand ...................................................................... 150Datenverschlüsselung während der Übertragung .................................................................. 154Schlüsselverwaltung ........................................................................................................ 160

    Identitäts- und Zugriffsverwaltung ............................................................................................... 160Authentifizierung .............................................................................................................. 161Übersicht über die Verwaltung des Zugriffs ......................................................................... 162Verwalten des Zugriffs mit Richtlinien ................................................................................. 166Verwenden von identitätsbasierten Richtlinien (IAM-Richtlinien) .............................................. 166Referenzliste für Amazon DocumentDB-API-Berechtigungen .................................................. 170

    Verwalten von Amazon DocumentDB-Benutzern .......................................................................... 175Master- und serviceadmin-Benutzer ............................................................................... 175Erstellen weiterer Benutzer ............................................................................................... 175Automatisches Rotieren von Passwörtern ........................................................................... 177

    Rollenbasierte Zugriffssteuerung ................................................................................................ 177RBAC-Konzepte .............................................................................................................. 178Erste Schritte mit RBAC ................................................................................................... 179Herstellen einer Verbindung mit Amazon DocumentDB als Benutzer ....................................... 182Allgemeine Befehle .......................................................................................................... 183Funktionsunterschiede .................................................................................................... 185Limits ............................................................................................................................ 185Integrierte Rollen ............................................................................................................. 186

    Protokollieren und überwachen .................................................................................................. 191Aktualisieren von Zertifikaten .................................................................................................... 192

    Aktualisieren der Anwendung und des Amazon DocumentDB-Clusters ..................................... 192Troubleshooting .............................................................................................................. 195Häufig gestellte Fragen .................................................................................................... 195

    Compliance-Validierung ............................................................................................................ 201Ausfallsicherheit ...................................................................................................................... 202Sicherheit der Infrastruktur ........................................................................................................ 203Bewährte Sicherheitsmethoden ................................................................................................. 203Prüfereignisse ......................................................................................................................... 204

    vi

  • Amazon DocumentDB Entwicklerhandbuch

    Unterstützte Ereignisse .................................................................................................... 204Aktivieren des Prüfens ..................................................................................................... 205Deaktivieren des Prüfens .................................................................................................. 208Zugreifen auf Prüfereignisse ............................................................................................. 209

    Sichern und Wiederherstellen ............................................................................................................ 211Sichern und Wiederherstellen: Konzepte ..................................................................................... 211Grundlegendes zur Backup-Speicher-Nutzung ............................................................................ 213Dumping, Wiederherstellung, Import und Export von Daten ........................................................... 214

    mongodump ................................................................................................................... 214mongorestore ............................................................................................................. 214mongoexport ............................................................................................................... 215mongoimport ............................................................................................................... 215Praktische Anleitung ....................................................................................................... 216

    Überlegungen zum Cluster-Snapshot ......................................................................................... 217Sicherungsspeicher ......................................................................................................... 218Backup-Fenster ............................................................................................................... 218Aufbewahrungszeitraum für Backups .................................................................................. 219

    Vergleich von automatischen und manuellen Snapshots ............................................................... 219Erstellen eines manuellen Cluster-Snapshots ............................................................................. 221

    Erstellen eines Cluster-Snapshots mithilfe der AWS Management Console .............................. 221Erstellen eines Cluster-Snapshots mithilfe der AWS CLI ....................................................... 222

    Kopieren eines Cluster-Snapshots ............................................................................................. 223Kopieren freigegebener Snapshots .................................................................................... 223Kopieren von Snapshots über AWS-Regionen hinweg ........................................................... 224Einschränkungen ........................................................................................................... 224Verschlüsselungen ......................................................................................................... 224Überlegungen zu Parametergruppen ................................................................................. 224Kopieren eines Cluster-Snapshots ..................................................................................... 225

    Freigeben eines Cluster-Snapshots ........................................................................................... 230Freigeben eines verschlüsselten Snapshots ....................................................................... 230Freigeben eines Snapshots .............................................................................................. 232

    Wiederherstellen aus einem Cluster-Snapshot ............................................................................. 234Wiederherstellen eines Cluster-Snapshots mithilfe der AWS Management Console ................... 234Wiederherstellen eines Cluster-Snapshots mithilfe der AWS CLI ............................................ 236

    Wiederherstellen auf einen bestimmten Zeitpunkt ......................................................................... 239Wiederherstellen zu einem Zeitpunkt mithilfe der AWS Management Console ........................... 239Wiederherstellen zu einem Zeitpunkt mithilfe der AWS CLI .................................................... 241

    Löschen eines Cluster-Snapshots .............................................................................................. 243Löschen eines Cluster-Snapshots mithilfe der AWS Management Console .............................. 243Löschen eines Cluster-Snapshots mithilfe der AWS CLI ....................................................... 244

    Verwalten von Amazon DocumentDB ................................................................................................. 245Übersicht über operative Aufgaben ............................................................................................ 245

    Hinzufügen eines Replikats zu einem Amazon DocumentDB-Cluster ....................................... 245Beschreiben von Clustern und Instances ............................................................................ 246Erstellen eines Cluster-Snapshots ...................................................................................... 247Wiederherstellung aus einem Snapshot .............................................................................. 248Entfernen einer Instance aus einem Cluster ........................................................................ 249Löschen eines Clusters .................................................................................................... 249

    Verwalten von Clustern ............................................................................................................ 250Funktionsweise von Clustern ............................................................................................. 250Cluster-Einstellungen ....................................................................................................... 252Status eines Clusters bestimmen ....................................................................................... 254Cluster-Lebenszyklus ....................................................................................................... 255Skalierung von Amazon DocumentDB-Clustern .................................................................... 283Informationen zur Fehlertoleranz ........................................................................................ 285

    Verwalten von -Instances ......................................................................................................... 286Verwalten von Instance-Klassen ........................................................................................ 286

    vii

  • Amazon DocumentDB Entwicklerhandbuch

    Bestimmen des Status einer Instance ................................................................................. 291Instance-Lebenszyklus ..................................................................................................... 291

    Verwalten von -Subnetzgruppen ................................................................................................ 308Erstellen einer Subnetzgruppe ........................................................................................... 309Beschreiben einer Subnetzgruppe ..................................................................................... 313Ändern einer Subnetzgruppe ............................................................................................. 314Löschen einer Subnetzgruppe ........................................................................................... 317

    Hochverfügbarkeit und -Replikation ............................................................................................ 318Skalieren von Lesevorgängen ........................................................................................... 318Hohe Verfügbarkeit .......................................................................................................... 318Hinzufügen von -Replicas ................................................................................................. 319Failover ......................................................................................................................... 319Replikationsverzögerung ................................................................................................... 323

    Verwalten von Ereignissen ....................................................................................................... 324Anzeigen von Ereigniskategorien ....................................................................................... 324Anzeigen von Amazon DocumentDB-Ereignissen ................................................................. 326

    Auswählen von Regionen und Availability Zones .......................................................................... 328Verfügbarkeit in Regionen ................................................................................................ 329

    Verwalten von -Cluster-Parametergruppen .................................................................................. 330Beschreibung von -Cluster-Parametergruppen ..................................................................... 330Erstellen von -Cluster-Parametergruppen ............................................................................ 335Ändern von -Cluster-Parametergruppen .............................................................................. 337Ändern von -Clustern, um benutzerdefinierte Cluster-Parametergruppen zu verwenden ............... 340Kopieren von -Cluster-Parametergruppen ............................................................................ 341Zurücksetzen von -Cluster-Parametergruppen ...................................................................... 343Löschen von -Cluster-Parametergruppen ............................................................................ 345Referenz für Cluster-Parameter ......................................................................................... 347

    Grundlegendes zu -Endpunkten ................................................................................................. 354Suchen der Endpunkte eines Clusters ................................................................................ 354Suchen nach dem Endpunkt einer Instance ......................................................................... 356Verbindung mit Endpunkten herstellen ................................................................................ 359

    Erläuterung zu " Amazon DocumentDB ARNs ............................................................................. 360Erstellen eines ARN ........................................................................................................ 360Suchen eines ARNs ........................................................................................................ 362

    Markieren von Ressourcen ....................................................................................................... 364Übersicht über Ressourcen-Tags ....................................................................................... 364Tag-Einschränkungen ...................................................................................................... 365Hinzufügen oder Aktualisieren von Tags ............................................................................. 365Auflisten von Tags .......................................................................................................... 366Entfernen von Tags ......................................................................................................... 367

    Wartung von Amazon DocumentDB ........................................................................................... 368Bestimmen ausstehender Wartungsarbeiten ........................................................................ 369Anwenden von Updates ................................................................................................... 370Benutzerinitiierte Updates ................................................................................................. 372Verwalten der Wartungsfenster .......................................................................................... 373

    Grundlegendes zu serviceverknüpften Rollen .............................................................................. 374Berechtigungen von serviceverknüpften Rollen .................................................................... 375Erstellen einer serviceverknüpften Rolle .............................................................................. 376Ändern einer servicegebundenen Rolle ............................................................................... 376Löschen einer serviceverknüpften Rolle .............................................................................. 376Unterstützte Regionen für Amazon DocumentDB-serviceverknüpfte Rollen ............................... 377

    Überwachen von Amazon DocumentDB ............................................................................................. 378Überwachen des Status eines Clusters ....................................................................................... 379

    Cluster-Statuswerte ......................................................................................................... 379Überwachen des Status eines Clusters mit der AWS Management Console .............................. 380Überwachen des Status eines Clusters mit der AWS CLI ....................................................... 381

    Überwachung des Status einer -Instance .................................................................................... 382

    viii

  • Amazon DocumentDB Entwicklerhandbuch

    Instance-Statuswerte ........................................................................................................ 382Überwachung des Status einer Instance über die AWS Management Console ........................... 384Überwachung des Status einer Instance über die AWS CLI ................................................... 385

    Überwachen von Amazon DocumentDB mit CloudWatch ............................................................... 385Amazon DocumentDB-Metriken ......................................................................................... 386Anzeigen von CloudWatch-Daten ....................................................................................... 395Amazon DocumentDB-Dimensionen ................................................................................... 399Überwachen von Opcountern ............................................................................................ 400Überwachen von Datenbankverbindungen ........................................................................... 400

    Protokollieren von Amazon DocumentDB-API-Aufrufen mit CloudTrail .............................................. 400Amazon DocumentDB-Informationen in CloudTrail ................................................................ 401

    Profiling Operations ................................................................................................................. 401Supported Operations ...................................................................................................... 402Limitations ...................................................................................................................... 402Enabling the Profiler ........................................................................................................ 402Disabling the Profiler ....................................................................................................... 406Disabling Profiler Logs Export ........................................................................................... 406Accessing Your Profiler Logs ............................................................................................ 408Common Queries ............................................................................................................ 408

    Entwickeln mit Amazon DocumentDB ................................................................................................. 410Programmgesteuertes Verbinden ............................................................................................... 410

    Bestimmen des tls-Wertes .............................................................................................. 410Verbindung bei aktiviertem TLS herstellen ........................................................................... 412Verbinden bei deaktiviertem TLS ....................................................................................... 421

    Verwenden von Change Streams .............................................................................................. 427Unterstützte -Vorgänge .................................................................................................... 428Billing ............................................................................................................................ 428Limitations ...................................................................................................................... 428Aktivieren von Change Streams ........................................................................................ 429Beispiel .......................................................................................................................... 430Vollständige Dokumentsuche ............................................................................................ 432Wiederaufnahme eines Change Streams ............................................................................ 432Fortsetzen eines Change Streams mit startAtOperationTime ........................................... 434Transaktionen in Change Streams ..................................................................................... 435Ändern des Aufbewahrungszeitraums für das Change Stream-Protokoll ................................... 435

    Herstellen einer Verbindung als Replikatsatz ............................................................................... 437Verwenden von Cluster-Verbindungen ................................................................................ 440Mehrere Verbindungspools ............................................................................................... 440Summary ....................................................................................................................... 441

    Verbindung von außerhalb einer Amazon VPC herstellen .............................................................. 441Herstellen einer Verbindung mit Robo 3T .................................................................................... 442

    Voraussetzungen ............................................................................................................. 442Herstellen einer Verbindung mit Robo 3T ............................................................................ 442

    Herstellen einer Verbindung mit Studio 3T .................................................................................. 445Voraussetzungen ............................................................................................................. 442Herstellen einer Verbindung mit Studio 3T .......................................................................... 445

    Verbindung über Amazon EC2 .................................................................................................. 451Prerequisites .................................................................................................................. 451Schritt 1: Erstellen einer Amazon EC2-Instance ................................................................... 452Schritt 2: Erstellen einer Sicherheitsgruppe ......................................................................... 456Schritt 3: Erstellen eines Amazon DocumentDB-Clusters ....................................................... 459Schritt 4: Verbinden mit Ihrer Amazon EC2-Instance ............................................................. 460Schritt 5: Installieren der mongo-Shell ................................................................................ 462Schritt 6: Verwalten von Amazon DocumentDB-TLS ............................................................. 463Schritt 7: Herstellen einer Verbindung mit Ihrem Amazon DocumentDB-Cluster ......................... 463Schritt 8: Einfügen und Abfragen von Daten .......................................................................... 44Schritt 9: Entdecken ........................................................................................................ 466

    ix

  • Amazon DocumentDB Entwicklerhandbuch

    Kontingente und Einschränkungen ..................................................................................................... 467Unterstützte -Instance-Typen ..................................................................................................... 467Unterstützte Regionen .............................................................................................................. 468Regionale Kontingente ............................................................................................................. 468Aggregationsbeschränkungen .................................................................................................... 470Cluster-Beschränkungen ........................................................................................................... 470Instance-Limits ........................................................................................................................ 471Benennungseinschränkungen .................................................................................................... 472TTL-Einschränkungen .............................................................................................................. 473

    Abfragen ........................................................................................................................................ 474Abfragen von Dokumenten ....................................................................................................... 474

    Abrufen aller Dokumente .................................................................................................. 483Übereinstimmende Feldwerte ............................................................................................ 483Eingebettete Dokumente .................................................................................................. 483Feldwerte in eingebetteten Dokumenten ............................................................................. 484Abgleichen eines Arrays ................................................................................................... 484Abgleichen von Werten in einem Array ............................................................................... 484Verwenden von Operatoren .............................................................................................. 485

    Abfrageplan ............................................................................................................................ 485Abfrageplan .................................................................................................................... 485Abfrageplan-Cache .......................................................................................................... 486

    Explain-Ergebnisse .................................................................................................................. 486Scan- und Filterphase ...................................................................................................... 487Index-Überschneidung ...................................................................................................... 488Index -Vereinigung .......................................................................................................... 488Mehrfach-Index-Überschneidung/-Union .............................................................................. 489Verbundindex ................................................................................................................. 489Sortierphase ................................................................................................................... 490Group Stage (Gruppenphase) ........................................................................................... 490

    Fehlersuche .................................................................................................................................... 491Verbindungsprobleme .............................................................................................................. 491

    Verbindung zu einem Amazon DocumentDB Endpunkt kann nicht hergestellt werden ................. 491Testen einer Verbindung zu einer Amazon DocumentDB-Instance .......................................... 493Herstellen einer Verbindung mit einem ungültigen Endpunkt .................................................. 494

    Index-Erstellung ...................................................................................................................... 494Indexaufbau schlägt fehl ................................................................................................... 495Probleme mit der Hintergrundindexerstellungslatenz und Fehler ............................................. 495

    Leistung und Ressourcennutzung .............................................................................................. 495Finden und Beenden von langsamen und blockierten Abfragen? ............................................. 496Anzeigen eines Abfrageplans und Optimieren einer Abfrage .................................................. 497Auflisten aller aktuell auf einer Instance ausgeführten Operationen .......................................... 498Ermitteln, wann eine Abfrage Fortschritte macht ................................................................... 500Ermitteln, warum ein System plötzlich langsam ausgeführt wird .............................................. 502Ermitteln der Ursache einer hohen CPU-Nutzung ................................................................. 503Wie kann ich die offenen Cursor auf einer Instance ermitteln? ................................................ 504Wie kann ich die aktuelle Amazon DocumentDB Engine-Version ermitteln? .............................. 504Wie identifiziere ich nicht ungenutzte Indizes? ..................................................................... 504Wie identifiziere ich fehlende Indizes? ................................................................................ 505Zusammenfassung der produktiven Abfragen ...................................................................... 506

    API-Referenz für die Ressourcenverwaltung ........................................................................................ 508Actions .................................................................................................................................. 508

    AddTagsToResource ....................................................................................................... 510ApplyPendingMaintenanceAction ....................................................................................... 512CopyDBClusterParameterGroup ........................................................................................ 514CopyDBClusterSnapshot .................................................................................................. 516CreateDBCluster ............................................................................................................. 520CreateDBClusterParameterGroup ...................................................................................... 526

    x

  • Amazon DocumentDB Entwicklerhandbuch

    CreateDBClusterSnapshot ................................................................................................ 528CreateDBInstance ........................................................................................................... 530CreateDBSubnetGroup ..................................................................................................... 534DeleteDBCluster .............................................................................................................. 536DeleteDBClusterParameterGroup ....................................................................................... 538DeleteDBClusterSnapshot ................................................................................................. 539DeleteDBInstance ............................................................................................................ 541DeleteDBSubnetGroup ..................................................................................................... 543DescribeCertificates ......................................................................................................... 545DescribeDBClusterParameterGroups .................................................................................. 547DescribeDBClusterParameters .......................................................................................... 549DescribeDBClusters ......................................................................................................... 551DescribeDBClusterSnapshotAttributes ................................................................................ 553DescribeDBClusterSnapshots ............................................................................................ 555DescribeDBEngineVersions ............................................................................................... 558DescribeDBInstances ....................................................................................................... 561DescribeDBSubnetGroups ................................................................................................ 563DescribeEngineDefaultClusterParameters ........................................................................... 565DescribeEventCategories .................................................................................................. 567DescribeEvents ............................................................................................................... 568DescribeOrderableDBInstanceOptions ................................................................................ 571DescribePendingMaintenanceActions ................................................................................. 573FailoverDBCluster ............................................................................................................ 575ListTagsForResource ....................................................................................................... 577ModifyDBCluster ............................................................................................................. 579ModifyDBClusterParameterGroup ....................................................................................... 584ModifyDBClusterSnapshotAttribute ..................................................................................... 586ModifyDBInstance ............................................................................................................ 588ModifyDBSubnetGroup ..................................................................................................... 592RebootDBInstance ........................................................................................................... 594RemoveTagsFromResource .............................................................................................. 596ResetDBClusterParameterGroup ........................................................................................ 598RestoreDBClusterFromSnapshot ........................................................................................ 600RestoreDBClusterToPointInTime ........................................................................................ 605StartDBCluster ................................................................................................................ 610StopDBCluster ................................................................................................................ 612

    Data Types ............................................................................................................................ 613AvailabilityZone ............................................................................................................... 614Certificate ....................................................................................................................... 615CloudwatchLogsExportConfiguration ................................................................................... 617DBCluster ...................................................................................................................... 618DBClusterMember ........................................................................................................... 623DBClusterParameterGroup ................................................................................................ 624DBClusterRole ................................................................................................................ 625DBClusterSnapshot ......................................................................................................... 626DBClusterSnapshotAttribute .............................................................................................. 629DBClusterSnapshotAttributesResult .................................................................................... 630DBEngineVersion ............................................................................................................ 631DBInstance ..................................................................................................................... 633DBInstanceStatusInfo ....................................................................................................... 637DBSubnetGroup .............................................................................................................. 638Endpoint ........................................................................................................................ 640EngineDefaults ................................................................................................................ 641Event ............................................................................................................................. 642EventCategoriesMap ........................................................................................................ 644Filter .............................................................................................................................. 645OrderableDBInstanceOption .............................................................................................. 646

    xi

  • Amazon DocumentDB Entwicklerhandbuch

    Parameter ...................................................................................................................... 648PendingCloudwatchLogsExports ........................................................................................ 650PendingMaintenanceAction ............................................................................................... 651PendingModifiedValues .................................................................................................... 653ResourcePendingMaintenanceActions ................................................................................ 656Subnet ........................................................................................................................... 657Tag ............................................................................................................................... 658UpgradeTarget ................................................................................................................ 659VpcSecurityGroupMembership ........................................................................................... 660

    Common Errors ...................................................................................................................... 660Common Parameters ............................................................................................................... 662

    Versionshinweise ............................................................................................................................. 66415. Januar 2021 ...................................................................................................................... 664

    Neue Funktionen ............................................................................................................. 6649. November 2020 ................................................................................................................... 665

    Neue Funktionen ............................................................................................................. 665Fehlerbehebungen und andere Änderungen ........................................................................ 665

    30. Oktober 2020 .................................................................................................................... 666Neue Funktionen ............................................................................................................. 666Fehlerbehebungen und andere Änderungen ........................................................................ 666

    22. September 2020 ................................................................................................................ 667Neue Funktionen ............................................................................................................. 667Fehlerbehebungen und andere Änderungen ........................................................................ 667

    10. Juli 2020 ........................................................................................................................... 667Neue Funktionen ............................................................................................................. 667Fehlerbehebungen und andere Änderungen ........................................................................ 667

    30. Juni 2020 .......................................................................................................................... 667Neue Funktionen ............................................................................................................. 667Fehlerbehebungen und andere Änderungen ........................................................................ 667

    Dokumentverlauf ............................................................................................................................. 669................................................................................................................................................ dclxxvi

    xii

  • Amazon DocumentDB EntwicklerhandbuchÜbersicht

    Was ist Amazon DocumentDB (mitMongoDB-Kompatibilität)

    Amazon DocumentDB (mit MongoDB-Kompatibilität) ist ein schneller, zuverlässiger und vollständigverwalteter Datenbankservice. Amazon DocumentDB vereinfacht das Einrichten, Betreiben und Skalierenvon MongoDB-kompatiblen Datenbanken in der Cloud. Mit Amazon DocumentDB können Sie denselbenAnwendungscode ausführen und dieselben Treiber und Tools verwenden, die Sie mit MongoDBverwenden.

    Bevor Sie Amazon DocumentDB verwenden, sollten Sie sich mit den Konzepten und Funktionen vertrautmachen, die in So funktioniert es (p. 7) beschrieben sind. Anschließend führen Sie die Schritte unterLeitfaden „Erste Schritte“ (p. 33) aus.

    Themen• Übersicht über Amazon DocumentDB (p. 1)• Clusters (p. 2)• Instances (p. 3)• Regionen und Availability Zones (p. 4)• Amazon DocumentDB-Preise (p. 5)• Monitoring (p. 6)• Interfaces (p. 6)• Die nächsten Themen (p. 7)• Amazon DocumentDB: Funktionsweise (p. 7)• Was ist eine Dokumentdatenbank? (p. 18)

    Übersicht über Amazon DocumentDBIm Folgenden sind einige High-Level-Funktionen von Amazon DocumentDB aufgelistet:

    • Amazon DocumentDB steigert automatisch die Größe Ihres Speicher-Volumes entsprechend Ihrerwachsenden Anforderungen an den Datenbankspeicher. Ihr Speicher-Volume wird in 10 GB-Schrittenbis maximal 64 TB gesteigert. Sie müssen in Hinblick auf zukünftiges Wachstum keinen zusätzlichenSpeicher für Ihren Cluster bereitstellen.

    • Mit Amazon DocumentDB können Sie den Lesedurchsatz erhöhen, um Anwendungsanforderungen mithohem Datenaufkommen zu unterstützen, indem Sie bis zu 15 Replica-Instances erstellen. AmazonDocumentDB-Replicas nutzen denselben zugrunde liegenden Speicher. So können die Kosten gesenktund auf das Kopieren von Daten auf die Replica-Knoten verzichtet werden. Diese Funktion setzt einegrößere Verarbeitungsleistung für Leseanforderungen frei und reduziert die Verzögerung bei derReplizierung—häufig bis in den einstelligen Millisekundenbereich. Sie können innerhalb von MinutenReplicas hinzufügen, unabhängig von der Speicher-Volume-Größe. Amazon DocumentDB bietetauch einen Leserendpunkt, sodass die Anwendung verbunden werden kann, ohne dass die Replicasnachverfolgt werden müssen, die hinzugefügt oder entfernt werden.

    • Mit Amazon DocumentDB können Sie die Rechen- und Speicherkapazitäten für jede Ihrer Instancesnach oben oder unten skalieren. Skalierungsvorgänge bei der Datenverarbeitung dauern in der Regel nurwenige Minuten.

    1

  • Amazon DocumentDB EntwicklerhandbuchClusters

    • Amazon DocumentDB wird in Amazon Virtual Private Cloud (Amazon VPC) ausgeführt. So können SieIhre Datenbank in Ihrem eigenen virtuellen Netzwerk isolieren. Sie können auch Firewalleinstellungen sokonfigurieren, dass der Netzwerkzugriff auf Ihren Cluster gesteuert wird.

    • Amazon DocumentDB überwacht kontinuierlich den Zustand Ihres Clusters. Bei einem Instance-Ausfallstartet Amazon DocumentDB automatisch die Instance und die dazugehörigen Prozesse neu. AmazonDocumentDB erfordert keine Absturzwiederherstellungswiedergabe von Datenbank-Redo-Logs, somitwird die Dauer des Neustarts enorm reduziert. Amazon DocumentDB isoliert auch den Datenbank-Cachevom Datenbankprozess, sodass der Cache auch bei einem Neustart erhalten bleibt.

    • Beim Ausfall einer Instance automatisiert Amazon DocumentDB ein Failover zu einer von bis zu 15Amazon DocumentDB-Replicas, die Sie in anderen Availability Zones erstellen. Wenn keine Replicasbereitgestellt wurden und ein Fehler auftritt, versucht Amazon DocumentDB automatisch eine neueAmazon DocumentDB-Instance zu erstellen.

    • Die Backup-Funktion in Amazon DocumentDB aktiviert die zeitpunktbezogene Wiederherstellungfür Ihren Cluster. Diese Funktion ermöglicht Ihnen, Ihren Cluster zu jeder Sekunde innerhalbder Aufbewahrungsfrist bis zu den letzten 5 Minuten wiederherzustellen. Sie können denAufbewahrungszeitraum für automatische Backups auf maximal 35 Tage festlegen. AutomatisierteSicherungen werden in Amazon Simple Storage Service (Amazon S3) gespeichert, einem Service, derfür eine Beständigkeit von 99,999999999 % ausgelegt ist. Amazon DocumentDB-Sicherungen sindautomatisch, inkrementell und fortlaufend, und haben keine Auswirkungen auf Ihre Cluster-Leistung.

    • Mit Amazon DocumentDB können Sie Ihre Datenbanken verschlüsseln. Die hierzu benötigten Schlüsselerstellen und kontrollieren Sie mit AWS Key Management Service (AWS KMS). Auf einem Datenbank-Cluster, der mit Amazon DocumentDB-Verschlüsselung ausgeführt wird, werden die im zugrundeliegenden Speicher gespeicherten Daten verschlüsselt. Die automatischen Sicherungen, Snapshots undReplicas im gleichen Cluster werden ebenfalls verschlüsselt.

    Wenn Sie noch keine Erfahrung mit AWS-Services haben, verwenden Sie die folgenden Ressourcen, umweitere Informationen zu erhalten:

    • AWS bietet Services für Datenverarbeitung, Datenbanken, Speicher, Analysen und andere Funktionen.Einen Überblick über alle AWS-Services finden Sie unter Cloud Computing mit Amazon Web Services.

    • AWS bietet eine Reihe von Datenbankdiensten an. Um zu erfahren, welcher Service für Ihre Umgebungam besten geeignet ist, lesen Sie Datenbanken in AWS.

    ClustersEin Cluster besteht aus 0 bis 16 Instances und einem Cluster-Speicher-Volume, das die Daten für dieseInstances verwaltet. Alle Schreibvorgänge erfolgen über die primäre Instance. Alle Instances (primäre undReplicas) unterstützen Lesevorgänge. Die Daten des Clusters werden im Cluster-Volume gespeichert, mitKopien in drei verschiedenen Availability Zones.

    2

    https://aws.amazon.com/what-is-aws/https://aws.amazon.com/products/databases/

  • Amazon DocumentDB EntwicklerhandbuchInstances

    InstancesEine Amazon DocumentDB-Instance ist eine isolierte Datenbankumgebung in der Cloud. Eine Instancekann mehrere von Benutzern erstellte Datenbanken enthalten. Sie können eine Instance erstellen undändern, indem Sie die AWS Management Consoleoder AWS CLI verwenden.

    Die Rechen- und Speicherkapazität einer Instance wird über deren Instance-Klasse festgelegt. Sie könnendie Instance auswählen, die Ihren Anforderungen am besten entspricht. Wenn sich Ihre Anforderungen imLaufe der Zeit ändern, können Sie eine andere Instance-Klasse wählen. Spezifikationen für DB-Instance-Klassen finden Sie unter Instance-Klassen-Spezifikationen (p. 290)

    Amazon DocumentDB-Instances werden nur in der Amazon VPC-Umgebung ausgeführt. Amazon VPCgibt Ihnen die Kontrolle über Ihre virtuelle Netzwerkumgebung: Sie können Ihren eigenen IP-Adressbereichauswählen, Subnetze erstellen sowie Routing- und Zugriffskontrolllisten (ACLs) konfigurieren.

    Bevor Sie Amazon DocumentDB-Instances erstellen können, müssen Sie einen Cluster für die Aufnahmevon Instances erstellen.

    Nicht alle Instance-Klassen werden in allen Regionen unterstützt. Die folgende Tabelle gibt an, welcheInstance-Klassen von in den jeweiligen Regionen unterstützt werden.

    Unterstützte Instance-Klassen nach Region

    Region R5 R4 T3

    USA Ost (Ohio) Unterstützt Unterstützt Unterstützt

    USA Ost (Nord-Virginia) Unterstützt Unterstützt Unterstützt

    USA West (Oregon) Unterstützt Unterstützt Unterstützt

    Südamerika (São Paulo) Unterstützt Unterstützt

    Asien-Pazifik (Mumbai) Unterstützt Unterstützt

    3

  • Amazon DocumentDB EntwicklerhandbuchRegionen und AZs

    Region R5 R4 T3

    Asien-Pazifik (Seoul) Unterstützt Unterstützt

    Asien-Pazifik (Sydney) Unterstützt Unterstützt

    Asien-Pazifik (Singapur) Unterstützt Unterstützt

    Asien-Pazifik (Tokio) Unterstützt Unterstützt

    Kanada (Zentral) Unterstützt Unterstützt

    Europa (Frankfurt) Unterstützt Unterstützt

    Europa (Irland) Unterstützt Unterstützt Unterstützt

    Europa (London) Unterstützt Unterstützt

    Europa (Paris) Unterstützt Unterstützt

    AWS GovCloud (US) Unterstützt Unterstützt

    Regionen und Availability ZonesRegionen und Availability Zones definieren die physischen Standorte und Instances Ihres Clusters.

    RegionsAWS Cloud Computing-Ressourcen sind in hochverfügbaren Rechenzentren in verschiedenen Regionender Welt untergebracht (zum Beispiel in Nordamerika, Europa oder Asien). Jeder Rechenzentrumsstandortwird als Region bezeichnet.

    Jede AWS-Region ist so ausgelegt, dass sie vollständig von den anderen AWS-Regionen getrennt ist.Innerhalb jeder gibt es mehrere Availability Zones (Verfügbarkeitszonen). Durch das Starten Ihrer Knoten inverschiedenen Availability Zones können Sie eine größtmögliche Fehlertoleranz zu erreichen. Im folgendenDiagramm sehen Sie eine allgemeine Übersicht, wie AWS-Regionen und Availability Zones funktionieren.

    Availability ZonesJede AWS-Region verfügt über mehrere eigene Standorte, die als Availability Zones bezeichnet werden.Jede Availability Zone wurde so konzipiert, dass sie von Fehlern in anderen Availability Zones isoliertist und eine kostengünstige Netzwerkverbindung mit geringer Latenz zu anderen Availability Zones inderselben Region bereitstellt. Indem Instances für einen bestimmten Cluster in mehreren Availability Zonesgestartet werden, können Sie Ihre Anwendungen vor dem unwahrscheinlichen Fall des Fehlschlagenseiner Availability Zone schützen.

    4

  • Amazon DocumentDB EntwicklerhandbuchPreise

    Die Amazon DocumentDB-Architektur trennt Rechen- und Speicherkapazitäten. Für die Speicherebenerepliziert Amazon DocumentDB sechs Kopien Ihrer Daten in drei AWS Availability Zones. Wenn Siebeispielsweise einen Amazon DocumentDB-Cluster in einer Region starten, die nur zwei AvailabilityZones unterstützt, wird der Datenspeicher zwar sechsfach in drei Availability Zones repliziert, IhreDatenverarbeitungs-Instances sind jedoch nur in zwei Availability Zones verfügbar.

    In der folgenden Tabelle ist die Anzahl der Availability Zones aufgeführt, die Sie in einer bestimmten AWS-Region zum Bereitstellen von Datenverarbeitungs-Instances für Ihren Cluster verwenden können.

    Name der Region Region Availability Zones (Datenverarbeitung)

    USA Ost (Ohio) us-east-2 3

    USA Ost (Nord-Virginia) us-east-1 6

    USA West (Oregon) us-west-2 4

    Südamerika (São Paulo) sa-east-1 3

    Asien-Pazifik (Mumbai) ap-south-1 3

    Asien-Pazifik (Seoul) ap-northeast-2 4

    Asien-Pazifik (Singapur) ap-southeast-1 3

    Asien-Pazifik (Sydney) ap-southeast-2 3

    Asien-Pazifik (Tokio) ap-northeast-1 3

    Kanada (Zentral) ca-central-1 3

    Europa (Frankfurt) eu-central-1 3

    Europa (Irland) eu-west-1 3

    Europa (London) eu-west-2 3

    Europa (Paris) eu-west-3 3

    AWS GovCloud (US) us-gov-west-1 3

    Amazon DocumentDB-PreiseAmazon DocumentDB-Cluster werden auf Grundlage der folgenden Komponenten abgerechnet. AmazonDocumentDB verfügt derzeit nicht über ein kostenloses Kontingent, sodass das Erstellen eines Clusters mitKosten verbunden ist.

    • Instance-Stunden (pro Stunde)—Basierend auf der Instance-Klasse der Instance (zum Beispieldb.r5.xlarge). Die Preise werden immer noch auf Stundenbasis aufgeführt, aber Rechnungen werdenjetzt sekundengenau erstellt und zeigen die Zeiten im Dezimalformat an. Die Abrechnung der AmazonDocumentDB-Nutzung erfolgt in Schritten von einer Sekunde, mit einer Mindestlaufzeit von 10 Minuten.Weitere Informationen finden Sie unter Verwalten von Instance-Klassen (p. 286).

    • E/A-Anforderungen (pro 1 Million Anforderungen pro Monat) — Gesamtzahl der Speicher-E/A-Anforderungen, die Sie in einem Abrechnungszeitraum vornehmen.

    • Backup-Speicher (pro GiB und Monat) — Backup-Speicher ist der Speicher, der automatisiertenDatenbanksicherungen und allen aktiven Datenbank-Snapshots zugeordnet ist, die Sie erstellt haben.Wenn Sie die Aufbewahrungszeit Ihrer Backups erhöhen oder zusätzliche Datenbank-Snapshotserstellen, belegt Ihre Datenbank dementsprechend mehr Backup-Speicher. Der Backup-Speicher wird

    5

  • Amazon DocumentDB EntwicklerhandbuchMonitoring

    in GB-Monaten abgerechnet, die sekundengenaue Abrechnung wird hier nicht angewandt. WeitereInformationen finden Sie unter Sichern und Wiederherstellen in Amazon DocumentDB (p. 211).

    • Datenübertragung (pro GB) Datenübertragung in und aus Ihrer Instance aus dem oder in das Internetoder andere AWS-Regionen.—

    Weitere Informationen hierzu finden Sie unter Amazon DocumentDB (mit MongoDB-Kompatibilität)Preise.

    MonitoringEs gibt verschiedene Möglichkeiten, die Leistung und den Zustand einer Instance zu überwachen. Siekönnen mit dem kostenlosen Amazon CloudWatch-Service die Leistung und den Zustand einer Instanceüberwachen. Leistungsdiagramme finden Sie in der Amazon DocumentDB-Konsole. Sie können AmazonDocumentDB-Ereignisse abonnieren, um benachrichtigt zu werden, wenn Änderungen bei einer Instance,einem Snapshot, einer Parametergruppe oder einer Sicherheitsgruppe auftreten.

    Weitere Informationen finden Sie unter:

    • Überwachen von Amazon DocumentDB mit CloudWatch (p. 385)• Protokollieren von Amazon DocumentDB-API-Aufrufen mit AWS CloudTrail (p. 400)

    InterfacesEs gibt mehrere Möglichkeiten, wie Sie mit Amazon DocumentDB interagieren können, darunter die AWSManagement Console und die AWS CLI.

    AWS Management ConsoleDie AWS Management Console ist eine einfache, webbasierte Benutzeroberfläche. Sie können Ihre Clusterund Instances von der Konsole aus verwalten, ohne dass eine Programmierung erforderlich ist. Melden Siesich bei der AWS Management Console an und öffnen Sie die Amazon DocumentDB-Konsole unter https://console.aws.amazon.com/docdb, um auf die Amazon DocumentDB-Konsole zuzugreifen.

    AWS CLISie können auch mithilfe der AWS Command Line Interface (AWS CLI) Ihre Amazon DocumentDB-Clusterund Instances verwalten. Mit nur minimalem Konfigurationsaufwand können Sie die gesamte Funktionalitätnutzen, die von der Amazon DocumentDB-Konsole aus dem von Ihnen bevorzugten Terminal-Programmbereitgestellt wird.

    • Informationen zum Installieren der AWS CLI finden Sie unter Installieren der AWS-Befehlszeilenschnittstelle.

    • Informationen zur Verwendung der AWS CLI für Amazon DocumentDB finden Sie in der AWS-Befehlszeilenschnittstellenreferenz für Amazon DocumentDB.

    Die mongo-ShellUm eine Verbindung zu Ihrem Cluster herzustellen, um Dokumente in Ihren Datenbanken zu erstellen,zu lesen, zu aktualisieren und zu löschen, können Sie die mongo-Shell bei Amazon DocumentDBverwenden. Informationen zum Herunterladen und Installieren der mongo 4.0-Shell finden Sie unter Schritt4: Installieren der mongo-Shell (p. 42).

    6

    https://aws.amazon.com/documentdb/pricing/https://console.aws.amazon.com/docdbhttps://console.aws.amazon.com/docdbhttps://docs.aws.amazon.com/cli/latest/userguide/installing.htmlhttps://docs.aws.amazon.com/cli/latest/userguide/installing.htmlhttps://docs.aws.amazon.com/cli/latest/reference/docdb/index.htmlhttps://docs.aws.amazon.com/cli/latest/reference/docdb/index.html

  • Amazon DocumentDB EntwicklerhandbuchMongoDB-Treiber

    MongoDB-TreiberZum Entwickeln und Schreiben von Anwendungen für einen Amazon DocumentDB-Cluster können Sieauch die MongoDB-Treiber mit Amazon DocumentDB verwenden.

    Die nächsten ThemenDer vorhergehende Abschnitt hat Ihnen die grundlegenden Infrastrukturkomponenten von AmazonDocumentDB vorgestellt. Was sollten Sie als nächstes tun? Sehen Sie sich entsprechend Ihrer Situationzum Einstieg eines der folgenden Themen an.

    • Erste Schritte mit Amazon DocumentDB durch Erstellen eines Clusters und einer Instance mithilfe vonAWS CloudFormation Amazon DocumentDB – Schnellstart mit AWS CloudFormation (p. 46).

    • Führen Sie die ersten Schritte mit Amazon DocumentDB durch, indem Sie einen Cluster und eineInstance erstellen. Befolgen Sie hierzu die Anweisungen in unserem Leitfaden „Erste Schritte“ (p. 33).

    • Migrieren Ihrer MongoDB-Implementierung zu Amazon DocumentDB mithilfe der Anleitung unterMigration zu Amazon DocumentDB (p. 125)

    Amazon DocumentDB: FunktionsweiseAmazon DocumentDB (mit MongoDB-Kompatibilität) ist ein vollständig verwalteter, MongoDB-kompatiblerDatenbankservice. Mit Amazon DocumentDB können Sie denselben Anwendungscode ausführen unddieselben Treiber und Tools verwenden, die Sie mit MongoDB verwenden. Amazon DocumentDB ist mitMongoDB 3.6 und 4.0 kompatibel.

    Themen• Amazon DocumentDB-Endpunkte (p. 8)• TLS Support (p. 11)• Amazon DocumentDB-Speicher (p. 11)• Amazon DocumentDB-Replikation (p. 12)• Zuverlässigkeit von Amazon DocumentDB (p. 12)• Leseeinstellungsoptionen (p. 13)• TTL löscht (p. 16)• Gebührenpflichtige Ressourcen (p. 16)

    Wenn Sie Amazon DocumentDB verwenden, erstellen Sie zunächst einen Cluster. Ein DB-Cluster bestehtaus null oder mehreren Datenbank-Instances und einem Cluster-Volume, das die Daten für diese Instancesverwaltet. Ein Amazon DocumentDB Cluster-Volume ist ein virtuelles Datenbankspeicher-Volume, das sichüber mehrere Availability Zones erstreckt. Jede Availability Zone verfügt über eine Kopie der Cluster-Daten.

    Ein Amazon DocumentDB-Cluster besteht aus zwei Komponenten:

    • Cluster-Volume—Verwendet einen Cloud-basierten Speicherservice, um Daten auf sechs Arten überdrei Availability Zones zu replizieren und so sehr robusten und verfügbaren Speicher bereitzustellen. EinAmazon DocumentDB-Cluster hat genau ein Cluster-Volume, das bis zu 64 TB Daten speichern kann.

    • -Instances—Stellen die Rechenleistung für die Datenbank bereit, schreiben Daten in das Cluster-Speicher-Volume und lesen Daten aus dem Cluster-Speicher-Volume. Ein Amazon DocumentDB-Clusterdarf höchstens 0–16 Instances haben.

    Instances erfüllen eine von zwei Rollen:

    7

  • Amazon DocumentDB EntwicklerhandbuchAmazon DocumentDB-Endpunkte

    • Primary instance (Primäre Instance) Unterstützt Lese- und Schreiboperationen und führt alleDatenänderungen am Cluster-Volume durch.— Jedes Amazon DocumentDB-Cluster verfügt über eineprimäre Instance.

    • Replica-Instance unterstützt nur Lesevorgänge.— Ein Amazon DocumentDB-Cluster kann neben derprimären Instance auch bis zu 15 Replikate haben. Die Verwendung mehrerer Replikate ermöglichtes Ihnen, die Leseauslastungen zu verteilen. Darüber hinaus erhöhen Sie durch die Platzierung vonReplikaten in separaten Availability Zones auch die Cluster-Verfügbarkeit.

    Das folgende Diagramm veranschaulicht die Beziehung zwischen dem Cluster-Volume, der primärenInstance und den Replikaten in einem Amazon DocumentDB-Cluster:

    Cluster-Instances müssen nicht von derselben Instance-Klasse sein. Sie können beliebig bereitgestellt undbeendet werden. Mit dieser Architektur können Sie die Rechenkapazität Ihres Clusters unabhängig vonseiner Storage-Funktionalität skalieren.

    Wenn Ihre Anwendung Daten in die Primär-Instance schreibt, schreibt diese die