db.createCollection（）

定义¶

db.createCollection（名称，选项）¶

创建一个新的集合或视图。有关视图，请参见db.createView()。

由于在命令中首次引用集合时，MongoDB会隐式创建一个集合，因此此方法主要用于创建使用特定选项的新集合。例如，您用于 db.createCollection()创建一个有上限的集合，或创建一个使用文档验证的新集合 。

db.createCollection()是数据库命令的包装create。

该db.createCollection()方法具有以下原型形式：

从MongoDB 4.2开始

MongoDB中删除MMAPv1存储引擎和MMAPv1特定选项paddingFactor，paddingBytes，preservePadding 的db.createCollection()。

复制

db.createCollection( <name>,
   {
     capped: <boolean>,
     autoIndexId: <boolean>,
     size: <number>,
     max: <number>,
     storageEngine: <document>,
     validator: <document>,
     validationLevel: <string>,
     validationAction: <string>,
     indexOptionDefaults: <document>,
     viewOn: <string>,              // Added in MongoDB 3.4
     pipeline: <pipeline>,          // Added in MongoDB 3.4
     collation: <document>,         // Added in MongoDB 3.4
     writeConcern: <document>
   }
)

该db.createCollection()方法具有以下参数：

参数	类型	描述
name	串	要创建的集合的名称。请参阅 命名限制。
options	文献	可选的。用于创建有上限的集合，用于在新集合中预分配空间或用于创建视图的配置选项。

该options文档包含以下字段：

