Condividi tramite

Azure Cosmos DB for MongoDB versione 3.6: funzionalità e sintassi supportate

  • Articolo

SI APPLICA A: MongoDB

Azure Cosmos DB è il servizio di database multi-modello distribuito globalmente di Microsoft. È possibile comunicare con Azure Cosmos DB for MongoDB usando uno dei driver client MongoDB open source. Azure Cosmos DB for MongoDB consente di usare driver client esistenti aderendo al protocollo di collegamento MongoDB.

Usando Azure Cosmos DB for MongoDB è possibile sfruttare i noti vantaggi di MongoDB con tutte le funzionalità aziendali offerte da Azure Cosmos DB: distribuzione globale, partizionamento orizzontale automatico, garanzie di disponibilità e latenza, crittografia di dati inattivi, backup e molto altro.

Nota

La versione 3.6 di Azure Cosmos DB for MongoDB non prevede piani correnti di fine vita (EOL). Il preavviso minimo per un futuro EOL è di tre anni.

Protocolli supportati

Per impostazione predefinita, Azure Cosmos DB for MongoDB è compatibile con la versione del server 3.6 di MongoDB per i nuovi account. Gli operatori supportati con i relativi limiti ed eccezioni sono elencati di seguito. I driver client che identificano questi protocolli dovrebbero essere in grado di collegarsi ad Azure Cosmos DB for MongoDB. Quando si usa l'API di Azure Cosmos DB per gli account MongoDB, per la versione 3.6 degli account il formato dell'endpoint è *.mongo.cosmos.azure.com, mentre per la versione 3.2 il formato dell'endpoint è *.documents.azure.com.

Linguaggi di query supportati

Azure Cosmos DB for MongoDB offre il supporto completo dei costrutti del linguaggio di query MongoDB. Le sezioni seguenti contengono l'elenco dettagliato di operazioni, operatori, fasi, comandi e opzioni per server attualmente supportati da Azure Cosmos DB.

Nota

Questo articolo elenca solo i comandi server supportati e non le funzioni wrapper lato client. Le funzioni wrapper lato client come deleteMany() e updateMany() utilizzano internamente i comandi server delete() e update(). Le funzioni che utilizzano i comandi server supportati sono compatibili con Azure Cosmos DB for MongoDB.

Comandi del database

Azure Cosmos DB for MongoDB supporta i comandi di database seguenti:

Comandi per le operazioni di query e scrittura

Comando Supportata
change streams Sì
delete Sì
eval No
find Sì
findAndModify Sì
getLastError Sì
getMore Sì
getPrevError No
insert Sì
parallelCollectionScan No
resetError No
update Sì

Comandi di autenticazione

Comando Supportata
authenticate Sì
getnonce Sì
logout Sì

Comandi di amministrazione

Comando Supportata
cloneCollectionAsCapped No
collMod No
connectionStatus No
convertToCapped No
copydb No
create Sì
createIndexes Sì
currentOp Sì
drop Sì
dropDatabase Sì
dropIndexes Sì
filemd5 Sì
killCursors Sì
killOp No
listCollections Sì
listDatabases Sì
listIndexes Sì
reIndex Sì
renameCollection No

Comandi di diagnostica

Comando Supportata
buildInfo Sì
collStats Sì
connPoolStats No
connectionStatus No
dataSize No
dbHash No
dbStats Sì
explain Sì
features No
hostInfo Sì
listDatabases Sì
listCommands No
profiler No
serverStatus No
top No
whatsmyuri Sì

Pipeline di aggregazione

Comandi di aggregazione

Comando Supportata
aggregate Sì
count Sì
distinct Sì
mapReduce No

Fasi di aggregazione

Comando Supportata
addFields Sì
bucket No
bucketAuto No
changeStream Sì
collStats No
count Sì
currentOp No
facet Sì
geoNear Sì
graphLookup Sì
group Sì
indexStats No
limit Sì
listLocalSessions No
listSessions No
lookup Parziale
match Sì
out Sì
project Sì
redact Sì
replaceRoot Sì
replaceWith No
sample Sì
skip Sì
sort Sì
sortByCount Sì
unwind Sì

Nota

$lookup non supporta ancora la funzionalità di sottoquery non correlata introdotta nella versione 3.6 del server. Se si tenta di usare l'operatore $lookup con i campi let e pipeline, verrà visualizzato un errore con un messaggio contenente let is not supported.

