

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
<a name="compatibility"></a>

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.

**Topics**
+ [MongoDB 8.0-Kompatibilität](#mongodb-80)
+ [MongoDB 5.0-Kompatibilität](#mongodb-50)
+ [MongoDB 4.0-Kompatibilität](#mongodb-40)
+ [Funktionale Unterschiede zu MongoDB](functional-differences.md)
+ [Unterstützte MongoDB-APIs, -Operationen und -Datentypen](mongo-apis.md)

## MongoDB 8.0-Kompatibilität
<a name="mongodb-80"></a>

**Topics**
+ [Was ist neu in Amazon DocumentDB 8.0](#compatibility-whatsnew-8)
+ [Beginnen Sie mit Amazon DocumentDB](#compatibility-getstarted-5)
+ [Führen Sie ein Upgrade durch oder migrieren Sie zu Amazon DocumentDB 5.0 oder 8.0](#compatibility-upgrade-5)
+ [Funktionelle Unterschiede](#compatibility-differences-5)

### Was ist neu in Amazon DocumentDB 8.0
<a name="compatibility-whatsnew-8"></a>

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](release-notes.md).
+ 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
<a name="compatibility-getstarted-5"></a>

Informationen zu den ersten Schritten mit Amazon DocumentDB 8.0 finden Sie in der. [Erste Schritte mit Amazon DocumentDB](get-started-guide.md) Sie können einen neuen Amazon DocumentDB 8.0-Cluster mit dem AWS-Managementkonsole oder dem AWS SDK AWS CLI, oder erstellen. CloudFormation Wenn Sie eine Verbindung zu Amazon DocumentDB herstellen, müssen Sie einen MongoDB-Treiber oder ein Hilfsprogramm verwenden, das mit MongoDB 5.0 oder höher kompatibel ist.

**Anmerkung**  
Wenn Sie das AWS SDK oder CloudFormation verwenden AWS CLI, wird die Engine-Version 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 oder `engineVersion = 4.0.0` einen neuen Amazon DocumentDB 4.0-Cluster oder einen neuen Amazon DocumentDB 3.6-Cluster `engineVersion = 3.6.0` zu erstellen. Für einen bestimmten Amazon DocumentDB-Cluster können Sie die Cluster-Version mithilfe von AWS CLI to call ermitteln `describe-db-clusters` oder die Amazon DocumentDB-Managementkonsole verwenden, um die Engine-Versionsnummer für einen bestimmten Cluster anzuzeigen.

Amazon DocumentDB 5.0 und 8.0 unterstützen den Amazon EC2 `r8g` Graviton4-Prozessor und Graviton2-Prozessoren wie und `t4.medium` Instance-Typen für Ihre Cluster `r6g` und sind in allen unterstützten Versionen verfügbar (siehe). AWS-Regionen [Instances](what-is.md#what-is-db-instances) Weitere Informationen zur Preisgestaltung finden Sie unter Preise für [ Amazon DocumentDB (mit MongoDB-Kompatibilität). ](https://aws.amazon.com/documentdb/pricing/)

### Führen Sie ein Upgrade durch oder migrieren Sie zu Amazon DocumentDB 5.0 oder 8.0
<a name="compatibility-upgrade-5"></a>

Sie können von MongoDB 3.6 oder MongoDB 4.0 zu Amazon DocumentDB 5.0 oder Amazon DocumentDB 8.0 migrieren, indem Sie Hilfsprogramme wie [ mongodump, mongorestore, mongoimport und mongoexport verwenden. [AWS DMS](https://aws.amazon.com/dms/)](backup_restore-dump_restore_import_export_data.md) Anweisungen [Aktualisieren Ihres Amazon DocumentDB-Clusters mit AWS Database Migration Service](docdb-migration.versions.md) zur Migration finden Sie unter.

### Funktionelle Unterschiede
<a name="compatibility-differences-5"></a>

#### Funktionale Unterschiede zwischen Amazon DocumentDB 5.0 und 8.0
<a name="w2aac27b9c11b3"></a>

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. Außerdem ist „aktiviert“ in Amazon DocumentDB 8.0 keine gültige Wahl mehr. Sie können zwischen Zstd, LZ4 und None wählen. 
+ Amazon DocumentDB 8.0 unterstützt nur TLS 1.2 und höher für Datenbankverbindungen.

**Wichtig**  
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
<a name="mongodb-50"></a>

**Topics**
+ [Was ist neu in Amazon DocumentDB 5.0](#compatibility-whatsnew-5)
+ [Was ist neu in Amazon DocumentDB 5.0.1](#compatibility-whatsnew-501)
+ [Beginnen Sie mit Amazon DocumentDB 5.0](#compatibility-getstarted-5)
+ [Führen Sie ein Upgrade durch oder migrieren Sie zu Amazon DocumentDB 5.0](#compatibility-upgrade-5)
+ [Funktionelle Unterschiede](#compatibility-differences-5)

### Was ist neu in Amazon DocumentDB 5.0
<a name="compatibility-whatsnew-5"></a>

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](release-notes.md).
+ Das Speicherlimit wurde für alle instanzbasierten Amazon DocumentDB-Cluster und shard-basierten elastischen Cluster 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 Verschlüsselung auf Client-side 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](field-level-encryption.md).
  + Neue Aggregationsoperatoren:, `$dateAdd` `$dateSubtract`
  + Unterstützt Indizes mit `$elemMatch` Operator. Daher führen Abfragen, die ausgeführt wurden`$elemMatch`, zu Index-Scans.

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](mongo-apis.md).

### Was ist neu in Amazon DocumentDB 5.0.1
<a name="compatibility-whatsnew-501"></a>

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](docdb-minor-version-upgrade.md).
+ 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](limits.md#limits.instance).
+ Granulare Leistungsmetriken auf Befehlsebene CloudWatch für CRUD-Operationen (`find`,,,,`insert`,`findAndModify`,`update`,,`delete`,) `aggregate``count`,,`distinct`,`getMore`,`abortTransaction`,`commitTransaction`) `AvgDuration``P100Duration`, Offenlegung und `MaxConcurrent` Dimensionen für eine verbesserte Betriebsüberwachung.
+ Amazon DocumentDB 5.0.1 unterstützt nur TLS 1.2 und höher für Datenbankverbindungen.
+ Metriken auf Sammlungsebene wurden hinzugefügt `gcRuntimeStats` und nach `storageSegmentBase` und `storageSegmentExtended` nach aufgeteilt, `collstats` um mehr Informationen über den Gesamtzustand des Garbage Collection-Prozesses zu erhalten. `documentFragmentStats`

### Beginnen Sie mit Amazon DocumentDB 5.0
<a name="compatibility-getstarted-5"></a>

Informationen zu den ersten Schritten mit Amazon DocumentDB 5.0 finden Sie im. [Erste Schritte mit Amazon DocumentDB](get-started-guide.md) Sie können einen neuen Amazon DocumentDB 5.0-Cluster mit dem AWS-Managementkonsole oder dem AWS SDK AWS CLI, oder erstellen. CloudFormation Wenn Sie eine Verbindung zu Amazon DocumentDB herstellen, müssen Sie einen MongoDB-Treiber oder ein Hilfsprogramm verwenden, das mit MongoDB 5.0 oder höher kompatibel ist.

**Anmerkung**  
Wenn Sie das AWS SDK oder CloudFormation verwenden AWS CLI, wird die Engine-Version 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 oder einen neuen Amazon DocumentDB 3.6-Cluster `engineVersion = 3.6.0` zu erstellen. Für einen bestimmten Amazon DocumentDB-Cluster können Sie die Cluster-Version ermitteln, indem Sie die Amazon DocumentDB-Managementkonsole aufrufen `describe-db-clusters` oder die Amazon DocumentDB-Managementkonsole verwenden, um die Engine-Versionsnummer für einen bestimmten Cluster anzuzeigen. AWS CLI 

Amazon DocumentDB 5.0 und 8.0 unterstützen den Amazon EC2 `r8g` Graviton4-Prozessor und Graviton2-Prozessoren wie und `t4.medium` Instance-Typen für Ihre Cluster `r6g` und sind in allen unterstützten Versionen verfügbar (siehe). AWS-Regionen [Instances](what-is.md#what-is-db-instances) Weitere Informationen zur Preisgestaltung finden Sie unter Preise für [ Amazon DocumentDB (mit MongoDB-Kompatibilität). ](https://aws.amazon.com/documentdb/pricing/)

### Führen Sie ein Upgrade durch oder migrieren Sie zu Amazon DocumentDB 5.0
<a name="compatibility-upgrade-5"></a>

Sie können von MongoDB 3.6 oder MongoDB 4.0 zu Amazon DocumentDB 5.0 migrieren, indem Sie Dienstprogramme wie [ mongodump, mongorestore, mongoimport und mongoexport verwenden. [AWS DMS](https://aws.amazon.com/dms/)](backup_restore-dump_restore_import_export_data.md) Anweisungen [Aktualisieren Ihres Amazon DocumentDB-Clusters mit AWS Database Migration Service](docdb-migration.versions.md) zur Migration finden Sie unter.

### Funktionelle Unterschiede
<a name="compatibility-differences-5"></a>

#### Funktionale Unterschiede zwischen Amazon DocumentDB 4.0 und 5.0
<a name="w2aac27c13c13b3"></a>

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.
+ Das `SecondaryDelaySecs` Feld wird `slaveDelay` in der `replSetGetConfig` Ausgabe ersetzt.
+ Der **hello** Befehl replace `isMaster` — **hello** gibt ein Dokument zurück, das die Rolle eines Amazon DocumentDB-Clusters beschreibt.
+ Amazon DocumentDB 5.0 unterstützt jetzt Indexscans mit dem `$elemMatch` Operator in der ersten Verschachtelungsebene. Indexscans werden unterstützt, wenn der Filter „Nur Abfragen“ über eine Filterebene verfügt. Sie werden jedoch nicht unterstützt, wenn eine verschachtelte `$elemMatch` Abfrage enthalten ist. `$elemMatch`

  Wenn Sie beispielsweise in Amazon DocumentDB 5.0 den `$elemMatch` Operator in die verschachtelte Ebene aufnehmen, wird kein Wert zurückgegeben, 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. In Amazon DocumentDB 5.0 gibt der **find** Befehl mit einer „$“ -Projektion Dokumente zurück, die dem Abfrageparameter entsprechen und nur das Feld enthalten, das der „$“ -Projektion entspricht.
+ In Amazon DocumentDB 5.0 geben die **find** Befehle mit den `$options` Abfrageparametern `$regex` und den folgenden Fehler zurück: „Optionen können nicht `$regex` sowohl `$options` als auch gesetzt werden“.
+ In Amazon DocumentDB 5.0 wird `$indexOfCP` jetzt „-1“ zurückgegeben, wenn:
  + die Teilzeichenfolge wurde im Zeichenfolgenausdruck 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.
+ Gibt in Amazon DocumentDB 4.0 „0" `$indexOfCP` zurück, wenn die Startposition eine Zahl größer als das Ende oder die Bytelänge der Zeichenfolge ist.
+ Bei Amazon DocumentDB 5.0 geben beispielsweise Projektionsoperationen in `_id fields` Dokumente zurück`{"_id.nestedField" : 1}`, 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
<a name="mongodb-40"></a>

**Topics**
+ [Funktionen von Amazon DocumentDB 4.0](#compatibility-whatsnew)
+ [Beginnen Sie mit Amazon DocumentDB 4.0](#compatibility-getstarted)
+ [Führen Sie ein Upgrade durch oder migrieren Sie zu Amazon DocumentDB 4.0](#compatibility-upgrade)
+ [Funktionelle Unterschiede](#compatibility-differences)

### Funktionen von Amazon DocumentDB 4.0
<a name="compatibility-whatsnew"></a>

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](release-notes.md).
+ **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](transactions.md). 
+ **Change Streams**: Sie haben jetzt die Möglichkeit, einen Change-Stream auf Cluster-Ebene (`client.watch()`oder`mongo.watch()`) und in der Datenbank (`db.watch()`) zu öffnen, Sie können angeben, dass ein Change-Stream-Cursor geöffnet werden soll, und `startAtOperationTime` zu guter Letzt können Sie jetzt Ihre Aufbewahrungsfrist für Change-Streams auf 7 Tage (zuvor 24 Stunden) verlängern. Weitere Informationen finden Sie unter [Change Streams mit Amazon DocumentDB verwenden](change_streams.md). 
+ **AWS Database Migration Service**(AWS DMS): Sie können es 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](https://docs.aws.amazon.com/dms/latest/userguide/Welcome.html).
+ **Leistung und Indizierung**: Sie können jetzt einen Index mit verwenden`$lookup`, Abfragen mit einer Projektion finden, die ein Feld oder ein Feld enthalten, und das `_id` Feld kann direkt aus dem Index bereitgestellt werden, ohne dass Sie aus der Sammlung lesen müssen (abgedeckte Abfrage), die Fähigkeit `hint()``findAndModify`, Leistungsoptimierungen für `$addToSet` und Verbesserungen zur Reduzierung der Indexgrößen insgesamt. Weitere Informationen finden Sie unter [Versionshinweise](release-notes.md).
+ **Operatoren**: Amazon DocumentDB 4.0 unterstützt jetzt eine Reihe neuer Aggregationsoperatoren:`$ifNull`,,,,,`$replaceRoot`. `$setIsSubset` `$setIntersection` `$setUnion` `$setEquals` Alle MongoDB-APIs, Operationen und Datentypen, die wir unterstützen, finden Sie unter. [Unterstützte MongoDB-APIs, Operationen und Datentypen in Amazon DocumentDB](mongo-apis.md)
+ **Rollenbasierte Zugriffskontrolle ** (RBAC): Mit beiden `ListDatabase` Befehlen `ListCollection` und können Sie jetzt optional die `authorizedDatabases` Parameter `authorizedCollections` und verwenden, damit Benutzer die Sammlungen und Datenbanken auflisten können, auf die sie zugreifen dürfen, ohne die jeweiligen `listDatabase` Rollen `listCollections` und zu benötigen. Sie haben auch die Möglichkeit, Ihre eigenen Cursor zu beenden, ohne die Rolle zu benötigen. `KillCursor`

Amazon DocumentDB unterstützt nicht alle MongoDB 4.0-Funktionen. 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](mongo-apis.md)

### Beginnen Sie mit Amazon DocumentDB 4.0
<a name="compatibility-getstarted"></a>

Informationen zu den ersten Schritten mit Amazon DocumentDB 4.0 finden Sie im. [Erste Schritte mit Amazon DocumentDB](get-started-guide.md) Sie können einen neuen Amazon DocumentDB 4.0-Cluster mit dem AWS-Managementkonsole oder dem AWS SDK AWS CLI, oder erstellen. CloudFormation Wenn Sie eine Verbindung zu Amazon DocumentDB herstellen, müssen Sie einen MongoDB-Treiber oder ein Hilfsprogramm verwenden, das mit MongoDB 4.0 oder höher kompatibel ist. 

**Anmerkung**  
Wenn Sie das AWS SDK oder CloudFormation verwenden AWS CLI, wird die Engine-Version 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 oder einen neuen Amazon DocumentDB 3.6-Cluster `engineVersion = 3.6.0` zu erstellen. Für einen bestimmten Amazon DocumentDB-Cluster können Sie die Cluster-Version ermitteln, indem Sie die Amazon DocumentDB-Managementkonsole aufrufen `describe-db-clusters` oder die Amazon DocumentDB-Managementkonsole verwenden, um die Engine-Versionsnummer für einen bestimmten Cluster anzuzeigen. AWS CLI 

Amazon DocumentDB 4.0 unterstützt`r5`, `r6g``t3.medium`, und `t4g.medium` Instance-Typen 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 Preise für [ Amazon DocumentDB (mit MongoDB-Kompatibilität). ](https://aws.amazon.com/documentdb/pricing/)

### Führen Sie ein Upgrade durch oder migrieren Sie zu Amazon DocumentDB 4.0
<a name="compatibility-upgrade"></a>

Sie können von MongoDB 3.6 oder MongoDB 4.0 zu Amazon DocumentDB 4.0 migrieren, indem Sie Dienstprogramme wie [ mongodump, mongorestore, mongoimport und mongoexport verwenden. [AWS DMS](https://aws.amazon.com/dms/)](backup_restore-dump_restore_import_export_data.md) Ebenso können Sie dieselben Tools für ein Upgrade von Amazon DocumentDB 3.6 auf Amazon DocumentDB 4.0 verwenden. Anweisungen zur Migration finden Sie unter. [Aktualisieren Ihres Amazon DocumentDB-Clusters mit AWS Database Migration Service](docdb-migration.versions.md)

### Funktionelle Unterschiede
<a name="compatibility-differences"></a>

#### Funktionale Unterschiede zwischen Amazon DocumentDB 3.6 und 4.0
<a name="w2aac27c15c11b3"></a>

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 das erste Feld in einem verschachtelten Dokument, wenn eine Projektion angewendet wird. Amazon DocumentDB 4.0 analysiert jedoch Unterdokumente und wendet die Projektion auch auf jedes Unterdokument an. Beispiel: Wenn die Projektion gleich ist`"a.b.c": 1`, dann ist das Verhalten in beiden Versionen identisch. Wenn die Projektion jedoch lautet`{a:{b:{c:1}}}`, 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 gibt das Verhalten für nichts und für alles `{x:{$gt:MaxKey}}` zurück. `{x:{$lt:MaxKey}}` 
+ **Unterschiede beim Dokumentenvergleich**: Der Vergleich von numerischen Werten verschiedener Typen (Double, Int, Long) in Unterdokumenten (z. B. `b` in`{"_id" :1, "a" :{"b":1}}`) sorgt jetzt für 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
<a name="w2aac27c15c11b5"></a>

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 mit einer leeren Zeichenfolge endet (z. B.`x.`), gibt Amazon DocumentDB dieses Dokument zurück, da es alle Dokumente im Array durchläuft, wohingegen MongoDB dieses Dokument nicht zurückgibt.
+ **`$setOnInsert`zusammen mit `$` im Pfad**: Der Feldoperator `$setOnInsert` funktioniert nicht in Kombination mit im Pfad `$` in Amazon DocumentDB, was auch mit MongoDB 4.0 konsistent ist. 