创建

命令字段

create命令具有以下字段：

clusteredIndex: {
   key: { <string> },
   unique: <boolean>,
   name: <string>
}

changeStreamPreAndPostImages: {
   enabled: <boolean>
}

{ <storage-engine-name>: <options> }

{ <storage-engine-name>: <options> }

collation: {
   locale: <string>,
   caseLevel: <boolean>,
   caseFirst: <string>,
   strength: <int>,
   numericOrdering: <boolean>,
   alternate: <string>,
   maxVariable: <string>,
   backwards: <boolean>
}

encryptedFieldsConfig = {
    "fields": [
      {
        "keyId": UUID,                    // required
        "path": String,                   // path to field, required
        "bsonType": "string" | "int" ..., // required
        "queries":                        // optional
        [
          { "queryType": "equality" },
        ]
      }
    ],
    "queryPatterns": [                    // optional
       {"fieldName": queryType, "fieldName": queryType, … }
    ]
}

db.createCollection()方法和db.createView()方法封装了create命令。

资源锁定

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

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

事务

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

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

Stable API

使用Stable API V 1时，您不能在create命令中指定以下字段：

• autoIndexId

• capped

• indexOptionDefaults

• max

• size

• storageEngine

创建固定大小集合

要创建限制为 64 KB 的固定大小集合，请按以下格式发出命令：

db.runCommand( { create: "collection", capped: true, size: 64 * 1024 } )

创建时间序列集合

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

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

创建集群化集合

以下create示例添加一个名为products的集群化集合：

db.runCommand( {
   create: "products",
   clusteredIndex: { "key": { _id: 1 }, "unique": true, "name": "products clustered key" }
} )

在示例中， clusteredIndex指定：

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

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

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

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

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

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

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

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

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

db.runCommand( {
   create: "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 时间。

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

创建视图

视图定义 pipeline 不能包含 $out 或 $merge 阶段。这一限制也适用于嵌入式管道，例如在 $lookup 或 $facet 阶段中使用的管道。

要使用 命令创建create 视图 ，请使用以下语法：

db.runCommand( { create: <view>, viewOn: <source>, pipeline: <pipeline> } )

或者，当指定排序规则时：

db.runCommand( { create: <view>, viewOn: <source>, pipeline: <pipeline>, collation: <collation> } )

例如，使用以下文档创建 survey 集合：

db.survey.insertMany(
   [
      { _id: 1, empNumber: "abc123", feedback: { management: 3, environment: 3 }, department: "A" },
      { _id: 2, empNumber: "xyz987", feedback: { management: 2, environment: 3 }, department: "B" },
      { _id: 3, empNumber: "ijk555", feedback: { management: 3, environment: 4 }, department: "A" }
   ]
)

以下操作将创建一个包含 _id、feedback.management和 department 字段的 managementRatings 视图：

db.runCommand ( {
   create: "managementFeedback",
   viewOn: "survey",
   pipeline: [ { $project: { "management": "$feedback.management", department: 1 } } ]
} )

指定排序规则。

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

db.runCommand ( {
   create: "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.runCommand( {
    create: "users",
    storageEngine: { wiredTiger: { configString: "<option>=<setting>" } }
} )

此操作将创建一个名为 的新集合，其中包含users MongoDB 将传递给wiredTiger 存储引擎的特定配置字符串。请参阅 集合级别选项 wiredTiger的 WiredTiger 文档 用于特定的 选项。