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:
$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.
MongoDB