Azure Cosmos DB for MongoDB(版本 3.6):支持的功能和语法

适用对象: MongoDB

Azure Cosmos DB 是 Azure 提供的多区域分布式多模型数据库服务。 可通过任何开放源代码 MongoDB 客户端驱动程序与 Azure Cosmos DB for MongoDB 进行通信。 可以按照 MongoDB 线路协议规定,通过 Azure Cosmos DB for MongoDB 来使用现有客户端驱动程序。

通过使用 Azure Cosmos DB for MongoDB,可以像以往一样从 MongoDB 中受益,并且可使用 Azure Cosmos DB 提供的所有企业功能:多区域分布自动分片、可用性和延迟保证、静态加密和备份等。

注意

Azure Cosmos DB for MongoDB 版本 3.6 目前没有生命周期终止 (EOL) 计划。 未来 EOL 的最短期限是 3 年。

协议支持

默认情况下,对于新帐户,Azure Cosmos DB for MongoDB 与 MongoDB 服务器版本 3.6 兼容。 支持的运算符以及限制或例外已列在下面。 任何理解这些协议的客户端驱动程序应该都能够连接到 Azure Cosmos DB for MongoDB。 创建 Azure Cosmos DB API for MongoDB 帐户时,3.6 版的帐户的终结点格式为 *.mongo.cosmos.azure.cn,而 3.2 版的帐户的终结点格式为 *.documents.azure.cn

查询语言支持

Azure Cosmos DB for MongoDB 全面支持 MongoDB 查询语言构造。 以下各节介绍 Azure Cosmos DB 当前支持的服务器操作、运算符、阶段、命令和选项的详细列表。

注意

本文仅列出受支持的服务器命令,并排除客户端包装器函数。 客户端包装器函数(如 deleteMany()updateMany())在内部利用 delete()update() 服务器命令。 利用受支持的服务器命令的函数与 Azure Cosmos DB for MongoDB 兼容。

数据库命令

Azure Cosmos DB for MongoDB 支持以下数据库命令:

查询和写入操作命令

命令 支持
change streams
delete
eval
find
findAndModify
getLastError
getMore
getPrevError
insert
parallelCollectionScan No
resetError No
update

身份验证命令

命令 支持
authenticate
getnonce
logout

管理命令

命令 支持
cloneCollectionAsCapped
collMod No
connectionStatus No
convertToCapped No
copydb No
create
createIndexes
currentOp
drop
dropDatabase
dropIndexes
filemd5
killCursors
killOp
listCollections
listDatabases
listIndexes
reIndex
renameCollection

诊断命令

命令 支持
buildInfo
collStats
connPoolStats No
connectionStatus No
dataSize No
dbHash No
dbStats
explain
features
hostInfo
listDatabases
listCommands No
profiler No
serverStatus No
top No
whatsmyuri

聚合管道

聚合命令

命令 支持
aggregate
count
distinct
mapReduce

聚合阶段

命令 支持
addFields
bucket No
bucketAuto No
changeStream
collStats
count
currentOp
facet
geoNear
graphLookup
group
indexStats
limit
listLocalSessions No
listSessions
lookup 部分
match
out
project
redact
replaceRoot
replaceWith
sample
skip
sort
sortByCount
unwind

注意

$lookup 尚不支持服务器版本 3.6 中引入的不相关子查询功能。 如果尝试将 $lookup 运算符与 letpipeline 字段一起使用,则会收到一条错误消息,其中包含 let is not supported

布尔表达式

命令 支持
and
not
or

集表达式

命令 支持
setEquals
setIntersection
setUnion
setDifference
setIsSubset
anyElementTrue
allElementsTrue

比较表达式

注意

用于 MongoDB 的 API 不支持查询中包含数组文本的比较表达式。

命令 支持
cmp
eq
gt
gte
lt
lte
ne
in
nin

算术表达式

命令 支持
abs
add
ceil
divide
exp
floor
ln
log
log10
mod
multiply
pow
sqrt
subtract
trunc

字符串表达式

命令 支持
concat
indexOfBytes
indexOfCP
split
strLenBytes
strLenCP
strcasecmp
substr
substrBytes
substrCP
toLower
toUpper

文本搜索运算符

命令 支持
meta

数组表达式

命令 支持
arrayElemAt
arrayToObject
concatArrays
filter
indexOfArray
isArray
objectToArray
range
reverseArray
reduce
size
slice
zip
in

变量运算符

命令 支持
map
let

系统变量

命令 支持
$$CURRENT
$$DESCEND
$$KEEP
$$PRUNE
$$REMOVE
$$ROOT

文本运算符

命令 支持
literal

日期表达式

命令 支持
dayOfYear
dayOfMonth
dayOfWeek
year
month
week
hour
minute
second
millisecond
dateToString
isoDayOfWeek
isoWeek
dateFromParts
dateToParts
dateFromString
isoWeekYear

条件表达式

命令 支持
cond
ifNull
switch

