Azure Cosmos DB for MongoDB (Serverversion 4.0): unterstützte Features und Syntax
Artikel
GILT FÜR: MongoDB
Azure Cosmos DB ist ein global verteilter Datenbankdienst von Microsoft mit mehreren Modellen. Sie können mit der API für Azure Cosmos DB for MongoDB über einen der Open-Source-MongoDB-Clienttreiber kommunizieren. Die API für Azure Cosmos DB for MongoDB ermöglicht die Verwendung vorhandener Clienttreiber über das Wire Protocol von MongoDB.
Wenn Sie die API für Azure Cosmos DB for MongoDB verwenden, können Sie die Vorteile der vertrauten MongoDB mit allen von Azure Cosmos DB gebotenen Unternehmensfunktionen kombinieren. Dazu gehören globale Verteilung, automatisches Sharding, Gewährleistung der Verfügbarkeit und Wartezeit, Verschlüsselung ruhender Daten, Sicherungen und vieles mehr.
Protokollunterstützung
Die unterstützten Operatoren und alle Einschränkungen oder Ausnahmen sind unten 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.
Hinweis
Dieser Artikel enthält nur die unterstützten Serverbefehle und keine clientseitigen Wrapperfunktionen. Für clientseitige Wrapperfunktionen, z. B. deleteMany() und updateMany(), werden intern die Serverbefehle delete() und update() genutzt. Funktionen, die unterstützte Serverbefehle nutzen, sind mit Azure Cosmos DB for MongoDB kompatibel.
Unterstützung der Abfragesprache
Azure Cosmos DB for MongoDB bietet umfassende Unterstützung für MongoDB-Abfragesprachkonstrukte. Im Anschluss finden Sie eine detaillierte Aufstellung der aktuell unterstützten Vorgänge, Operatoren, Phasen, Befehle und Optionen:
Datenbankbefehle
Azure Cosmos DB for MongoDB unterstützt die folgenden Datenbankbefehle:
Von $lookup wird das in der Serverversion 3.6 eingeführte Feature für nicht korrelierte Unterabfragen nicht unterstützt. Sie erhalten eine Fehlermeldung mit dem Hinweis let is not supported, wenn Sie versuchen, den Operator $lookup mit den Feldern let und pipeline zu verwenden.
Boolesche Ausdrücke
Get-Help
Unterstützt
and
Ja
not
Ja
or
Ja
Konvertierungsausdrücke
Get-Help
Unterstützt
convert
Ja
toBool
Ja
toDate
Ja
toDecimal
Ja
toDouble
Ja
toInt
Ja
toLong
Ja
toObjectId
Ja
toString
Ja
Set-Ausdrücke
Get-Help
Unterstützt
setEquals
Ja
setIntersection
Ja
setUnion
Ja
setDifference
Ja
setIsSubset
Ja
anyElementTrue
Ja
allElementsTrue
Ja
Vergleichsausdrücke
Hinweis
Die API für MongoDB unterstützt keine Vergleichsausdrücke mit einem Arrayliteral in der Abfrage.
Get-Help
Unterstützt
cmp
Ja
eq
Ja
gt
Ja
gte
Ja
lt
Ja
lte
Ja
ne
Ja
in
Ja
nin
Ja
Arithmetische Ausdrücke
Get-Help
Unterstützt
abs
Ja
add
Ja
ceil
Ja
divide
Ja
exp
Ja
floor
Ja
ln
Ja
log
Ja
log10
Ja
mod
Ja
multiply
Ja
pow
Ja
sqrt
Ja
subtract
Ja
trunc
Ja
Zeichenfolgenausdrücke
Get-Help
Unterstützt
concat
Ja
indexOfBytes
Ja
indexOfCP
Ja
ltrim
Ja
rtrim
Ja
trim
Ja
split
Ja
strLenBytes
Ja
strLenCP
Ja
strcasecmp
Ja
substr
Ja
substrBytes
Ja
substrCP
Ja
toLower
Ja
toUpper
Ja
Operator für die Textsuche
Get-Help
Unterstützt
meta
Nein
Arrayausdrücke
Get-Help
Unterstützt
arrayElemAt
Ja
arrayToObject
Ja
concatArrays
Ja
filter
Ja
indexOfArray
Ja
isArray
Ja
objectToArray
Ja
range
Ja
reverseArray
Ja
reduce
Ja
size
Ja
slice
Ja
zip
Ja
in
Ja
Variablenoperatoren
Get-Help
Unterstützt
map
Ja
let
Ja
Systemvariablen
Get-Help
Unterstützt
$$CURRENT
Ja
$$DESCEND
Ja
$$KEEP
Ja
$$PRUNE
Ja
$$REMOVE
Ja
$$ROOT
Ja
Literaloperator
Get-Help
Unterstützt
literal
Ja
Datumsausdrücke
Get-Help
Unterstützt
dayOfYear
Ja
dayOfMonth
Ja
dayOfWeek
Ja
year
Ja
month
Ja
week
Ja
hour
Ja
minute
Ja
second
Ja
millisecond
Ja
dateToString
Ja
isoDayOfWeek
Ja
isoWeek
Ja
dateFromParts
Ja
dateToParts
Ja
dateFromString
Ja
isoWeekYear
Ja
Bedingte Ausdrücke
Get-Help
Unterstützt
cond
Ja
ifNull
Ja
switch
Ja
Datentypoperator
Get-Help
Unterstützt
type
Ja
Akkumulatorausdrücke
Get-Help
Unterstützt
sum
Ja
avg
Ja
first
Ja
last
Ja
max
Ja
min
Ja
push
Ja
addToSet
Ja
stdDevPop
Ja
stdDevSamp
Ja
Zusammenführungsoperator
Get-Help
Unterstützt
mergeObjects
Ja
Datentypen
Azure Cosmos DB for MongoDB unterstützt Dokumente, die im BSON-Format von MongoDB codiert wurden. 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 profitieren Dokumente, die vor dem Upgrade auf Version 4.0 und höher geschrieben wurden, so lange nicht von der verbesserten Leistung, bis sie durch einen Schreibvorgang über den Endpunkt 4.0 und höher aktualisiert werden.
Die Unterstützung von 16 MB-Dokumenten erhöht das Größenlimit für Ihre Dokumente von 2 MB auf 16 MB. Dieses Limit gilt nur für Sammlungen, die nach der Aktivierung dieses Features erstellt wurden. Sobald dieses Feature für Ihr Datenbankkonto aktiviert wurde, kann es nicht mehr deaktiviert werden.
Wir empfehlen, dass Sie die serverseitige Wiederholung aktivieren und Platzhalterindizes vermeiden sollten, um sicherzustellen, dass Anforderungen bei größeren Dokumenten erfolgreich sind. Falls erforderlich, kann eine Erhöhung Ihrer DB/Sammlungs-RUs außerdem die Leistung verbessern.
Get-Help
Unterstützt
Double
Ja
String
Ja
Object
Ja
Array
Ja
Binary Data
Ja
ObjectId
Ja
Boolean
Ja
Date
Ja
Null
Ja
32-bit Integer (int)
Ja
Timestamp
Ja
64-bit Integer (long)
Ja
MinKey
Ja
MaxKey
Ja
Decimal128
Ja
Regular Expression
Ja
JavaScript
Ja
JavaScript (with scope)
Ja
Undefined
Ja
Indizes und Indexeigenschaften
Indizes
Get-Help
Unterstützt
Single Field Index
Ja
Compound Index
Ja
Multikey Index
Ja
Text Index
Keine
2dsphere
Ja
2d Index
Nr.
Hashed Index
Nein
Indexeigenschaften
Get-Help
Unterstützt
TTL
Ja
Unique
Ja
Partial
Nr.
Case Insensitive
Nr.
Sparse
Nein
Background
Ja
Operatoren
Logische Operatoren
Get-Help
Unterstützt
or
Ja
and
Ja
not
Ja
nor
Ja
Elementoperatoren
Get-Help
Unterstützt
exists
Ja
type
Ja
Abfrageoperatoren für die Auswertung
Get-Help
Unterstützt
expr
Ja
jsonSchema
Keine
mod
Ja
regex
Ja
text
Nein (nicht unterstützt. Verwenden Sie stattdessen $regex.)
where
Nein
In $regex-Abfragen ermöglichen linksverankerte Ausdrücke eine Indexsuche. Die Verwendung des „i“-Modifizierers (keine Berücksichtigung der Groß-/Kleinschreibung) und des „m“-Modifizierers (mehrere Zeilen) führt jedoch zur Sammlungsüberprüfung in allen Ausdrücken.
Wenn „$“ oder „|“ einbezogen werden muss, empfiehlt es sich, 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 zum Einschränken der Suche auf die Dokumente, die mit „^abc“ beginnen, und der zweite Teil stimmt die exakten Einträge ab. 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. Zur Nutzung des Index wird empfohlen, die Abfrage in zwei unterschiedliche Abfragen zu unterteilen, die durch den „$or“-Operator verbunden sind: find( {$or : [{x: $regex: /^abc/}, {$regex: /^def/}] }).
Arrayoperatoren
Get-Help
Unterstützt
all
Ja
elemMatch
Ja
size
Ja
Kommentaroperator
Get-Help
Unterstützt
comment
Ja
Projektionsoperatoren
Get-Help
Unterstützt
elemMatch
Ja
meta
Keine
slice
Ja
Aktualisierungsoperatoren
Operatoren für die Feldaktualisierung
Get-Help
Unterstützt
inc
Ja
mul
Ja
rename
Ja
setOnInsert
Ja
set
Ja
unset
Ja
min
Ja
max
Ja
currentDate
Ja
Operatoren für die Arrayaktualisierung
Get-Help
Unterstützt
$
Ja
$[]
Ja
$[\<identifier\>]
Ja
addToSet
Ja
pop
Ja
pullAll
Ja
pull
Ja
push
Ja
pushAll
Ja
Aktualisierungsmodifizierer
Get-Help
Unterstützt
each
Ja
slice
Ja
sort
Ja
position
Ja
Bitweiser Updateoperator
Get-Help
Unterstützt
bit
Ja
bitsAllSet
Nr.
bitsAnySet
Nr.
bitsAllClear
Nr.
bitsAnyClear
Nein
Räumliche Operatoren
Operator
Unterstützt
$geoWithin
Ja
$geoIntersects
Ja
$near
Ja
$nearSphere
Ja
$geometry
Ja
$minDistance
Ja
$maxDistance
Ja
$center
Nr.
$centerSphere
Nr.
$box
Nr.
$polygon
Nein
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 für mehrere Felder waren bei vorherigen Wire-Protokollen nicht möglich.
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, muss bei Aktualisierungsvorgängen, einschließlich Löschvorgängen, in Shardsammlungen der Shardschlüssel in den Abfragefilter oder die Updateanweisung eingeschlossen werden.
Beispielsweise gilt bei einer Shardsammlung, die über den Schlüssel „country“ konfiguriert wurde: Zum Löschen aller Dokumente mit dem Feld city = "NYC" muss die Anwendung den Vorgang für alle Werte des Shardschlüssels („country“) ausführen, wenn „Wiederholbare Schreibvorgänge“ aktiviert ist.
db.coll.deleteMany({"city": "NYC"}) – Fehlgeschlagen mit der Fehlermeldung ShardKeyNotFound(61)
Hinweis
Wiederholbare Schreibvorgänge unterstützen derzeit keine ungeordneten Massenschreibvorgänge. Wenn Sie Massenschreibvorgänge mit Aktivierung wiederholbarer Schreibvorgänge durchführen möchten, führen Sie geordnete Massenschreibvorgänge durch.
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. Dies bedeutet, dass Sie Befehle wie „addShard“, „balancerStart“, „moveChunk“ usw. nicht aufrufen 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 Sammlung ohne Shards unterstützt. Transaktionen mit mehreren Dokumenten werden sammlungsübergreifend oder in Sammlungen mit Shards nicht 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 rollenbasierte Zugriffssteuerung in Azure (Azure RBAC) sowie Lese-/Schreibkennwörter/-schlüssel und Schreibschutzkennwörter/-schlüssel, die über das Azure-Portal (Seite „Verbindungszeichenfolge“) abgerufen werden können.
Schreibbestätigung
Einige Anwendungen unterstützen eine Schreibbestätigung. Diese gibt die Anzahl der Antworten an, 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. Alle Schreibvorgänge, die durch den Clientcode angegeben werden, werden ignoriert. Weitere Informationen finden Sie unter Verwenden von Konsistenzebenen zum Maximieren der Verfügbarkeit und Leistung.
Nächste Schritte
Informieren Sie sich, wie Studio 3T bei Azure Cosmos DB for MongoDB verwendet wird.
Informieren Sie sich, wie Robo 3T bei Azure Cosmos DB for MongoDB verwendet wird.
Untersuchen Sie MongoDB-Beispiele mit Azure Cosmos DB for MongoDB.
Versuchen Sie, die Kapazitätsplanung für eine Migration zu Azure Cosmos DB durchzuführen? Sie können Informationen zu Ihrem vorhandenen Datenbankcluster für die Kapazitätsplanung verwenden.
MongoDB