create

可选。包含每个时间序列文档中元数据的字段名称。指定字段中的元数据应该是用于标记唯一文档序列的数据。元数据很少或几乎不会更改。指定字段的名称不能是_id或与timeseries.timeField相同。该字段可以是任何数据类型。

尽管metaField字段是可选的，但使用元数据可以提高查询优化。例如，MongoDB会自动为新集合在metaField和timeField字段上创建复合索引。如果您不为此字段提供值，数据将仅根据时间进行分桶。

可选，在设置bucketRoundingSeconds和bucketMaxSpanSeconds时不要使用。可能的值是seconds（默认）、minutes和hours。

将granularity设置为与连续传入时间戳之间的时间最接近的值。这通过优化MongoDB在集合内部存储数据的方式来提高性能。

有关粒度和分桶间隔的更多信息，请参阅设置时间序列数据的粒度。

可选，与bucketRoundingSeconds一起使用，作为granularity的替代。设置同一桶中时间戳之间的最大时间。可能的值是1-31536000。如果您设置bucketMaxSpanSeconds，则必须将bucketRoundingSeconds设置为相同的值。

要降级到MongoDB 6.3以下版本，您必须修改集合以使用相应的granularity值，或者删除集合。有关详细信息，请参阅collMod。

可选，与bucketMaxSpanSeconds一起使用，作为granularity的替代。设置MongoDB设置新桶的最小时间戳时向下舍入的秒数。必须等于bucketMaxSpanSeconds

例如，将这两个参数都设置为1800将新桶向下舍入到最近的30分钟。如果一个时间戳为2023-03-27T18:24:35Z的文档不适合现有的桶，MongoDB将创建一个新的桶，其最小时间为2023-03-27T18:00:00Z，最大时间为2023-03-27T18:30:00Z。

从MongoDB 5.3版本开始，您可以使用聚簇索引创建集合。聚簇索引存储在与集合相同的WiredTiger文件中。结果集合称为聚簇集合。

clusteredIndex字段具有以下语法

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

key

必需。聚簇索引键字段。必须设置为{ _id: 1 }。_id字段的默认值是一个自动生成的唯一对象标识符，但您可以设置自己的聚簇索引键值。

unique

必需。必须设置为true。唯一索引表示集合不接受插入或更新的文档，其中聚簇索引键值与索引中现有值匹配。

name

可选。一个唯一标识聚簇索引的名称。

可选。

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

• 前像是替换、更新或删除之前的文档。对于插入的文档没有前像。

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

• 使用db.createCollection()、create或collMod启用changeStreamPreAndPostImages以启用集合的变更流前像和后像。

changeStreamPreAndPostImages具有以下语法

changeStreamPreAndPostImages: {
   enabled: <boolean>
}

要为集合启用变更流前像和后像，请将enabled设置为true。

有关变更流输出的完整示例，请参阅带有文档前像和后像的变更流。

有关本页上的create示例，请参阅创建具有变更流文档前像和后像的集合。

可选。仅适用于 WiredTiger 存储引擎。

允许用户在创建集合时针对每个集合指定对存储引擎的配置。 storageEngine 选项的值应采用以下形式

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

在创建集合时指定的存储引擎配置将在复制过程中进行验证并记录到 oplog 中，以支持使用不同存储引擎的副本集成员。

从 MongoDB 7.2 开始，您无法在创建集合时指定 wiredTiger 存储引擎加密选项。要配置 WiredTiger 存储引擎的加密，请参阅 静态加密。

有关更多信息，请参阅 指定存储引擎选项。

可选。允许用户为集合指定 验证规则或表达式。

validator 选项接受一个文档，指定验证规则或表达式。您可以使用与 查询运算符 相同的运算符来指定表达式，但除外 $near、$nearSphere、$text 和 $where。

• 验证发生在更新和插入期间。现有文档在修改之前不会进行验证检查。

• 您不能为 admin、local 和 config 数据库中的集合指定验证器。

• 您不能为 system.* 集合指定验证器。

可选。确定 MongoDB 在更新期间如何严格地应用验证规则到现有文档。

"off"

插入或更新时没有验证。

"strict"

默认 对所有插入和所有更新应用验证规则。

"moderate"

对插入以及现有 有效 文档的更新应用验证规则。不要将规则应用于现有 无效 文档的更新。

可选。确定是否在无效文档上 error 或仅 warn 关于违规情况，但允许无效文档被插入。

文档的验证仅适用于由 validationLevel 确定的文档。

"error"

默认 写入发生之前，文档必须通过验证。否则，写入操作失败。

"warn"

文档不需要通过验证。如果文档验证失败，则写入操作记录验证失败。

可选。允许用户在创建集合时指定索引的默认配置。

indexOptionDefaults 选项接受一个 storageEngine 文档，其形式如下：

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

在创建索引时指定的存储引擎配置会被验证并记录到操作日志中，以支持使用不同存储引擎的副本集成员。

要创建视图的源集合或视图的名称。该名称不是集合或视图的全命名空间；即不包括数据库名称，并暗示与要创建的视图相同的数据库。您必须在与源集合相同的数据库中创建视图。

另请参阅 db.createView()。

一个数组，由聚合管道阶段组成。 create 通过将指定的 pipeline 应用到 viewOn 集合或视图来创建视图。

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

视图定义是公开的；即 db.getCollectionInfos() 和视图上的 explain 操作将包括定义视图的管道。因此，请避免在视图定义中直接引用敏感字段和值。

另请参阅 db.createView()。

指定集合或视图的默认 校对。

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

collation 选项具有以下语法

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

指定校对时，locale 字段是必需的；所有其他校对字段都是可选的。有关字段的描述，请参阅校对文档。

如果您在集合级别指定了校对

• 该集合上的索引将使用该校对创建，除非索引创建操作明确指定了不同的校对。

• 该集合上的操作使用集合的默认校对，除非它们明确指定了不同的校对。

  您不能为操作指定多个校对。例如，您不能为每个字段指定不同的校对，或者在执行带有排序的查找时，您不能为查找和排序使用不同的校对。

如果未指定集合或操作中的校对，MongoDB 将使用先前版本中用于字符串比较的简单二进制比较。

对于一个视图，如果没有指定排序规则，视图的默认排序规则是“简单”的二进制比较排序器。对于一个集合上的视图，视图不会继承集合的排序规则设置。对于一个视图上的视图，要创建的视图必须指定相同的排序规则。

在创建集合或视图之后，无法更新其默认排序规则。

有关在创建集合时指定默认排序规则的示例，请参阅指定排序规则。

可选。一个文档，表示操作的写关注。省略以使用默认写关注。

当在分片集群上执行时，mongos将写关注转换为"majority"。

可选。一个文档，用于配置正在创建的集合的可查询加密。

要使用集合中的加密字段，请指定新的配置选项。您必须具有创建和修改集合的权限才能创建或编辑此配置。

配置包括字段列表及其对应的密钥标识符、类型和支持的查询。

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, … }
    ]
}

有关详细信息，请参阅教程。

可选。用户提供的注释，附加到此命令。一旦设置，此注释将出现在以下位置的此命令记录旁边

• mongod 日志消息，在attr.command.cursor.comment字段中。

• 数据库分析器输出，在command.comment字段中。

• currentOp输出，在command.comment字段中。

注释可以是任何有效的BSON类型（字符串、整数、对象、数组等）。