数据类型运算符

命令 支持
type

累加器表达式

命令 支持
sum
avg
first
last
max
min
push
addToSet
stdDevPop
stdDevSamp

合并运算符

命令 支持
mergeObjects

数据类型

命令 支持
Double
String
Object
Array
Binary Data
ObjectId
Boolean
Date
Null
32-bit Integer (int)
Timestamp
64-bit Integer (long)
MinKey
MaxKey
Decimal128
Regular Expression
JavaScript
JavaScript (with scope)
Undefined

索引和索引属性

索引

命令 支持
Single Field Index
Compound Index
Multikey Index
Text Index
2dsphere
2d Index No
Hashed Index

索引属性

命令 支持
TTL
Unique
Partial No
Case Insensitive No
Sparse No
Background

运算符

逻辑运算符

命令 支持
or
and
not
nor

元素运算符

命令 支持
exists
type

评估查询运算符

命令 支持
expr
jsonSchema
mod
regex
text 否(不支持。请改用 $regex。)
where

在 $regex 查询中,左定位表达式允许索引搜索。 但是,使用“i”修饰符(不区分大小写)和“m”修饰符(多行)会导致在所有表达式中进行回收集合扫描。

当需要包含 $| 时,最好创建两个(或更多)正则表达式查询。 例如,给定以下原始查询:find({x:{$regex: /^abc$/}),必须按如下所示进行修改:

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

第一部分将使用索引将搜索限制为以 ^ abc 开头的文档,第二部分将匹配确切的条目。 竖线运算符 | 充当“or”函数 - 查询 find({x:{$regex: /^abc |^def/}) 匹配字段 x 的值以 "abc""def" 开头的文档。 要使用索引,建议将查询分解为两个由 $or 运算符连接的不同查询:find( {$or : [{x: $regex: /^abc/}, {$regex: /^def/}] })

数组运算符

命令 支持
all
elemMatch
size

注释运算符

命令 支持
comment

投影运算符

命令 支持
elemMatch
meta
slice

更新运算符

字段更新运算符

命令 支持
inc
mul
rename
setOnInsert
set
unset
min
max
currentDate

数组更新运算符

命令 支持
$
$[]
$[\<identifier\>]
addToSet
pop
pullAll
pull
push
pushAll

更新修饰符

命令 支持
each
slice
sort
position

位更新运算符

命令 支持
bit
bitsAllSet No
bitsAnySet No
bitsAllClear No
bitsAnyClear

地理空间运算符

运算符 支持
$geoWithin
$geoIntersects
$near
$nearSphere
$geometry
$minDistance
$maxDistance
$center No
$centerSphere No
$box No
$polygon

排序运算符

使用 findOneAndUpdate 操作时,支持基于单个字段的排序操作,但不支持基于多个字段的排序操作。

索引

API for MongoDB 支持各种索引,以便对多个字段进行排序、提高查询性能并强制实施唯一性。

GridFS

Azure Cosmos DB 通过任何与 GridFS 兼容的 MongoDB 驱动程序支持 GridFS。

复制

Azure Cosmos DB 支持在最低层进行自动本机复制。 此逻辑还可以扩展,实现低延迟的多区域复制。 Azure Cosmos DB 不支持手动复制命令。

可重试写入

Azure Cosmos DB 尚不支持可重试写入。 客户端驱动程序必须在其连接字符串中添加 retryWrites=false

分片

Azure Cosmos DB 支持服务器端自动分片。 它自动管理分片的创建、放置和均衡。 Azure Cosmos DB 不支持手动分片命令,这意味着不必调用 addShard、balancerStart、moveChunk 等命令。只需在创建容器或查询数据时指定分片键。

会话

Azure Cosmos DB 尚不支持服务器端会话命令。

生存时间 (TTL)

Azure Cosmos DB 支持基于文档时间戳的生存时间 (TTL)。 可在 Azure 门户中为集合启用 TTL。

用户和角色管理

Azure Cosmos DB 尚不支持用户和角色。 不过,它支持 Azure 基于角色的访问控制 (Azure RBAC) 以及读写和只读密码/密钥,可通过 Azure 门户中的连接字符串窗格获取这些内容。

写关注

某些应用程序依赖写关注,后者指定写入操作期间需要的响应数。 由于 Azure Cosmos DB 处理复制的方式,因此默认情况下在使用强一致性时,所有写入都将自动成为多数仲裁。 由客户端代码指定的任何写关注都会被系统忽略。 有关详细信息,请参阅使用一致性级别尽量提高可用性和性能一文。

后续步骤

  • 有关详细信息,请查看 Mongo 3.6 版本功能
  • 了解如何将 Studio 3T 与 Azure Cosmos DB for MongoDB 配合使用。
  • 了解如何将 Robo 3T 与 Azure Cosmos DB for MongoDB 配合使用。
  • 使用 Azure Cosmos DB for MongoDB 浏览 MongoDB 示例