行为差异

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

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

连接和数据库

  • 每个连接只能连接到一个与 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。

后续步骤