行为差异

本页介绍了与 MongoDB 兼容的 Firestore 与 MongoDB 之间的行为差异。

如需按 MongoDB 版本细分支持的功能，请参阅：

• 支持的功能：8.0
• 支持的功能：7.0
• 支持的功能：6.0
• 支持的功能：5.0

连接和数据库

• 每个连接只能连接到一个与 MongoDB 兼容的 Firestore 数据库。
• 必须先创建数据库，然后才能连接到该数据库。

命名

以下差异适用于数据模型的命名部分。

集合

• 不支持与 __.*__ 匹配的集合名称。

字段

• 不支持与 __.*__ 匹配的字段名称。
• 不支持使用空白字段名称。

文档

• 文档大小上限为 4 MiB。
• 字段的最大嵌套深度为 20。每个数组和对象类型的字段都会向总深度额外添加一层深度。

_id

• 文档 _id（顶级字段）必须是 ObjectId、字符串或 64 位整数。不支持其他 BSON 类型。
• 不支持空字符串 ("") 和 64 位 0 (0L)。

值

• 不支持 JavaScript、Symbol、DBPointer 和 Undefined BSON 类型。

日期

• 日期值必须介于 [0001-01-01T00:00:00Z, 9999-12-31T23:59:59Z] 之间。

Decimal128

• 在写入时，NaN、正无穷大和负无穷大值会被规范化。
• 不支持对 Decimal128 进行算术运算。

双精度型

• NaN 值在写入时会进行规范化处理。

正则表达式

• 正则表达式选项必须有效（“i”“m”“s”“u”或“x”），并且按字母顺序提供，不得重复。

查询

• 自然排序顺序（没有明确排序的查询）与插入顺序或按 _id 升序排序的顺序不一致。

数据汇总

• 聚合的阶段数上限为 250 个。
• 不支持 $merge 和 $out 阶段。如需查看支持的阶段和运算符的完整列表，请参阅命令部分。

写入

• 无法使用 update 或 findAndModify 的 upsert 功能创建名称以美元符号 ($) 开头的文档。
• 请确保您的连接字符串包含 retryWrites=false（或使用适合您驱动程序的方法），以确保驱动程序不会尝试使用此功能。不支持可重试写入。

交易

• 不支持快照交易。
• 事务使用带锁定的悲观并发控制。为避免锁争用，请限制事务中读取的数据量。

索引

• 不支持通配符索引。
• 不支持唯一索引
• 与 MongoDB 兼容的 Firestore 不会自动在 _id 上创建索引，但可确保 _id 的值在集合中是唯一的。
• 未启用多键的索引不会根据写入操作自动更改为多键索引。您必须在创建索引时启用多键，并且该选项无法更改。

读取疑虑

• 仅支持 majority 读取隔离级别。

写入疑虑数据

• 仅支持 w: 'majority' 和 w: 1 写关注点。

读取偏好设置

• 仅支持 primary、primaryPreferred、primary_preferred、secondary_preferred 和 nearest 读取顾虑。

错误

• 与 MongoDB 兼容的 Firestore 和 MongoDB 的错误代码和消息可能有所不同。

命令

以下行为差异适用于特定命令。

• 下表中未列出的命令不受支持。
• 大多数命令都接受 maxTimeMS，但可能会忽略它。

查询和写入

命令	不受支持的字段
find	comment readConcern max min returnKey showRecordId tailable oplogReplay noCursorTimeout awaitData allowPartialResults collation allowDiskUsage let
aggregate	bypassDocumentValidation readConcern collation hint comment let
insert	bypassDocumentValidation comment
update	collation arrayFilters hint
delete	comment write 在 DELETE 语句中： collation hint
findAndModify	fields bypassDocumentValidation collation arrayFilters hint comment let
count	hint readConcern collation comment
distinct	readConcern collation comment hint
getMore	comment
killCursors	（无）

交易和会话

命令	不受支持的字段
commitTransaction	comment
abortTransaction	comment
endSessions	（无）

管理

命令	不受支持的字段	备注
listDatabases	authorizedDatabases comment	如果提供了 filter，则该值必须为空。
listCollections	comment	如果提供，authorizedCollections 必须为 false。
listIndexes	comment
createCollection	timeseries expireAfterSeconds clusteredIndex changeStreamPreAndPostImages size max storageEngine validator validationLevel validationAction indexOptionDefaults viewOn pipeline collation writeConcern encryptedFields comment	此命令为无操作。 如果提供了 capped，则该参数必须为 false。

后续步骤

• 运行快速入门：创建数据库并与其连接。
• 如需查看支持的功能的完整列表，请参阅支持的 MongoDB 数据类型、驱动程序和功能。