Unterstützte Features und Syntax in Azure Cosmos DB für MongoDB 4.0-Serverversion

Mit Azure Cosmos DB für MongoDB 4.0 können Sie vertraute MongoDB-Features mit Funktionen auf Unternehmensniveau wie globaler Verteilung, automatischer Sharding und hoher Verfügbarkeit verwenden. In diesem Artikel werden die unterstützten Features, Syntax und Vorteile der Verwendung von Azure Cosmos DB für MongoDB 4.0 beschrieben.

Protokollunterstützung

Die unterstützten Operatoren und alle Einschränkungen oder Ausnahmen werden hier aufgeführt. Alle Clienttreiber, die diese Protokolle verstehen, sollten auch mit der API für Azure Cosmos DB for MongoDB eine Verbindung herstellen können. Wenn Sie Azure Cosmos DB for MongoDB-Konten erstellen, hat der Endpunkt bei der Kontoversion 3.6 und höher das Format *.mongo.cosmos.azure.com, während er bei der Kontoversion 3.2 das Format *.documents.azure.com hat.

Unterstützung der Abfragesprache

Azure Cosmos DB for MongoDB bietet umfassende Unterstützung für MongoDB-Abfragesprachkonstrukte. Hier finden Sie die detaillierte Liste der derzeit unterstützten Vorgänge, Operatoren, Stufen, Befehle und Optionen.

Datenbankbefehle

Azure Cosmos DB for MongoDB unterstützt die folgenden Datenbankbefehle:

Befehle für Abfrage- und Schreibvorgänge

Transaktionsbefehle

Authentifizierungsbefehle

Verwaltungsbefehle

Diagnosebefehle

Aggregationspipeline

Aggregationsbefehle

Aggregationsphasen

Boolesche Ausdrücke

Umwandlungsausdrücke

Set-Ausdrücke

Vergleichsausdrücke

Arithmetische Ausdrücke

Zeichenfolgenausdrücke

Operator für die Textsuche

Arrayausdrücke

Variablenoperatoren

Systemvariablen

Literaloperator

Datumsausdrücke

Bedingte Ausdrücke

Datentypoperator

Akkumulatorausdrücke

Zusammenführungsoperator

Datentypen

Azure Cosmos DB für MongoDB unterstützt Dokumente, die im MongoDB-Binär-JSON-Format (BSON) codiert sind. Die API-Version 4.0 verbessert die interne Verwendung dieses Formats, um die Leistung zu verbessern und Kosten zu senken. Dokumente, die über einen Endpunkt mit 4.0 und höher geschrieben oder aktualisiert werden, profitieren von der Optimierung.

In einem Upgradeszenario auf Version 4.0 oder höher profitieren Dokumente, die vor dem Upgrade erstellt wurden, nicht sofort von der verbesserten Leistung. Aktualisieren Sie diese Dokumente mithilfe eines Schreibvorgangs mithilfe des 4.0-Endpunkts, um die Vorteile der Verbesserungen zu nutzen.

16 MB Dokumentunterstützung erhöht die Größenbeschränkung für Dokumente von 2 MB auf 16 MB. Dieser Grenzwert gilt nur für Sammlungen, die nach dem Aktivieren des Features erstellt wurden. Nachdem Sie dieses Feature für ein Datenbankkonto aktiviert haben, kann es nicht deaktiviert werden.

Das Aktivieren von 16 MB kann auf der Registerkarte "Features" im Azure-Portal oder programmgesteuert durch Hinzufügen der EnableMongo16MBDocumentSupport Funktion erfolgen.

Wir empfehlen, die serverseitige Wiederholung zu aktivieren und Platzhalterindizes zu vermeiden, um den Erfolg von Anfragen mit größeren Dokumenten sicherzustellen. Bei Bedarf kann die Erhöhung der Anfrageeinheiten für Datenbanken oder Sammlungen auch die Leistung verbessern.

Indizes und Indexeigenschaften

Indizes

Indexeigenschaften

Betriebspersonal

Logische Operatoren

Elementoperatoren

Abfrageoperatoren für die Auswertung

In $regex-Abfragen ermöglichen linksverankerte Ausdrücke eine Indexsuche. Die Verwendung des i-Modifizierers (Groß-/Kleinschreibung ignorierend) und des m-Modifizierers (mehrzeilig) bewirkt jedoch, dass die Durchsuchung der Sammlung in allen Ausdrücken erfolgt.

