本章节我们为大家介绍如何使用 MongoDB 来创建集合。
MongoDB 中使用 createCollection() 方法来创建集合。
语法格式：
db.createCollection(name, options)
参数说明：
- name: 要创建的集合名称。
- options: 可选参数, 指定有关内存大小及索引的选项。
options 可以是如下参数：
| 参数名 | 类型 | 描述 | 示例值 |
capped |
布尔值 | 是否创建一个固定大小的集合。 | true |
size |
数值 | 集合的最大大小（以字节为单位）。仅在 capped 为 true 时有效。 |
10485760 (10MB) |
max |
数值 | 集合中允许的最大文档数。仅在 capped 为 true 时有效。 |
5000 |
validator |
对象 | 用于文档验证的表达式。 | { $jsonSchema: { ... }} |
validationLevel |
字符串 | 指定文档验证的严格程度。<br>"off"：不进行验证。<br>"strict"：插入和更新操作都必须通过验证（默认）。<br>"moderate"：仅现有文档更新时必须通过验证，插入新文档时不需要。 |
"strict" |
validationAction |
字符串 | 指定文档验证失败时的操作。<br>"error"：阻止插入或更新（默认）。<br>"warn"：允许插入或更新，但会发出警告。 |
"error" |
storageEngine |
对象 | 为集合指定存储引擎配置。 | { wiredTiger: { ... }} |
collation |
对象 | 指定集合的默认排序规则。 | { locale: "en", strength: 2 } |
在插入文档时，MongoDB 首先检查固定集合的 size 字段，然后检查 max 字段。
使用这些选项创建一个集合的实例：
实例
db.createCollection("myComplexCollection", {
capped: true,
size: 10485760,
max: 5000,
validator: { $jsonSchema: {
bsonType: "object",
required: ["name", "email"],
properties: {
name: {
bsonType: "string",
description: "必须为字符串且为必填项"
},
email: {
bsonType: "string",
pattern: "^.+@.+$",
description: "必须为有效的电子邮件地址"
}
}
}},
validationLevel: "strict",
validationAction: "error",
storageEngine: {
wiredTiger: { configString: "block_compressor=zstd" }
},
collation: { locale: "en", strength: 2 }
});
这个例子创建了一个集合，具有以下特性：
- 固定大小，最大 10MB，最多存储 5000 个文档。
- 文档必须包含
name和email字段，其中name必须是字符串，email必须是有效的电子邮件格式。 - 验证级别为严格，验证失败将阻止插入或更新。
- 使用 WiredTiger 存储引擎，指定块压缩器为 zstd。
- 默认使用英语排序规则。
实例
在 test 数据库中创建 runoob 集合：
> use test
switched to db test
> db.createCollection("runoob")
{ "ok" : 1 }
>
如果要查看已有集合，可以使用 show collections 或 show tables 命令：
> show collections
runoob
system.indexes
下面是带有几个关键参数的 createCollection() 的用法：
创建了一个固定大小的集合，最大大小为 5MB（5242880 字节），最多存储 5000 个文档。
db.createCollection("myCappedCollection", { capped: true, size: 5242880, max: 5000 });
在 MongoDB 中，你不需要创建集合，当你插入一些文档时，MongoDB 会自动创建集合。
> db.mycol2.insert({"name" : "菜鸟教程"})
> show collections
mycol2
...
创建了一个最大大小为 1MB（1048576 字节）的固定大小集合：
db.createCollection("myCappedCollection", { capped: true, size: 1048576 });
以下例子为 myCollection 集合创建了一个验证器，要求文档中必须有 name 和 age 字段，且 name 必须是字符串，age 必须是非负整数。
实例
db.createCollection("myCollection", {
validator: { $jsonSchema: {
bsonType: "object",
required: ["name", "age"],
properties: {
name: {
bsonType: "string",
description: "必须为字符串且为必填项"
},
age: {
bsonType: "int",
minimum: 0,
description: "必须为整数且为必填项"
}
}
}}
});
