创建

定义

create

显式创建集合或视图。

注意

此命令创建的视图不引用物化视图。有关按需物化视图的讨论，请参阅 $merge 。

create 采用以下形式：

注意

从 MongoDB 4.2 开始

MongoDB删除了 MMAPv1storage engine 和 的 MMAPv1 特定选项flags create{2 }。

{
  create: <collection or view name>,
  capped: <true|false>,
  timeseries: {
     timeField: <string>,
     metaField: <string>,
     granularity: <string>
  },
  expireAfterSeconds: <number>,
  autoIndexId: <true|false>,
  size: <max_size>,
  max: <max_documents>,
  storageEngine: <document>,
  validator: <document>,
  validationLevel: <string>,
  validationAction: <string>,
  indexOptionDefaults: <document>,
  viewOn: <source>,
  pipeline: <pipeline>,
  collation: <document>,
  writeConcern: <document>,
  comment: <any>
}

create 有以下字段：

字段	类型	说明
create	字符串	新collection或视图的名称。请参阅命名限制。
capped	布尔	可选。要创建固定大小集合，请将该字段设为 true。如果将该字段设为 true，则还须在 size 字段中设置最大大小。
timeseries.timeField	字符串	创建时间序列集合时需要。包含每个时间序列文档中日期的字段的名称。时间序列集合中的文档必须具有有效 BSON 日期，以作为 timeField 的值。
timeseries.metaField	字符串	可选。包含每个时间序列文档中元数据的字段的名称。指定字段中的元数据应用于标识一系列唯一文档的数据。元数据应该很少改变（如果有的话）。 指定字段的名称可能不是 _id 或与 timeseries.timeField 不同。该字段可为除数组之外的任意类型。
timeseries.granularity	字符串	可选。 可能的值为"seconds" （默认值）、 "minutes"和"hours" 。 将粒度设置为与连续传入测量之间的时间跨度最接近的值。 准确设置granularity参数可优化time-series collection中数据的内部存储方式，从而提高性能。
expireAfterSeconds	数字	可选。 通过指定文档过期后的秒数，启用自动删除时间序列集合中文档的功能。 MongoDB 会自动删除过期文档。
autoIndexId	布尔	可选。 指定false可禁用在_id字段上自动创建索引的功能。 重要 从 MongoDB 4.0 开始，在数据库以外的数据库中创建collection时，不能将选项autoIndexId设置为false 。local 自 3.2 版起已弃用。
size	整型	可选。指定固定大小集合的最大大小（以字节为单位）。一旦固定大小集合达到其最大大小，MongoDB 就会删除旧文档，为新文档腾出空间。对于固定大小集合，size 字段为必需项，对于其他集合，则忽略该字段。
max	整型	可选。固定大小集合中允许的最大文档数。size限制优先于此限制。如果固定大小集合在达到最大文档数之前达到size限制，则 MongoDB 将删除旧文档。如果您希望使用max限制，请确保固定大小集合所需的size限制足以包含最大数量的文档。
storageEngine	文档	可选。仅适用于 WiredTiger 存储引擎。 允许用户在创建集合时针对每个集合指定存储引擎的配置。storageEngine 选项的值应采用以下形式： { <storage-engine-name>: <options> } 在复制过程中，对创建集合时指定的存储引擎配置进行验证并记录到 oplog 中，以支持节点使用不同存储引擎的副本集。 提示 另请参阅： 指定存储引擎选项
validator	文档	可选。 允许用户为collection指定验证规则或表达式。有关更多信息，请参阅模式验证。 版本 3.2 中的新增功能。 validator 选项采用指定验证规则或表达式的文档。可以使用与该查询运算符相同的操作符来指定表达式，但 $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	阵列	由聚合管道阶段组成的数组。create 通过将指定的 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"。
comment	任何	可选。用户提供的待附加到该命令的注释。设置后，该注释将与该命令的记录一起出现在以下位置： mongod 日志消息，位于 attr.command.cursor.comment 字段中。 command.comment 字段中的数据库分析器输出。 currentOp 输出，在 command.comment 字段。 注释可以是任何有效的 BSON 类型（字符串、整型、对象、数组等）。 4.4 版本新增。

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

行为

访问控制

如果部署强制执行身份验证/授权，则 create 需要以下权限：

在数据库中拥有 readWrite 内置角色的用户具有运行列表操作所需的特权。创建一个拥有所需角色的用户，或者将该角色授予现有用户。

举例

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

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

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

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

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

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

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