领域	类型	描述
capped	布尔值	可选的。要创建一个有上限的集合，请指定true。如果指定true，则还必须在size字段中设置最大大小。
autoIndexId	布尔值	可选的。指定false以禁用在_id字段上自动创建索引 。 重要 在MongoDB中4.0开始，你不能设置选项autoIndexId ，以false在比其他数据库创建集合时 local数据库。 从3.2版开始不推荐使用。
size	数	可选的。指定上限集合的最大大小（以字节为单位）。一旦上限集合达到最大大小，MongoDB就会删除较旧的文档以为新文档腾出空间。size上限集合是必填字段，其他集合则忽略该字段。
max	数	可选的。上限集合中允许的最大文档数。该 size限制优先于此限制。如果有上限的集合size在达到最大文档数之前达到限制，则MongoDB会删除旧文档。如果您想使用该max限制，请确保size有上限的收集所需的限制足以容纳最大数量的文档。
storageEngine	文献	可选的。仅适用于WiredTiger存储引擎。 允许用户在创建集合时基于每个集合为存储引擎指定配置。storageEngine选项的值 应采用以下形式： 复制 { <storage-engine-name>: <options> } 当创建集合进行验证，并记录到存储引擎配置中指定OPLOG复制到支持副本集与使用不同的存储引擎成员中。
validator	文献	可选的。允许用户为集合指定验证规则或表达式。有关更多信息，请参见模式验证。 3.2版中的新功能。 该validator选项采用指定验证规则或表达式的文档。您可以使用相同的运营商为指定表达式查询经营者 的除外$geoNear，$near， $nearSphere，$text，和$where。 注意 验证在更新和插入期间进行。现有文档在进行修改之前不会进行验证检查。 你不能指定的集合验证程序admin， local和config数据库。 您不能为system.*集合指定验证器。
validationLevel	串	可选的。确定在更新过程中MongoDB对验证规则应用到现有文档的严格程度。 3.2版中的新功能。 validationLevel 描述 "off" 不验证插入或更新。 "strict" 默认将验证规则应用于所有插入和所有更新。 "moderate" 将验证规则应用于现有有效 文档的插入和更新。不要将规则应用于现有无效 文档的更新。
validationAction	串	可选的。确定是error对无效文档还是仅对warn 违规，但允许插入无效文档。 3.2版中的新功能。 重要 文件的验证仅适用于由validationLevel。 validationAction 描述 "error" 默认文档必须在写入之前通过验证。否则，写入操作将失败。 "warn" 文档不必通过验证。如果文档验证失败，则写操作将记录验证失败。
indexOptionDefaults	文献	可选的。允许用户在创建集合时为索引指定默认配置。 该indexOptionDefaults选项接受一个storageEngine 文档，该文档应采用以下格式： 复制 { <storage-engine-name>: <options> } 创建索引时进行验证，并记录到存储引擎配置中指定OPLOG复制到支持副本集与使用不同的存储引擎成员中。 3.2版中的新功能。
viewOn	串	从中创建视图的源集合或视图的名称。名称不是集合或视图的完整名称空间；即不包含数据库名称，并且暗示与要创建的视图相同的数据库。您必须在与源集合相同的数据库中创建视图。 另请参阅db.createView()。 3.4版的新功能。
pipeline	数组	由聚合管道阶段组成的数组。 db.createView通过将指定的值pipeline应用于viewOn集合或视图来创建视图。 视图定义pipeline不能包含$out或$merge阶段。如果视图定义包括嵌套管道（例如，视图定义包括 $lookup或$facet阶段），则此限制也适用于嵌套管道。 视图定义是公共的；即db.getCollectionInfos() ，explain对视图的操作将包括定义视图的管道。因此，请避免在视图定义中直接引用敏感字段和值。 另请参阅db.createView()。 3.4版的新功能。
collation	文献	指定集合的默认排序规则。 归类允许用户为字符串比较指定特定于语言的规则，例如字母大写和重音符号的规则。 排序规则选项具有以下语法： 复制 collation: { locale: <string>, caseLevel: <boolean>, caseFirst: <string>, strength: <int>, numericOrdering: <boolean>, alternate: <string>, maxVariable: <string>, backwards: <boolean> } 指定排序规则时，该locale字段为必填字段；所有其他排序规则字段都是可选的。有关字段的说明，请参见整理文档。 如果您在集合级别指定排序规则： 除非索引创建操作显式指定其他排序规则，否则将使用该排序规则创建该集合上的索引。 该集合上的操作使用集合的默认排序规则，除非它们明确指定其他排序规则。 您不能为一个操作指定多个排序规则。例如，您不能为每个字段指定不同的排序规则，或者如果对排序执行查找，则不能对查找使用一种排序规则，而对排序使用另一种排序规则。 如果没有为集合或操作指定排序规则，则MongoDB使用先前版本中使用的简单二进制比较进行字符串比较。 对于集合，您只能在集合创建期间指定排序规则。设置后，您将无法修改集合的默认排序规则。 有关示例，请参见指定整理。 3.4版的新功能。
writeConcern	文献	可选的。表示 该操作的写关注点的文档。省略使用默认的写关注。 当分片群集上发出，mongos转换 写入关注的的 create命令及其助手 db.createCollection()来"majority"。

访问控制¶

如果部署强制执行 身份验证/授权，则 db.createCollection()需要以下特权：

readWrite在数据库上具有内置角色的用户具有运行列出的操作所需的特权。无论是 创建一个用户与所需的角色或角色授予现有的用户。

行为¶

例子¶

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

db.createCollection( "contacts", {
   validator: { $jsonSchema: {
      bsonType: "object",
      required: [ "phone" ],
      properties: {
         phone: {
            bsonType: "string",
            description: "must be a string and is required"
         },
         email: {
            bsonType : "string",
            pattern : "@mongodb\.com$",
            description: "must be a string and match the regular expression pattern"
         },
         status: {
            enum: [ "Unknown", "Incomplete" ],
            description: "can only be one of the enum values"
         }
      }
   } }
} )

db.contacts.insert( { name: "Amanda", status: "Updated" } )

WriteResult({
   "nInserted" : 0,
   "writeError" : {
      "code" : 121,
      "errmsg" : "Document failed validation"
   }
})

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

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