Delen via

Azure Cosmos DB voor MongoDB (versie 3.6): ondersteunde functies en syntaxis

  • Artikel

VAN TOEPASSING OP: MongoDB

Azure Cosmos DB is de wereldwijd gedistribueerde multimodel-databaseservice van Microsoft. U kunt communiceren met Azure Cosmos DB voor MongoDB met behulp van een van de opensource-MongoDB-clientstuurprogramma's. De Azure Cosmos DB voor MongoDB maakt het gebruik van bestaande clientstuurprogramma's mogelijk door zich aan het MongoDB-wireprotocol te houden.

Met behulp van Azure Cosmos DB voor MongoDB kunt u profiteren van de voordelen van de MongoDB die u gewend bent, met alle zakelijke mogelijkheden die Azure Cosmos DB biedt: wereldwijde distributie, automatische sharding, beschikbaarheid en latentiegaranties, versleuteling at rest, back-ups en nog veel meer.

Notitie

Versie 3.6 van Azure Cosmos DB voor MongoDB heeft geen huidige plannen voor het einde van de levensduur (EOL). De minimale kennisgeving voor een toekomstige EOL is drie jaar.

Ondersteuning voor protocol

Azure Cosmos DB voor MongoDB is standaard compatibel met MongoDB-serverversie 3.6 voor nieuwe accounts. De ondersteunde operators en eventuele beperkingen of uitzonderingen worden hieronder vermeld. Elk clientstuurprogramma dat deze protocollen begrijpt, moet verbinding kunnen maken met Azure Cosmos DB voor MongoDB. Wanneer u Azure Cosmos DB-API voor MongoDB-accounts maakt, heeft de 3.6-versie van het account het eindpunt in de indeling *.mongo.cosmos.azure.com , terwijl de 3.2-versie van het account het eindpunt in de indeling *.documents.azure.comheeft.

Ondersteuning voor querytaal

Azure Cosmos DB voor MongoDB biedt uitgebreide ondersteuning voor MongoDB-querytaalconstructies. In de volgende secties ziet u de gedetailleerde lijst met serverbewerkingen, operators, fasen, opdrachten en opties die momenteel door Azure Cosmos DB worden ondersteund.

Notitie

Dit artikel bevat alleen de ondersteunde serveropdrachten en sluit wrapper-functies aan de clientzijde uit. Wrapper-functies aan de clientzijde, zoals deleteMany() en updateMany(), maken intern gebruik van de serveropdrachten delete() en update(). Functies die gebruikmaken van ondersteunde serveropdrachten zijn compatibel met Azure Cosmos DB voor MongoDB.

Databaseopdrachten

Azure Cosmos DB voor MongoDB ondersteunt de volgende databaseopdrachten:

Opdrachten voor query- en schrijfbewerkingen

Opdracht Ondersteund
change streams Ja
delete Ja
eval No
find Ja
findAndModify Ja
getLastError Ja
getMore Ja
getPrevError No
insert Ja
parallelCollectionScan No
resetError No
update Ja

Verificatieopdrachten

Opdracht Ondersteund
authenticate Ja
getnonce Ja
logout Ja

Beheeropdrachten

Opdracht Ondersteund
cloneCollectionAsCapped Nee
collMod Nee
connectionStatus Nee
convertToCapped Nee
copydb No
create Ja
createIndexes Ja
currentOp Ja
drop Ja
dropDatabase Ja
dropIndexes Ja
filemd5 Ja
killCursors Ja
killOp No
listCollections Ja
listDatabases Ja
listIndexes Ja
reIndex Ja
renameCollection Nr.

Diagnostics commands

Opdracht Ondersteund
buildInfo Ja
collStats Ja
connPoolStats No
connectionStatus Nee
dataSize Nee
dbHash No
dbStats Ja
explain Ja
features No
hostInfo Ja
listDatabases Ja
listCommands No
profiler Nee
serverStatus Nee
top No
whatsmyuri Ja

Samenvoegingspijplijn

Samenvoegingsopdrachten

Opdracht Ondersteund
aggregate Ja
count Ja
distinct Ja
mapReduce Nr.

Samenvoegingsfasen

Opdracht Ondersteund
addFields Ja
bucket No
bucketAuto No
changeStream Ja
collStats No
count Ja
currentOp No
facet Ja
geoNear Ja
graphLookup Ja
group Ja
indexStats No
limit Ja
listLocalSessions No
listSessions Nr.
lookup Gedeeltelijk
match Ja
out Ja
project Ja
redact Ja
replaceRoot Ja
replaceWith No
sample Ja
skip Ja
sort Ja
sortByCount Ja
unwind Ja