Espressioni booleane

Comando Supportata
and Sì
not Sì
or Sì

Espressioni Set

Comando Supportata
setEquals Sì
setIntersection Sì
setUnion Sì
setDifference Sì
setIsSubset Sì
anyElementTrue Sì
allElementsTrue Sì

Espressioni di confronto

Nota

L'API per MongoDB non supporta le espressioni di confronto con un valore letterale di matrice nella query.

Comando Supportata
cmp Sì
eq Sì
gt Sì
gte Sì
lt Sì
lte Sì
ne Sì
in Sì
nin Sì

Espressioni aritmetiche

Comando Supportata
abs Sì
add Sì
ceil Sì
divide Sì
exp Sì
floor Sì
ln Sì
log Sì
log10 Sì
mod Sì
multiply Sì
pow Sì
sqrt Sì
subtract Sì
trunc Sì

Espressioni stringa

Comando Supportata
concat Sì
indexOfBytes Sì
indexOfCP Sì
split Sì
strLenBytes Sì
strLenCP Sì
strcasecmp Sì
substr Sì
substrBytes Sì
substrCP Sì
toLower Sì
toUpper Sì

Operatore di ricerca testo

Comando Supportata
meta No

Espressioni di matrice

Comando Supportata
arrayElemAt Sì
arrayToObject Sì
concatArrays Sì
filter Sì
indexOfArray Sì
isArray Sì
objectToArray Sì
range Sì
reverseArray Sì
reduce Sì
size Sì
slice Sì
zip Sì
in Sì

Operatori variabili

Comando Supportata
map Sì
let Sì

Variabili di sistema

Comando Supportata
$$CURRENT Sì
$$DESCEND Sì
$$KEEP Sì
$$PRUNE Sì
$$REMOVE Sì
$$ROOT Sì

Operatore letterale

Comando Supportata
literal Sì

Espressioni di data

Comando Supportata
dayOfYear Sì
dayOfMonth Sì
dayOfWeek Sì
year Sì
month Sì
week Sì
hour Sì
minute Sì
second Sì
millisecond Sì
dateToString Sì
isoDayOfWeek Sì
isoWeek Sì
dateFromParts Sì
dateToParts Sì
dateFromString Sì
isoWeekYear Sì

Espressioni condizionali

Comando Supportata
cond Sì
ifNull Sì
switch Sì

Operatore tipo di dati

Comando Supportata
type Sì

Espressioni accumulatore

Comando Supportata
sum Sì
avg Sì
first Sì
last Sì
max Sì
min Sì
push Sì
addToSet Sì
stdDevPop Sì
stdDevSamp Sì

Operatore merge

Comando Supportata
mergeObjects Sì

Tipo di dati

Comando Supportata
Double Sì
String Sì
Object Sì
Array Sì
Binary Data Sì
ObjectId Sì
Boolean Sì
Date Sì
Null Sì
32-bit Integer (int) Sì
Timestamp Sì
64-bit Integer (long) Sì
MinKey Sì
MaxKey Sì
Decimal128 Sì
Regular Expression Sì
JavaScript Sì
JavaScript (with scope) Sì
Undefined Sì

Indici e proprietà degli indici

Indici

Comando Supportata
Single Field Index Sì
Compound Index Sì
Multikey Index Sì
Text Index No
2dsphere Sì
2d Index No
Hashed Index No

Proprietà degli indici

Comando Supportata
TTL Sì
Unique Sì
Partial No
Case Insensitive No
Sparse No
Background Sì

Operatori

Operatori logici

Comando Supportata
or Sì
and Sì
not Sì
nor Sì

Operatori elemento

Comando Supportata
exists Sì
type Sì

Operatori di query di valutazione

Comando Supportata
expr Sì
jsonSchema No
mod Sì
regex Sì
text No (non è supportato. In alternativa, usare $regex).
where No

Nelle query $regex, le espressioni ancorate a sinistra consentono la ricerca nell'indice. L'uso del modificatore 'i' (senza distinzione tra maiuscole e minuscole) e 'm' (su più righe) provoca l'analisi della raccolta in tutte le espressioni.

