db.createCollection()

资源锁定

db.createCollection()在操作期间获得指定集合或视图的独占锁。对集合的所有后续操作都必须等到db.createCollection()释放该锁。 db.createCollection()通常会短暂占用此锁。

创建视图需获得数据库中 system.views 集合的额外独占锁。此锁会阻止创建或修改数据库中的视图，直到命令完成。

事务

如果事务不是跨分片写事务，则可以在分布式事务中创建集合和索引。

要在事务中使用 db.createCollection()，该事务必须使用读关注 "local"。如果指定 "local" 以外的读关注级别，则该事务将失败。

创建固定大小集合

固定大小集合具有最大大小或文档数，可以防止其增长超过最大阈值。所有固定大小集合都必须指定最大大小，也可以指定最大文档数。如果集合在达到最大文档计数之前达到最大大小限制，MongoDB 会删除较旧的文档。考虑以下示例：

db.createCollection("log", { capped : true, size : 5242880, max : 5000 } )

此命令创建名为 log 的集合，最大大小为 5 MB，最多包含 5000 份文档。

有关固定大小集合的更多信息，请参阅固定大小集合。

创建时间序列集合

要创建捕捉过去 24 小时天气数据的时间序列集合，请发出此命令：

db.createCollection(
    "weather24h",
    {
       timeseries: {
          timeField: "timestamp",
          metaField: "data",
          granularity: "hours"
       },
       expireAfterSeconds: 86400
    }
)

或者，要创建相同的集合，但将每个存储桶在同一小时内限制为时间戳值，请发出以下命令：

db.createCollection(
    "weather24h",
    {
       timeseries: {
          timeField: "timestamp",
          metaField: "data",
          bucketMaxSpanSeconds: "3600",
          bucketRoundingSeconds: "3600"
       },
       expireAfterSeconds: 86400
    }
)

创建集群化集合

以下db.createCollection()示例添加一个名为stocks的集群化集合：

db.createCollection(
   "stocks",
   { clusteredIndex: { "key": { _id: 1 }, "unique": true, "name": "stocks clustered key" } }
)

在示例中， clusteredIndex指定：

• "key": { _id: 1 }，用于按照 _id 字段设置集群索引键。

• "unique": true，它表示聚集索引键值必须是唯一的。

• "name": "stocks clustered key"，设置集群索引名称。

使用文档的变更流前像和后像创建集合

从 MongoDB 6.0 开始，可使用变更流事件来输出更改前后的文档版本（文档前映像和后映像）：

• 前映像是指被替换、更新或删除之前的文档。已插入的文档没有前映像。

• 后图像是插入、替换或更新后的文档。 已删除的文档没有后图像。

• 使用changeStreamPreAndPostImages 、 或db.createCollection() create为集合启用collMod 。

以下示例创建了一个启用了changeStreamPreAndPostImages的集合：

db.createCollection(
   "temperatureSensor",
   { changeStreamPreAndPostImages: { enabled: true } }
);

如果图像属于以下情况，则前像和后像不可用于变更流事件：

• 在文档更新或删除操作时未对集合启用。

• 在 expireAfterSeconds 中设置的前像和后像保留时间后之后被删除。

  • 以下示例将整个集群的expireAfterSeconds设置为100秒：

    use admin
    db.runCommand( {
       setClusterParameter:
          { changeStreamOptions: { preAndPostImages: { expireAfterSeconds: 100 } } }
    } )

  • 以下示例将特定collection上的expireAfterSeconds设置为100秒：

    use admin
    db.getSiblingDB("my_collection")
      .sensors.watch({ changeStreamOptions:
        { preAndPostImages: { expireAfterSeconds: 100 } } })

  • 以下示例返回当前的 changeStreamOptions 设置，包括 expireAfterSeconds：

    db.adminCommand( { getClusterParameter: "changeStreamOptions" } )

  • 将 expireAfterSeconds 设置为 off 可使用默认保留策略：将保留前像和后像，直到从 oplog 中删除对应的变更流事件。

  • 如果变更流事件从 oplog 中删除，则无论 expireAfterSeconds 前映像和后映像保留时间如何，相应的前映像和后映像也会被删除。

其他考量：

• 启用前像和后像会占用存储空间并增加处理时间。仅在需要时启用前像和后像。

• 将变更流事件大小限制为小于 16 MB。要限制事件大小，您可以：

  • 将文档大小限制为 8 MB。如果其他 change stream 事件字段（例如 updateDescription）不是很大，则可以在 change stream 输出中同时请求更新前的文档和更新后的文档。

  • 如果其他变更流事件字段（例如 updateDescription）并不大，则仅请求变更流输出中最多 16 MB 的文档的后像。

  • 在以下情况下，仅请求最大 16 MB 的文档的 change stream 输出中的预映像：

    • 文档更新仅影响文档结构或内容的一小部分，且

    • 不会引起 replace 变更事件。replace 事件始终包含后像。

• 要请求前图像，请在db.collection.watch()中将fullDocumentBeforeChange设置为required或whenAvailable。要请求后图像，您可以使用相同的方法设置fullDocument。

• 前像被写入 config.system.preimages 集合。

  • config.system.preimages 集合可能会变大。要限制集合大小，可如前文所示为前映像设置 expireAfterSeconds 时间。

  • 前像由后台进程异步删除。

指定排序规则。

排序规则允许用户为字符串比较指定特定于语言的规则，例如字母大小写和重音符号规则。

您可在集合或视图级别指定排序规则。例如，以下操作会创建一个集合，并为该集合指定排序规则（请参阅排序规则文档以查看排序规则字段的描述）：

db.createCollection( "myColl", { collation: { locale: "fr" } } );

支持排序规则的索引和操作将使用此排序规则，除非它们显式指定其他排序规则。例如，将以下文档插入到 myColl 中：

{ _id: 1, category: "café" }
{ _id: 2, category: "cafe" }
{ _id: 3, category: "cafE" }

以下操作使用集合的排序规则：

db.myColl.find().sort( { category: 1 } )

该操作按以下顺序返回文档：

{ "_id" : 2, "category" : "cafe" }
{ "_id" : 3, "category" : "cafE" }
{ "_id" : 1, "category" : "café" }

对使用简单二进制排序规则的集合执行相同的操作（即无特定排序规则集）按以下顺序返回文档：

{ "_id" : 3, "category" : "cafE" }
{ "_id" : 2, "category" : "cafe" }
{ "_id" : 1, "category" : "café" }

指定存储引擎选项

当使用db.createCollection()创建集合时，可以指定特定于集合的存储引擎配置选项。考虑以下操作：

db.createCollection(
   "users",
   { storageEngine: { wiredTiger: { configString: "<option>=<setting>" } } }
)

此操作创建一个名为 users 的新集合，其中包含 MongoDB 将传递到 wiredTiger 存储引擎的特定配置字符串。

例如，要为collection中的文件块指定zlib usersblock_compressor压缩器，请使用以下命令设置 选项：

db.createCollection(
   "users",
   { storageEngine: { wiredTiger: { configString: "block_compressor=zlib" } } }
)

从 MongoDB 7开始。 2 （以及7 . 0 . 5 ），在使用db.createCollection()创建集合时无法指定wiredTiger存储引擎加密选项。要为 WiredTiger 存储引擎配置加密，请参阅静态加密。