Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Amazon DocumentDB-Kompatibilität mit MongoDB
Amazon DocumentDB unterstützt MongoDB-Kompatibilität, einschließlich MongoDB 4.0, MongoDB 5.0 und MongoDB 8.0. MongoDB-Kompatibilität bedeutet, dass ein Großteil der Anwendungen, Treiber und Tools, die Sie heute bereits mit Ihren MongoDB-Datenbanken verwenden, mit nur geringen oder gar keinen Änderungen mit Amazon DocumentDB verwendet werden können. In diesem Abschnitt wird alles beschrieben, was Sie über die Kompatibilität von Amazon DocumentDB mit MongoDB wissen müssen, einschließlich neuer Funktionen und Funktionen, der ersten Schritte, der Migrationspfade und der Funktionsunterschiede.
Themen
MongoDB 8.0-Kompatibilität
Themen
Was ist neu in Amazon DocumentDB 8.0
Amazon DocumentDB 8.0 verbessert die Abfrageleistung um das bis zu 7-fache und das Komprimierungsverhältnis um das bis zu 5-fache, sodass Sie Hochleistungsanwendungen zu geringeren Kosten erstellen können. Amazon DocumentDB 8.0 ist vollständig mit MongoDB 8.0 kompatibel. In der folgenden Zusammenfassung werden einige der wichtigsten Funktionen vorgestellt, die in Amazon DocumentDB 8.0 eingeführt wurden. Eine vollständige Liste der neuen Funktionen finden Sie im Versionshinweise.
Bietet Kompatibilität mit MongoDB 8.0 durch Hinzufügen von Unterstützung für MongoDB 8.0-API-Treiber. Unterstützt auch Anwendungen, die mit den MongoDB-API-Versionen 6.0 und 7.0 erstellt wurden.
Der neue Abfrageplaner in Amazon DocumentDB 8.0 erweitert die Leistungsverbesserungen auf Operatoren der Aggregationsphase und unterstützt außerdem Optimierungen der Aggregationspipeline und verschiedene Befehle.
Amazon DocumentDB 8.0 unterstützt Sortierung und Ansichten.
Bietet 6 neue Aggregationsstufen: $replaceWith, $VectorSearch, $merge, $set, $unset, $bucket und 3 neue Aggregationsoperatoren $pow, $rand, $dateTrunc.
Eine neue Version des Textindex: Der Textindex v2 in Amazon DocumentDB 8.0 führt zusätzliche Token ein und erweitert so die Textsuchfunktionen.
Durch die parallele Erstellung von Vektorindizes reduziert Amazon DocumentDB 8.0 die Zeit für die Indexerstellung um das bis zu 30-fache.
Das Speicherlimit wurde auf 256 TiB erhöht.
Beginnen Sie mit Amazon DocumentDB 8.0
Informationen zu den ersten Schritten mit Amazon DocumentDB 8.0 finden Sie in der Erste Schritte mit Amazon DocumentDB. Sie können einen neuen Amazon DocumentDB 8.0-Cluster mit dem erstellen AWS-Managementkonsole oder der AWS SDK, AWS CLI, oder CloudFormation. Wenn Sie eine Verbindung zu Amazon DocumentDB herstellen, müssen Sie einen MongoDB-Treiber oder ein Programm verwenden, das mit MongoDB 5.0 oder höher kompatibel ist.
Bei der Verwendung von AWS SDK, AWS CLI, oder CloudFormation, die Engine-Version wird standardmäßig auf 5.0.0 gesetzt. Sie müssen den Parameter explizit angeben engineVersion = 8.0.0 um einen neuen Amazon DocumentDB 8.0-Cluster zu erstellen oder engineVersion = 4.0.0 um einen neuen Amazon DocumentDB 4.0-Cluster zu erstellen oder engineVersion = 3.6.0 um einen neuen Amazon DocumentDB 3.6-Cluster zu erstellen. Für einen bestimmten Amazon DocumentDB-Cluster können Sie die Cluster-Version mit dem AWS CLI um anzurufen describe-db-clusters oder verwenden Sie die Amazon DocumentDB-Managementkonsole, um die Engine-Versionsnummer für einen bestimmten Cluster anzuzeigen.
Amazon DocumentDB 5.0 und 8.0 unterstützen Amazon EC2 r8g Graviton4-Prozessor und Graviton2-Prozessoren wie r6g und t4.medium Instanztypen für Ihre Cluster und ist in allen unterstützten Versionen verfügbar AWS-Regionen (siehe Instances). Weitere Informationen zur Preisgestaltung finden Sie unter Preisgestaltung für Amazon DocumentDB (mit MongoDB-Kompatibilität)
Führen Sie ein Upgrade durch oder migrieren Sie auf Amazon DocumentDB 5.0 oder 8.0
Sie können von MongoDB 3.6 oder MongoDB 4.0 zu Amazon DocumentDB 5.0 oder Amazon DocumentDB 8.0 migrieren, indem Sie die AWS DMS
Funktionelle Unterschiede
Funktionale Unterschiede zwischen Amazon DocumentDB 5.0 und 8.0
Mit der Veröffentlichung von Amazon DocumentDB 8.0 gibt es funktionale Unterschiede zwischen Amazon DocumentDB 5.0 und Amazon DocumentDB 8.0:
-
Planner v1 ist der Standard-Abfrageplaner in Amazon DocumentDB 5.0, wohingegen der leistungsstärkere Planner v3 die Standardeinstellung in Amazon DocumentDB 8.0 ist.
-
Neue Funktionen in Amazon DocumentDB 8.0, darunter Views, Collation und Operatoren wie $merge, sind nur mit Planner v3 kompatibel.
-
Die Komprimierung ist in Amazon DocumentDB 8.0 standardmäßig aktiviert und auf die Verwendung des Zstandard-Algorithmus eingestellt. Darüber hinaus ist in Amazon DocumentDB 8.0
enabledist kein gültiger Wert mehr fürdefault_collection_compression. Die gültigen Werte sindzstd,lz4unddisabled. -
Amazon DocumentDB 8.0 unterstützt nur TLS 1.2 und höher für Datenbankverbindungen.
Amazon DocumentDB 8.0 benötigt TLS 1.2 oder höher. TLS 1.0 und TLS 1.1 werden nicht mehr unterstützt.
MongoDB 5.0-Kompatibilität
Themen
Was ist neu in Amazon DocumentDB 5.0
Amazon DocumentDB 5.0 führt neue Funktionen und Fähigkeiten ein, zu denen Speicherbeschränkungen und clientseitige Verschlüsselung auf Feldebene gehören. In der folgenden Zusammenfassung werden einige der wichtigsten Funktionen vorgestellt, die in Amazon DocumentDB 5.0 eingeführt wurden. Eine vollständige Liste der neuen Funktionen finden Sie im Versionshinweise.
Das Speicherlimit für alle instanzbasierten Amazon DocumentDB-Cluster und shard-basierten elastischen Cluster wurde auf 128 TiB erhöht.
Amazon DocumentDB 5.0 Engine (Version 3.0.775) eingeführt
Unterstützung für MongoDB 5.0-API-Treiber
Unterstützung für Client-side Verschlüsselung auf Feldebene (FLE). Sie können jetzt Felder auf der Clientseite verschlüsseln, bevor Sie die Daten in den Amazon DocumentDB-Cluster schreiben. Weitere Informationen finden Sie unter Client-side Verschlüsselung auf Feldebene.
Neue Aggregationsoperatoren:
$dateAdd,$dateSubtractUnterstützt Indizes mit
$elemMatchBetreiber. Das Ergebnis sind Abfragen mit$elemMatchwird zu Index-Scans führen.
Amazon DocumentDB unterstützt nicht alle MongoDB 5.0-Funktionen. Bei der Entwicklung von Amazon DocumentDB 5.0 haben wir von den Funktionen und Funktionen, um deren Entwicklung uns unsere Kunden am häufigsten gebeten haben, rückwärts gearbeitet. Wir werden weiterhin zusätzliche MongoDB 5.0-Funktionen hinzufügen, je nachdem, was unsere Kunden von uns erwarten. Die aktuelle Liste der unterstützten APIs finden Sie unter Unterstützte MongoDB-APIs, Operationen und Datentypen in Amazon DocumentDB.
Was ist neu in Amazon DocumentDB 5.0.1
Amazon DocumentDB 5.0.1 ist die erste Nebenversion für die Hauptversion von Amazon DocumentDB 5.0. Nebenversionen enthalten Verbesserungen wie neue Funktionen, Sicherheitsupdates und Bugfixes. Sie können mit einem Nebenversions-Upgrade von 5.0.0 auf 5.0.1 aktualisieren. Weitere Informationen finden Sie unter Upgrade der Nebenversion von Amazon DocumentDB.
Verbesserte Aggregationsfunktionen mit neuen Operatoren (
$rand,$pow,$dateToParts,$dateFromParts).Metrik für aktive Verbindungen zur Überwachung von Instanzen. Weitere Informationen finden Sie unter Kontingente für Instanzen.
Granulare Leistungsmetriken auf Befehlsebene in CloudWatch für CRUD-Operationen (
find,insert,findAndModify,update,delete,aggregate,count,distinct,getMore,abortTransaction,commitTransaction), belichtenAvgDuration,P100Duration, undMaxConcurrentAbmessungen für eine verbesserte Betriebsüberwachung.Amazon DocumentDB 5.0.1 unterstützt nur TLS 1.2 und höher für Datenbankverbindungen.
Hinzugefügt
gcRuntimeStats,documentFragmentStats, und Aufteilung der Metriken auf Sammlungsebene instorageSegmentBaseundstorageSegmentExtendedincollstatsum mehr Informationen über den allgemeinen Zustand des Müllsammelprozesses zu erhalten.
Beginnen Sie mit Amazon DocumentDB 5.0
Informationen zu den ersten Schritten mit Amazon DocumentDB 5.0 finden Sie in der Erste Schritte mit Amazon DocumentDB. Sie können einen neuen Amazon DocumentDB 5.0-Cluster mit dem erstellen AWS-Managementkonsole oder der AWS SDK, AWS CLI, oder CloudFormation. Wenn Sie eine Verbindung zu Amazon DocumentDB herstellen, müssen Sie einen MongoDB-Treiber oder ein Programm verwenden, das mit MongoDB 5.0 oder höher kompatibel ist.
Bei der Verwendung von AWS SDK, AWS CLI, oder CloudFormation, die Engine-Version wird standardmäßig auf 5.0.0 gesetzt. Sie müssen den Parameter explizit angeben engineVersion = 4.0.0 um einen neuen Amazon DocumentDB 4.0-Cluster zu erstellen oder engineVersion = 3.6.0 um einen neuen Amazon DocumentDB 3.6-Cluster zu erstellen. Für einen bestimmten Amazon DocumentDB-Cluster können Sie die Cluster-Version mit dem AWS CLI um anzurufen describe-db-clusters oder verwenden Sie die Amazon DocumentDB-Managementkonsole, um die Engine-Versionsnummer für einen bestimmten Cluster anzuzeigen.
Amazon DocumentDB 5.0 und 8.0 unterstützen Amazon EC2 r8g Graviton4-Prozessor und Graviton2-Prozessoren wie r6g und t4.medium Instanztypen für Ihre Cluster und ist in allen unterstützten Versionen verfügbar AWS-Regionen (siehe Instances). Weitere Informationen zur Preisgestaltung finden Sie unter Preisgestaltung für Amazon DocumentDB (mit MongoDB-Kompatibilität)
Führen Sie ein Upgrade auf Amazon DocumentDB 5.0 durch oder migrieren Sie
Sie können von MongoDB 3.6 oder MongoDB 4.0 zu Amazon DocumentDB 5.0 migrieren, indem Sie das AWS DMS
Funktionelle Unterschiede
Funktionale Unterschiede zwischen Amazon DocumentDB 4.0 und 5.0
Mit der Veröffentlichung von Amazon DocumentDB 5.0 gibt es funktionale Unterschiede zwischen Amazon DocumentDB 4.0 und Amazon DocumentDB 5.0:
-
Die integrierte Backup-Rolle unterstützt jetzt
serverStatus. Aktion — Entwickler und Anwendungen mit Backup-Rolle können Statistiken über den Status des Amazon DocumentDB-Clusters sammeln. -
Der
SecondaryDelaySecsFeld ersetztslaveDelayinreplSetGetConfigAusgang. -
Die hello Befehl ersetzt
isMaster- hello gibt ein Dokument zurück, das die Rolle eines Amazon DocumentDB-Clusters beschreibt. Amazon DocumentDB 5.0 unterstützt jetzt Indexscans mit
$elemMatchOperator in der ersten Verschachtelungsebene. Indexscans werden unterstützt, wenn der Filter „Nur Abfragen“ eine Ebene der$elemMatchFilter werden jedoch nicht unterstützt, wenn ein verschachtelter$elemMatchAbfrage ist enthalten.Wenn Sie beispielsweise in Amazon DocumentDB 5.0 das einbeziehen
$elemMatchOperator in der verschachtelten Ebene, er gibt keinen Wert zurück, wie dies in Amazon DocumentDB 4.0 der Fall ist:db.foo.insert( [ {a: {b: 5}}, {a: {b: [5]}}, {a: {b: [3, 7]}}, {a: [{b: 5}]}, {a: [{b: 3}, {b: 7}]}, {a: [{b: [5]}]}, {a: [{b: [3, 7]}]}, {a: [[{b: 5}]]}, {a: [[{b: 3}, {b: 7}]]}, {a: [[{b: [5]}]]}, {a: [[{b: [3, 7]}]]} ]); // DocumentDB 5.0 > db.foo.find({a: {$elemMatch: {b: {$elemMatch: {$lt: 6, $gt: 4}}}}}, {_id: 0}) { "a" : [ { "b" : [ 5 ] } ] } // DocumentDB 4.0 > db.foo.find({a: {$elemMatch: {b: {$elemMatch: {$lt: 6, $gt: 4}}}}}, {_id: 0}) { "a" : [ { "b" : [ 5 ] } ] } { "a" : [ [ { "b" : [ 5 ] } ] ] }-
Die „$“ -Projektion in Amazon DocumentDB 4.0 gibt alle Dokumente mit allen Feldern zurück. Mit Amazon DocumentDB 5.0 ist der find Ein Befehl mit einer „$“ -Projektion gibt Dokumente zurück, die dem Abfrageparameter entsprechen und nur das Feld enthalten, das der „$“ -Projektion entspricht.
In Amazon DocumentDB 5.0 ist der find Befehle mit
$regexund$optionsAbfrageparameter geben einen Fehler zurück: „Optionen können nicht in beiden festgelegt werden$regexund$options“.Mit Amazon DocumentDB 5.0,
$indexOfCPgibt jetzt „-1" zurück, wenn:die Teilzeichenfolge wurde im Zeichenkettenausdruck nicht gefunden, oder
Start ist eine Zahl größer als Ende, oder
start ist eine Zahl, die größer als die Bytelänge der Zeichenfolge ist.
In Amazon DocumentDB 4.0
$indexOfCPgibt „0" zurück, wenn die Startposition eine Zahl größer als das Ende oder die Bytelänge der Zeichenfolge ist.Mit Amazon DocumentDB 5.0 sind Projektionsoperationen in
_id fields, zum Beispiel{"_id.nestedField" : 1}, geben Dokumente zurück, die nur das projizierte Feld enthalten. In Amazon DocumentDB 4.0 hingegen filtern Befehle zur Projektion verschachtelter Felder kein Dokument heraus.
MongoDB 4.0-Kompatibilität
Themen
Funktionen von Amazon DocumentDB 4.0
Amazon DocumentDB 4.0 führte viele neue Funktionen und Fähigkeiten ein, darunter ACID-Transaktionen und Verbesserungen bei Change-Streams. Die folgende Zusammenfassung zeigt einige der wichtigsten Funktionen, die in Amazon DocumentDB 4.0 eingeführt wurden. Eine vollständige Liste der Funktionen finden Sie im Versionshinweise.
-
ACID-Transaktionen: Amazon DocumentDB unterstützt jetzt die Möglichkeit, Transaktionen über mehrere Dokumente, Kontoauszüge, Sammlungen und Datenbanken hinweg durchzuführen. Transaktionen vereinfachen die Anwendungsentwicklung, indem sie es Ihnen ermöglichen, atomare, konsistente, isolierte und dauerhafte (ACID) -Operationen für ein oder mehrere Dokumente innerhalb eines Amazon DocumentDB-Clusters durchzuführen. Weitere Informationen finden Sie unter Transaktionen in Amazon DocumentDB.
-
Streams ändern: Sie haben jetzt die Möglichkeit, einen Change-Stream auf Cluster-Ebene zu öffnen (
client.watch()odermongo.watch()) und die Datenbank (db.watch()), können Sie eine angebenstartAtOperationTimeum einen Change-Stream-Cursor zu öffnen, und zu guter Letzt können Sie jetzt die Aufbewahrungsfrist für Change-Streams auf 7 Tage (zuvor 24 Stunden) verlängern. Weitere Informationen finden Sie unter Change Streams mit Amazon DocumentDB verwenden. -
AWS Database Migration Service (AWS DMS): Sie können jetzt verwenden AWS DMS um Ihre MongoDB 4.0-Workloads zu Amazon DocumentDB zu migrieren. AWS DMS unterstützt jetzt eine MongoDB 4.0-Quelle, ein Amazon DocumentDB 4.0-Ziel und eine Amazon DocumentDB 3.6-Quelle für die Durchführung von Upgrades zwischen Amazon DocumentDB 3.6 und 4.0. Weitere Informationen finden Sie in der AWS DMS Dokumentation.
-
Leistung und Indizierung: Sie können jetzt einen Index verwenden mit
$lookup, finden Sie Abfragen mit einer Projektion, die ein Feld oder ein Feld enthalten, und_idEin Feld kann direkt aus dem Index bereitgestellt werden, ohne dass es aus der Sammlung gelesen werden muss (abgedeckte Abfrage), folgende Funktionenhint()mitfindAndModify, Leistungsoptimierungen für$addToSet, und Verbesserungen zur Reduzierung der Gesamtindexgrößen. Weitere Informationen finden Sie unter Versionshinweise. -
Operatoren: Amazon DocumentDB 4.0 unterstützt jetzt eine Reihe neuer Aggregationsoperatoren:
$ifNull,$replaceRoot,$setIsSubset,$setIntersection,$setUnion,$setEquals. Sie finden alle MongoDB-APIs, -Operationen und -Datentypen, die wir unterstützen, unter Unterstützte MongoDB-APIs, Operationen und Datentypen in Amazon DocumentDB. -
Rollenbasierte Zugriffskontrolle (RBAC): Mit beiden
ListCollectionundListDatabaseBefehle kannst du jetzt optional verwendenauthorizedCollectionsundauthorizedDatabasesParameter, die es Benutzern ermöglichen, die Sammlungen und Datenbanken aufzulisten, für die sie eine Zugriffsberechtigung haben, ohne dass dielistCollectionsundlistDatabasejeweils Rollen. Sie haben auch die Möglichkeit, Ihre eigenen Cursor zu töten, ohne die zu benötigenKillCursorRolle.
Amazon DocumentDB unterstützt nicht jede MongoDB 4.0-Funktion. Bei der Entwicklung von Amazon DocumentDB 4.0 haben wir von den Funktionen und Funktionen, um deren Entwicklung uns unsere Kunden am häufigsten gebeten haben, rückwärts gearbeitet. Wir werden weiterhin zusätzliche MongoDB 4.0-Funktionen hinzufügen, je nachdem, was unsere Kunden von uns erwarten. Beispielsweise unterstützt Amazon DocumentDB 4.0 derzeit nicht die Operatoren für die Typkonvertierung oder die Zeichenkettenoperatoren, die in MongoDB 4.0 eingeführt wurden. Die aktuelle Liste der unterstützten APIs finden Sie unter Unterstützte MongoDB-APIs, Operationen und Datentypen in Amazon DocumentDB.
Beginnen Sie mit Amazon DocumentDB 4.0
Informationen zu den ersten Schritten mit Amazon DocumentDB 4.0 finden Sie in der Erste Schritte mit Amazon DocumentDB. Sie können einen neuen Amazon DocumentDB 4.0-Cluster mit dem erstellen AWS-Managementkonsole oder der AWS SDK, AWS CLI, oder CloudFormation. Wenn Sie eine Verbindung zu Amazon DocumentDB herstellen, müssen Sie einen MongoDB-Treiber oder ein Programm verwenden, das mit MongoDB 4.0 oder höher kompatibel ist.
Bei der Verwendung von AWS SDK, AWS CLI, oder CloudFormation, die Engine-Version wird standardmäßig auf 5.0.0 gesetzt. Sie müssen den Parameter explizit angeben engineVersion = 4.0.0 um einen neuen Amazon DocumentDB 4.0-Cluster zu erstellen oder engineVersion = 3.6.0 um einen neuen Amazon DocumentDB 3.6-Cluster zu erstellen. Für einen bestimmten Amazon DocumentDB-Cluster können Sie die Cluster-Version ermitteln, indem Sie AWS CLI um anzurufen describe-db-clusters oder verwenden Sie die Amazon DocumentDB-Managementkonsole, um die Engine-Versionsnummer für einen bestimmten Cluster anzuzeigen.
Amazon DocumentDB 4.0 unterstützt r5, r6g, t3.medium, und t4g.medium Instanztypen für Ihre Cluster und ist in allen unterstützten Versionen verfügbar AWS-Regionen. Für die Nutzung von Amazon DocumentDB 4.0 fallen keine zusätzlichen Kosten an. Weitere Informationen zur Preisgestaltung finden Sie unter Preisgestaltung für Amazon DocumentDB (mit MongoDB-Kompatibilität)
Führen Sie ein Upgrade durch oder migrieren Sie zu Amazon DocumentDB 4.0
Sie können von MongoDB 3.6 oder MongoDB 4.0 zu Amazon DocumentDB 4.0 migrieren, indem Sie das AWS DMS
Funktionelle Unterschiede
Funktionale Unterschiede zwischen Amazon DocumentDB 3.6 und 4.0
Mit der Veröffentlichung von Amazon DocumentDB 4.0 gibt es funktionale Unterschiede zwischen Amazon DocumentDB 3.6 und Amazon DocumentDB 4.0:
-
Projektion für verschachtelte Dokumente: Amazon DocumentDB 3.6 berücksichtigt beim Anwenden einer Projektion das erste Feld in einem verschachtelten Dokument. Amazon DocumentDB 4.0 analysiert jedoch Unterdokumente und wendet die Projektion auch auf jedes Unterdokument an. Zum Beispiel: wenn die Projektion
"a.b.c": 1, dann ist das Verhalten in beiden Versionen identisch. Wenn die Projektion jedoch{a:{b:{c:1}}}dann wendet Amazon DocumentDB 3.6 die Projektion nur auf 'a' an und nicht auf 'b' oder 'c'. -
Verhalten für
minKey,maxKey: In Amazon DocumentDB 4.0 ist das Verhalten für{x:{$gt:MaxKey}}gibt nichts zurück, und für{x:{$lt:MaxKey}}gibt alles zurück. -
Unterschiede beim Vergleich von Dokumenten: Vergleich von numerischen Werten verschiedener Typen (Double, Int, Long) in Unterdokumenten (z. B.
bin{"_id" :1, "a" :{"b":1}}) bietet jetzt eine konsistente Ausgabe für alle numerischen Datentypen und für jede Ebene eines Dokuments.
Funktionale Unterschiede zwischen Amazon DocumentDB 4.0 und MongoDB 4.0
Im Folgenden sind die funktionalen Unterschiede zwischen Amazon DocumentDB 4.0 und MongoDB 4.0 aufgeführt.
-
Suche mit leerem Schlüssel im Pfad: Wenn eine Sammlung ein Dokument mit leerem Schlüssel im Array enthält (z. B.
{"x" : [ { "" : 10 }, { "b" : 20 } ]}) und wenn der in der Abfrage verwendete Schlüssel in einer leeren Zeichenfolge endet (z. B.x.), dann gibt Amazon DocumentDB dieses Dokument zurück, da es alle Dokumente im Array durchläuft, wohingegen MongoDB dieses Dokument nicht zurückgibt. -
$setOnInsertzusammen mit$auf dem Pfad: Der Feldoperator$setOnInsertfunktioniert nicht in Kombination mit$im Pfad in Amazon DocumentDB, der auch mit MongoDB 4.0 konsistent ist.