amazon documentdb - entwicklerhandbuch...amazon documentdb entwicklerhandbuch...
TRANSCRIPT
-
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