db.createCollection()

在本页面

• Definition

• Access Control

• Examples

Definition

• db. createCollection(* name ， options *)

  • 在版本 3.4 中进行了更改：添加了对以下内容的支持：

• 创建视图(另请参见db.createView())。

• Collation.

创建一个新集合或view。

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

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

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>,
                              pipeline: <pipeline>,
                              collation: <document> } )

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

Parameter	Type	Description
name	string	要创建的集合的名称。参见Naming Restrictions。
options	document	可选的。用于创建有上限的集合，用于在新集合中预分配空间或用于创建视图的配置选项。

options文档包含以下字段：

Field	Type	Description
capped	boolean	可选的。要创建capped collection，请指定true。如果指定true，则还必须在size字段中设置最大大小。
autoIndexId	boolean	可选的。指定false以禁用在_id字段上自动创建索引。

Access Control

如果部署实施authentication/authorization，则db.createCollection()需要以下特权：

	Required Privileges
创建一个无上限的集合	createCollection在数据库上， 或
insert在要创建的集合上
创建capped collection	convertToCapped的集合 createCollection在数据库上
创建view	createCollection在数据库上 or createCollection在数据库上和 find在源集合/视图上 or createCollection在数据库上，find在要创建的视图上，和 find在源集合/视图上 在数据库上具有createCollection且在视图上具有find的用户没有足够的特权。

readWrite内置角色包含必需的特权。或者，您可以创建一个自定义角色支持db.createCollection()。

下面的示例使用db.createUser()方法在admin数据库中创建一个用户，该用户在inventory和employees数据库中具有readWrite角色：

db.getSiblingDB("admin").createUser(
  {
    "user" : "createViewUser",
    "pwd" : "replaceThisWithASecurePassword",
    "roles" : [
      { "db" : "inventory", "role" : "readWrite" },
      { "db" : "employees", "role" : "readWrite" }
    ]
  }
)

创建的用户可以在指定的数据库上执行db.createCollection()。有关创建用户的更多示例，请参见Add Users。

或者，您可以使用db.grantRolesToUser()将所需角色添加到现有用户。有关向现有数据库用户添加特权的教程，请参见修改现有用户的访问权限。

Examples

创建上限集合

封顶的集合具有最大的大小或文档数，可防止其增长到超过最大阈值。所有设置上限的集合必须指定最大大小，并且还可以指定最大文档数。如果集合在达到最大文档数之前达到最大大小限制，则 MongoDB 会删除较旧的文档。考虑以下示例：

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

此命令将创建一个名为log的集合，该集合的最大大小为 5 MB，最多 5000 个文档。

有关上限集合的更多信息，请参见Capped Collections。

使用文档验证创建集合

3.2 版中的新功能。

具有验证的集合将每个插入或更新的文档与validator选项中指定的条件进行比较。根据validationLevel和validationAction，MongoDB 要么返回警告，要么在文档不符合指定条件时拒绝插入或更新文档。

以下示例使用 JSON 模式验证器创建contacts集合：

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中返回错误：

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

有关更多信息，请参见Schema Validation。要查看集合的验证规范，请使用db.getCollectionInfos()方法。

Specify Collation

3.4 版的新功能。

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

您可以在集合或view级别指定collation。例如，以下操作创建一个集合，为该集合指定排序规则(有关排序规则字段的描述，请参见Collation Document)：

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 } )

该操作按以下 Sequences 返回文档：

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

使用简单二进制排序规则(即没有特定的排序规则集)的集合上的相同操作将按以下 Sequences 返回文档：

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

指定存储引擎选项

3.0 版中的新功能。

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

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

此操作将创建一个名为users的新集合，该集合具有一个特定的配置字符串，MongoDB 将传递给wiredTiger存储引擎。有关特定的wiredTiger选项，请参见收集级别选项的 WiredTiger 文档。