Notitie

$lookup biedt nog geen ondersteuning voor de niet-gerelateerde subquery-functie die is geïntroduceerd in serverversie 3.6. Er wordt een foutbericht weergegeven met een bericht met let is not supported als u probeert de $lookup operator met let en pipeline velden te gebruiken.

Booleaanse expressies

Opdracht Ondersteund
and Ja
not Ja
or Ja

Expressies voor instellen

Opdracht Ondersteund
setEquals Ja
setIntersection Ja
setUnion Ja
setDifference Ja
setIsSubset Ja
anyElementTrue Ja
allElementsTrue Ja

Expressies voor vergelijken

Notitie

De API voor MongoDB biedt geen ondersteuning voor vergelijkingsexpressies met een letterlijke matrix in de query.

Opdracht Ondersteund
cmp Ja
eq Ja
gt Ja
gte Ja
lt Ja
lte Ja
ne Ja
in Ja
nin Ja

Rekenkundige expressies

Opdracht Ondersteund
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

Tekenreeksexpressies

Opdracht Ondersteund
concat Ja
indexOfBytes Ja
indexOfCP Ja
split Ja
strLenBytes Ja
strLenCP Ja
strcasecmp Ja
substr Ja
substrBytes Ja
substrCP Ja
toLower Ja
toUpper Ja

Operator voor tekst zoeken

Opdracht Ondersteund
meta Nee

Matrixexpressies

Opdracht Ondersteund
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

Operators voor variabelen

Opdracht Ondersteund
map Ja
let Ja

Systeemvariabelen

Opdracht Ondersteund
$$CURRENT Ja
$$DESCEND Ja
$$KEEP Ja
$$PRUNE Ja
$$REMOVE Ja
$$ROOT Ja

Letterlijke operator

Opdracht Ondersteund
literal Ja

Datumexpressies

Opdracht Ondersteund
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

Voorwaardelijke expressies

Opdracht Ondersteund
cond Ja
ifNull Ja
switch Ja

Operator voor gegevenstype

Opdracht Ondersteund
type Ja

Accumulatorexpressies

Opdracht Ondersteund
sum Ja
avg Ja
first Ja
last Ja
max Ja
min Ja
push Ja
addToSet Ja
stdDevPop Ja
stdDevSamp Ja

Operator voor samenvoegen

Opdracht Ondersteund
mergeObjects Ja

Data types

Opdracht Ondersteund
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

Indexen en indexeigenschappen

Indexen

Opdracht Ondersteund
Single Field Index Ja
Compound Index Ja
Multikey Index Ja
Text Index No
2dsphere Ja
2d Index No
Hashed Index Nr.

Indexeigenschappen

Opdracht Ondersteund
TTL Ja
Unique Ja
Partial No
Case Insensitive Nee
Sparse No
Background Ja

Operators

Logische operators

Opdracht Ondersteund
or Ja
and Ja
not Ja
nor Ja

Operators voor elementen

Opdracht Ondersteund
exists Ja
type Ja

Operators voor evaluatiequery's

Opdracht Ondersteund
expr Ja
jsonSchema No
mod Ja
regex Ja
text Nee (niet ondersteund. Gebruik in plaats daarvan $regex.)
where Nee

In de $regex-query's is zoeken in de index toegestaan op basis van links-verankerde expressies. Als u echter de aanpassingsfuncties i (geen hoofdlettergevoeligheid) en m (meerdere regels) gebruikt, wordt de verzameling gescand in alle expressies.