Quando è necessario includere $ o |, è consigliabile creare due o più query regex. La query originale find({x:{$regex: /^abc$/}) deve essere ad esempio modificata come segue:

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

La prima parte userà l'indice per limitare la ricerca ai documenti che iniziano con ^abc, mentre la seconda parte individuerà le voci esatte. L'operatore barra | funge da funzione "or". La query find({x:{$regex: /^abc |^def/}) individua i documenti in cui il campo x ha un valore che inizia con "abc" o "def". Per usare l'indice è consigliabile per suddividere la query in due query diverse unite dall'operatore $or: find( {$or : [{x: $regex: /^abc/}, {$regex: /^def/}] }).

Operatori matrice

Comando Supportata
all Sì
elemMatch Sì
size Sì

Operatore commento

Comando Supportata
comment Sì

Operatori proiezione

Comando Supportata
elemMatch Sì
meta No
slice Sì

Operatori di aggiornamento

Operatori di aggiornamento di campo

Comando Supportata
inc Sì
mul Sì
rename Sì
setOnInsert Sì
set Sì
unset Sì
min Sì
max Sì
currentDate Sì

Operatori di aggiornamento di matrice

Comando Supportata
$ Sì
$[] Sì
$[\<identifier\>] Sì
addToSet Sì
pop Sì
pullAll Sì
pull Sì
push Sì
pushAll Sì

Modificatori aggiornamento

Comando Supportata
each Sì
slice Sì
sort Sì
position Sì

Operatore di aggiornamento bit per bit

Comando Supportata
bit Sì
bitsAllSet No
bitsAnySet No
bitsAllClear No
bitsAnyClear No

Operatori geospaziali

Operatore Supportata
$geoWithin Sì
$geoIntersects Sì
$near Sì
$nearSphere Sì
$geometry Sì
$minDistance Sì
$maxDistance Sì
$center No
$centerSphere No
$box No
$polygon No

Operazioni di ordinamento

Quando si usa l'operazione findOneAndUpdate, sono supportate le operazioni di ordinamento in un singolo campo, ma non quelle su più campi.

Indicizzazione

L'API per MongoDB supporta vari indici per abilitare l'ordinamento in più campi, migliorare le prestazioni delle query e applicare l'univocità.

GridFS

Azure Cosmos DB supporta GridFS tramite qualsiasi driver MongoDB compatibile con GridFS.

Replica

Azure Cosmos DB supporta la replica automatica e nativa ai livelli più bassi. Questa logica viene estesa per ottenere anche una replica globale a bassa latenza. Azure Cosmos DB non supporta comandi di replica manuali.

Scritture ripetibili

Azure Cosmos DB non supporta ancora scritture ripetibili. I driver client devono aggiungere retryWrites=false alla stringa di connessione.

Partizionamento orizzontale

Azure Cosmos DB supporta il partizionamento orizzontale automatico lato server. Gestisce automaticamente la creazione, la selezione e il bilanciamento delle partizioni. Azure Cosmos DB non supporta i comandi di partizionamento orizzontale manuali, ovvero non è necessario richiamare comandi come addShard, balancerStart, moveChunk e così via. È sufficiente specificare la chiave di partizione durante la creazione dei contenitori o l'esecuzione di query sui dati.

Sessioni

Azure Cosmos DB non supporta ancora i comandi delle sessioni sul lato server.

Durata (TTL)

Azure Cosmos DB supporta una durata (TTL) in base al timestamp del documento. La durata (TTL) può essere abilitata per le raccolte dal portale di Azure.

Gestione utenti e ruoli

Azure Cosmos DB non supporta ancora utenti e ruoli. Tuttavia, supporta il Controllo degli accessi in base al ruolo di Azure e chiavi o password di lettura/scrittura e sola lettura ottenibili tramite il portale di Azure nel riquadro Stringa di connessione.

Write concern

Alcune applicazioni usano un write concern che definisce il numero di risposte necessarie durante un'operazione di scrittura. A causa del modo in cui Azure Cosmos DB gestisce la replica, per impostazione predefinita tutte le scritture sono quorum di maggioranza automatica quando si usa una coerenza assoluta. Qualsiasi write concern specificato dal codice client viene ignorato. Per altre informazioni, vedere l’articolo Uso dei livelli di coerenza per ottimizzare la disponibilità e le prestazioni.

Passaggi successivi