Wenn es erforderlich ist, $ oder | einzuschließen, ist es am besten, zwei (oder mehr) Regex-Abfragen zu erstellen. Die folgende ursprüngliche Abfrage find({x:{$regex: /^abc$/}) muss beispielsweise wie folgt geändert werden:

find({x:{$regex: /^abc/, x:{$regex:/^abc$/}})

Der erste Teil verwendet den Index, um die Suche auf diese Dokumente zu beschränken, beginnend mit ^abc und der zweite Teil entspricht den genauen Einträgen. Der Strichoperator | dient als „oder“-Funktion: Die Abfrage find({x:{$regex: /^abc |^def/}) stimmt die Dokumente ab, in denen das Feld x Werte enthält, die mit "abc" oder "def" beginnen. Um den Index zu verwenden, unterteilen Sie die Abfrage in zwei verschiedene Abfragen, die vom $or-Operator verknüpft sind: find( {$or : [{x: $regex: /^abc/}, {$regex: /^def/}] }).

Arrayoperatoren

Kommentaroperator

Projektionsoperatoren

Aktualisierungsoperatoren

Operatoren für die Feldaktualisierung

Array-Aktualisierungsoperatoren

Modifikatoren aktualisieren

Bitweiser Aktualisierungsoperator

Geodätische Operatoren

Sortiervorgänge

Wenn Sie den Vorgang findOneAndUpdate mit der API für MongoDB (Version 4.0) verwenden, werden Sortiervorgänge für ein einzelnes Feld und mehrere Felder unterstützt. Sortiervorgänge über mehrere Felder waren eine Einschränkung früherer Wire-Protokolle.

Indizierung

Die API für MongoDB unterstützt verschiedene Indizes, um die Sortierung nach mehreren Feldern zu ermöglichen, die Abfrageleistung zu verbessern und Eindeutigkeit zu erzwingen.

GridFS

Azure Cosmos DB unterstützt GridFS über jeden GridFS-kompatiblen Mongo-Treiber.

Replikation

Azure Cosmos DB unterstützt die automatische, native Replikation auf den niedrigsten Ebenen. Diese Logik wird erweitert, um auch die globale Replikation mit geringer Latenz zu erreichen. Azure Cosmos DB unterstützt keine manuellen Replikationsbefehle.

Wiederholbare Schreibvorgänge

Wiederholbare Schreibvorgänge ermöglichen es MongoDB-Treibern, bestimmte Schreibvorgänge beim Auftreten eines Fehlers automatisch zu wiederholen. Das führt aber zu strengeren Anforderungen bei bestimmten Vorgängen, die den Anforderungen des MongoDB-Protokolls entsprechen. Wenn dieses Feature aktiviert ist, müssen Aktualisierungsvorgänge, einschließlich Löschvorgängen, in shardierten Sammlungen den Shardschlüssel in den Abfragefilter oder die Update-Anweisung einschließen.

Bei einer sharded-Auflistung wird z. B. auf Schlüssel regiongehardet: Um alle Dokumente mit dem Feld city = "NYC"zu löschen, muss die Anwendung den Vorgang für alle Shardschlüsselwerte (Region) ausführen, wenn wiederholungsfähige Schreibvorgänge aktiviert sind.

• db.coll.deleteMany({"region": "USA", "city": "NYC"}) - Erfolg mit Nachricht Success
• db.coll.deleteMany({"city": "NYC"}) - Scheitert mit Fehler ShardKeyNotFound(61)

Um das Feature zu aktivieren, fügen Sie die Funktion „EnableMongoRetryableWrites“ Ihrem Datenbankkonto hinzu. Dieses Feature kann auch im Azure-Portal auf der Registerkarte „Features“ aktiviert werden.

Sharding (horizontales Partitionieren)

Azure Cosmos DB unterstützt das automatische, serverseitige Sharding. Die Erstellung, die Platzierung und der Ausgleich von Shards wird automatisch verwaltet. Azure Cosmos DB unterstützt keine manuellen Shardingbefehle, was bedeutet, dass Sie keine solchen Befehle wie addShard, balancerStart und moveChunk ausführen müssen. Sie müssen beim Erstellen der Container oder Beim Abfragen der Daten nur den Shardschlüssel angeben.

Sitzungen

Azure Cosmos DB unterstützt noch nicht serverseitige Sitzungsbefehle.

Gültigkeitsdauer (TTL)

Azure Cosmos DB unterstützt eine Gültigkeitsdauer (Time-to-live, TTL) basierend auf dem Zeitstempel des Dokuments. TTL kann für Sammlungen über das Azure-Portal aktiviert werden.

Transaktionen

Transaktionen mit mehreren Dokumenten werden in einer nicht geshardeten Sammlung unterstützt. Transaktionen mit mehreren Dokumenten werden nicht über mehrere Sammlungen hinweg oder in gesharteten Sammlungen unterstützt. Das Timeout für Transaktionen ist auf fünf Sekunden festgelegt.

Benutzer- und Rollenverwaltung

Azure Cosmos DB unterstützt noch nicht Benutzer und Rollen. Azure Cosmos DB unterstützt jedoch die Azure rollenbasierte Zugriffssteuerung sowie Lese- und Schreibzugriff und schreibgeschützten Zugriff auf Kennwörter/Schlüssel, die über das Azure-Portal (Verbindungszeichenfolgenseite) abgerufen werden können.

Schreibsicherheit

Einige Anwendungen sind auf eine Schreibbestätigung angewiesen, die die Anzahl der Antworten angibt, die während eines Schreibvorgangs erforderlich sind. Aufgrund der Art und Weise, in der Azure Cosmos DB die Replikation im Hintergrund durchführt, gilt für alle Schreibvorgänge automatisch und standardmäßig ein Quorum. Jede vom Clientcode angegebene Schreibsorge wird ignoriert. Weitere Informationen finden Sie unter Verwenden von Konsistenzebenen zum Maximieren der Verfügbarkeit und Leistung.