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 de Azure Cosmos DB voor MongoDB met behulp van een van de opensource-Stuurprogramma's van de MongoDB-client. Azure Cosmos DB voor MongoDB maakt het gebruik van bestaande clientstuurprogramma's mogelijk door het MongoDB-wireprotocol te volgen.

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, garanties voor beschikbaarheid en latentie, versleuteling in rust, back-ups en nog veel meer.

Notitie

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

Ondersteuning voor protocol

De 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 de Azure Cosmos DB-API voor MongoDB-accounts maakt, heeft versie 3.6 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 Nee
find Ja
findAndModify Ja
getLastError Ja
getMore Ja
getPrevError Nee
insert Ja
parallelCollectionScan Nee
resetError Nee
update Ja

Verificatieopdrachten

Opdracht Ondersteund
authenticate Ja
getnonce Ja
logout Ja

Beheeropdrachten

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

Diagnostics commands

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

Samenvoegingspijplijn

Samenvoegingsopdrachten

Opdracht Ondersteund
aggregate Ja
count Ja
distinct Ja
mapReduce Nee

Samenvoegingsfasen

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

Notitie

$lookup biedt nog geen ondersteuning voor de functie niet-gerelateerde subquery's die is geïntroduceerd in serverversie 3.6. U ontvangt een foutbericht met een bericht waarin staat let is not supported of u de $lookup operator let met velden en pipeline probeert 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

Gegevenstypen

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 Nee
2dsphere Ja
2d Index Nee
Hashed Index Nee

Indexeigenschappen

Opdracht Ondersteund
TTL Ja
Unique Ja
Partial Nee
Case Insensitive Nee
Sparse Nee
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 Nee
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.

Wanneer u of |moet opnemen$, 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 'of'-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 Nee
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 Nee
bitsAnySet Nee
bitsAllClear Nee
bitsAnyClear Nee

Georuimtelijke operators

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

Bewerkingen sorteren

Wanneer u de findOneAndUpdate bewerking gebruikt, worden sorteerbewerkingen op één veld ondersteund, maar worden sorteerbewerkingen op meerdere velden 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 uitgevoerd. Clientstuurprogramma's moeten worden toegevoegd retryWrites=false aan hun connection string.

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 zoals addShard, balancerStart, moveChunk enzovoort hoeft aan te roepen. 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 sessieopdrachten 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 uit de Azure Portal.

Gebruikers- en rolbeheer

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

Schrijfprobleem

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

Volgende stappen