Als u twee (of meer) regex-query's moet opnemen $ of |gebruiken, kunt u het beste twee (of meer) regex-query's maken. Bijvoorbeeld, bij de volgende oorspronkelijke query: find({x:{$regex: /^abc$/}), moet dit als volgt worden gewijzigd:

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

Het eerste deel maakt gebruik van de index om alleen te zoeken naar de documenten die beginnen met ^abc en het tweede deel zoekt naar een overeenkomst tussen de exacte vermeldingen. De staafoperator | fungeert als een 'or'-functie: de query find({x:{$regex: /^abc |^def/}) komt overeen met de documenten waarin het veld x waarden bevat die beginnen met "abc" of "def". Als u de index wilt gebruiken, kunt u de query het beste opsplitsen in twee verschillende query’s die zijn verbonden met de operator $or: find( {$or : [{x: $regex: /^abc/}, {$regex: /^def/}] }).

Operators voor matrices

Opdracht Ondersteund
all Ja
elemMatch Ja
size Ja

Operator voor opmerkingen

Opdracht Ondersteund
comment Ja

Operators voor projecties

Opdracht Ondersteund
elemMatch Ja
meta No
slice Ja

Operators voor updates

Operators voor veldupdates

Opdracht Ondersteund
inc Ja
mul Ja
rename Ja
setOnInsert Ja
set Ja
unset Ja
min Ja
max Ja
currentDate Ja

Operators voor matrixupdates

Opdracht Ondersteund
$ Ja
$[] Ja
$[\<identifier\>] Ja
addToSet Ja
pop Ja
pullAll Ja
pull Ja
push Ja
pushAll Ja

Aanpassingsfuncties voor bijwerken

Opdracht Ondersteund
each Ja
slice Ja
sort Ja
position Ja

Operators voor bitwise-updates

Opdracht Ondersteund
bit Ja
bitsAllSet No
bitsAnySet Nee
bitsAllClear Nee
bitsAnyClear Nr.

Georuimtelijke operators

Operator Ondersteund
$geoWithin Ja
$geoIntersects Ja
$near Ja
$nearSphere Ja
$geometry Ja
$minDistance Ja
$maxDistance Ja
$center No
$centerSphere Nee
$box Nee
$polygon Nr.

Bewerkingen sorteren

Wanneer u de findOneAndUpdate bewerking gebruikt, worden sorteerbewerkingen op één veld ondersteund, maar sorteerbewerkingen op meerdere velden worden niet ondersteund.

Indexeren

De API voor MongoDB ondersteunt verschillende indexen om sorteren op meerdere velden mogelijk te maken, queryprestaties te verbeteren en uniekheid af te dwingen.

GridFS

Azure Cosmos DB ondersteunt GridFS via elk MongoDB-stuurprogramma dat compatibel is met GridFS.

Replicatie

Azure Cosmos DB biedt ondersteuning voor automatische, systeemeigen replicatie op de laagste lagen. Deze logica is uitgebreid om tevens globale replicatie met een lage latentie te bereiken. Azure Cosmos DB biedt geen ondersteuning voor handmatige replicatieopdrachten.

Schrijfbewerkingen opnieuw proberen

Azure Cosmos DB biedt nog geen ondersteuning voor schrijfbewerkingen die opnieuw kunnen worden geprobeerd. Clientstuurprogramma's moeten worden toegevoegd aan retryWrites=false hun verbindingsreeks.

Sharding

Azure Cosmos DB biedt ondersteuning voor automatische sharding aan serverzijde. Het beheert automatisch Shard maken, plaatsen en balanceren. Azure Cosmos DB biedt geen ondersteuning voor handmatige sharding-opdrachten, wat betekent dat u geen opdrachten hoeft aan te roepen, zoals addShard, balancerStart, moveChunk, enzovoort. U hoeft alleen de shardsleutel op te geven tijdens het maken van de containers of het uitvoeren van query's op de gegevens.

Sessies

Azure Cosmos DB biedt nog geen ondersteuning voor opdrachten voor sessies aan de serverzijde.

TTL (time-to-live)

Azure Cosmos DB ondersteunt een time-to-live (TTL) op basis van de tijdstempel van het document. TTL kan worden ingeschakeld voor verzamelingen vanuit Azure Portal.

Gebruikers- en rollenbeheer

Azure Cosmos DB biedt nog geen ondersteuning voor gebruikers en rollen. Het biedt echter ondersteuning voor op rollen gebaseerd toegangsbeheer van Azure (Azure RBAC) en wachtwoorden of sleutels voor lezen/schrijven en alleen-lezen die kunnen worden verkregen via het verbindingsreeks deelvenster in Azure Portal.

Schrijfprobleem

Sommige toepassingen zijn afhankelijk van een schrijfprobleem, waarmee het aantal antwoorden wordt opgegeven dat tijdens een schrijfbewerking is vereist. Vanwege de manier waarop Azure Cosmos DB replicatie afhandelt, zijn alle schrijfbewerkingen standaard standaard een meerderheidsquorum bij het gebruik van sterke consistentie. Alle schrijfproblemen die in clientcode zijn opgegeven, worden genegeerd. Zie Consistentieniveaus gebruiken om het artikel over beschikbaarheid en prestaties te maximaliseren voor meer informatie.

Volgende stappen