create

在本页面

• Definition

• Considerations

• Access Control

• Examples

Definition

• create
  • 在版本 3.4 中进行了更改：添加了对视图创建和Collation规范的支持。

明确创建一个集合或视图。 create的格式如下：

{
  create: <collection or view name>,
  capped: <true|false>,
  autoIndexId: <true|false>,
  size: <max_size>,
  max: <max_documents>,
  flags: <0|1|2|3>,
  storageEngine: <document>,
  validator: <document>,
  validationLevel: <string>,
  validationAction: <string>,
  indexOptionDefaults: <document>,
  viewOn: <source>,
  pipeline: <pipeline>,
  collation: <document>,
  writeConcern: <document>
}

create具有以下字段：

Field	Type	Description
create	string	新集合或视图的名称。参见Naming Restrictions。
capped	boolean	可选的。要创建capped collection，请指定true。如果指定true，则还必须在size字段中设置最大大小。
autoIndexId	boolean	可选的。指定false以禁用在_id字段上自动创建索引。

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

Considerations

create命令在受影响的数据库上获得了写锁定，并将阻止其他操作，直到完成为止。该操作的写锁定通常是短暂的。但是，分配给上限较大的 collections 可能需要更长的时间。

Access Control

如果部署实施authentication/authorization，则create需要以下特权：

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

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

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

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

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

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

Examples

创建上限集合

要创建一个限制为 64 KB 的capped collection，请发出以下格式的命令：

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

创建视图

3.4 版的新功能。

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

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

或如果指定排序规则：

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

例如，给定集合survey包含以下文档：

{ _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 } } ]
} )

Specify Collation

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

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

该操作按以下 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.runCommand( {
    create: "users",
    storageEngine: { wiredTiger: { configString: "<option>=<setting>" } }
} )

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