Azure Cosmos DB per MongoDB (versione 3.6): funzionalità e sintassi supportate
Articolo
SI APPLICA A: Mongodb
Azure Cosmos DB è il servizio di database di Microsoft multimodello distribuito a livello globale. È possibile comunicare con Azure Cosmos DB per MongoDB usando uno dei driver client MongoDB open source. Azure Cosmos DB per MongoDB consente l'uso dei driver client esistenti aderendo al protocollo di filo MongoDB.
Usando Azure Cosmos DB per MongoDB, è possibile usufruire dei vantaggi offerti da MongoDB, con tutte le funzionalità aziendali fornite da Azure Cosmos DB: distribuzione globale, partizionamento automatico, disponibilità e latenza, crittografia inattivi, backup e molto altro ancora.
Nota
La versione 3.6 di Azure Cosmos DB per MongoDB non ha piani correnti per l'end-of-life (EOL). L'avviso minimo per un futuro EOL è di tre anni.
Protocolli supportati
Azure Cosmos DB per MongoDB è compatibile con il server MongoDB versione 3.6 per impostazione predefinita per i nuovi account. Gli operatori supportati con i relativi limiti ed eccezioni sono elencati di seguito. Qualsiasi driver client che riconosce questi protocolli deve essere in grado di connettersi ad Azure Cosmos DB per MongoDB. Quando si crea l'API Azure Cosmos DB per gli account MongoDB, la versione 3.6 dell'account ha l'endpoint nel formato mentre la versione 3.2 dell'account ha l'endpoint nel formato *.mongo.cosmos.azure.com*.documents.azure.com.
Linguaggi di query supportati
Azure Cosmos DB per MongoDB offre supporto completo per i 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 usano i comandi server supportati sono compatibili con Azure Cosmos DB per MongoDB.
Comandi del database
Azure Cosmos DB per 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 let i campi e pipeline , verrà visualizzato un errore contenente un messaggio contenente let is not supported .
Espressioni booleane
Comando
Supportato
and
Sì
not
Sì
or
Sì
Espressioni Set
Comando
Supportato
setEquals
Sì
setIntersection
Sì
setUnion
Sì
setDifference
Sì
setIsSubset
Sì
anyElementTrue
Sì
allElementsTrue
Sì
Espressioni di confronto
Nota
L'API per MongoDB non supporta espressioni di confronto con un valore letterale di matrice nella query.
Comando
Supportato
cmp
Sì
eq
Sì
gt
Sì
gte
Sì
lt
Sì
lte
Sì
ne
Sì
in
Sì
nin
Sì
Espressioni aritmetiche
Comando
Supportato
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
Supportato
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
Supportato
meta
No
Espressioni di matrice
Comando
Supportato
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
Supportato
map
Sì
let
Sì
Variabili di sistema
Comando
Supportato
$$CURRENT
Sì
$$DESCEND
Sì
$$KEEP
Sì
$$PRUNE
Sì
$$REMOVE
Sì
$$ROOT
Sì
Operatore letterale
Comando
Supportato
literal
Sì
Espressioni di data
Comando
Supportato
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
Supportato
cond
Sì
ifNull
Sì
switch
Sì
Operatore tipo di dati
Comando
Supportato
type
Sì
Espressioni accumulatore
Comando
Supportato
sum
Sì
avg
Sì
first
Sì
last
Sì
max
Sì
min
Sì
push
Sì
addToSet
Sì
stdDevPop
Sì
stdDevSamp
Sì
Operatore merge
Comando
Supportato
mergeObjects
Sì
Tipi di dati
Comando
Supportato
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
Supportato
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
Supportato
TTL
Sì
Unique
Sì
Partial
No
Case Insensitive
No
Sparse
No
Background
Sì
Operatori
Operatori logici
Comando
Supportato
or
Sì
and
Sì
not
Sì
nor
Sì
Operatori elemento
Comando
Supportato
exists
Sì
type
Sì
Operatori di query di valutazione
Comando
Supportato
expr
Sì
jsonSchema
No
mod
Sì
regex
Sì
text
No (non supportato. Usare invece $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 "o" : la query find({x:{$regex: /^abc |^def/}) corrisponde ai documenti in cui il campo x ha valori che iniziano 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
Supportato
all
Sì
elemMatch
Sì
size
Sì
Operatore commento
Comando
Supportato
comment
Sì
Operatori proiezione
Comando
Supportato
elemMatch
Sì
meta
No
slice
Sì
Operatori di aggiornamento
Operatori di aggiornamento di campo
Comando
Supportato
inc
Sì
mul
Sì
rename
Sì
setOnInsert
Sì
set
Sì
unset
Sì
min
Sì
max
Sì
currentDate
Sì
Operatori di aggiornamento di matrice
Comando
Supportato
$
Sì
$[]
Sì
$[\<identifier\>]
Sì
addToSet
Sì
pop
Sì
pullAll
Sì
pull
Sì
push
Sì
pushAll
Sì
Modificatori aggiornamento
Comando
Supportato
each
Sì
slice
Sì
sort
Sì
position
Sì
Operatore di aggiornamento bit per bit
Comando
Supportato
bit
Sì
bitsAllSet
No
bitsAnySet
No
bitsAllClear
No
bitsAnyClear
No
Operatori geospaziali
Operatore
Supportato
$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 , le operazioni di ordinamento su un singolo campo sono supportate, ma le operazioni di ordinamento su più campi non sono supportate.
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 i comandi di replica manuale.
Scritture riprovabili
Azure Cosmos DB non supporta ancora scritture riprovabili. 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 manuale, il che significa che 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 lato server.
Durata (TTL)
Azure Cosmos DB supporta una durata (TTL) basata sul timestamp del documento. La durata (TTL) può essere abilitata per le raccolte dal portale di Azure.
Gestione di utenti e ruoli
Azure Cosmos DB non supporta ancora utenti e ruoli. Supporta tuttavia il controllo degli accessi in base al ruolo di Azure e le password o le chiavi di sola lettura e scrittura che possono essere ottenute tramite il riquadro della stringa di connessione nel portale di Azure.
Write concern
Alcune applicazioni si basano su un problema di scrittura, che specifica 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 la 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 .