Node.js - MongoDB 创建集合

你好，有抱负的程序员们！今天，我们将踏上一段激动人心的旅程，探索Node.js和MongoDB的世界。作为你友好的计算机老师，我将引导你使用Node.js在MongoDB中创建集合的过程。如果你是编程新手，不用担心——我们会一步一步来，很快你就能像专业人士一样创建集合！

MongoDB是什么？

在我们深入了解之前，让我们从基础开始。MongoDB是一个流行的NoSQL数据库，它以灵活的、类似JSON的文档形式存储数据。把它想象成一个巨大的数字文件柜，你可以在这里存储各种各样的信息，而不必太担心结构。

什么是集合？

在MongoDB中，集合就像文件柜中的文件夹。它是我们将相似文档分组的地方。例如，如果你正在构建一个图书馆数据库，你可能有书籍、作者和借阅者的集合。

设置我们的环境

首先，我们需要确保在计算机上安装了Node.js和MongoDB。如果你还没有这样做，请先访问官方网站并按照安装指南操作。

一旦一切就绪，让我们创建一个新的项目文件夹并初始化它：

mkdir mongodb-collection-tutorial
cd mongodb-collection-tutorial
npm init -y

现在，让我们安装Node.js的MongoDB驱动程序：

npm install mongodb

连接到MongoDB

好的，现在乐趣开始了！让我们创建一个名为app.js的新文件，并开始连接到我们的MongoDB数据库：

const { MongoClient } = require('mongodb');

// 连接URL
const url = 'mongodb://localhost:27017';

// 数据库名
const dbName = 'myLibrary';

// 创建一个新的MongoClient
const client = new MongoClient(url);

// 连接到服务器
async function connect() {
try {
await client.connect();
console.log('成功连接到数据库');
const db = client.db(dbName);
return db;
} catch (error) {
console.error('连接到数据库时出错：', error);
}
}

在这段代码中，我们正在设置一个连接到本地MongoDB服务器的连接。我们使用localhost:27017，这是MongoDB的默认地址。我们还指定了一个数据库名，myLibrary。不用担心如果数据库不存在——当我们第一次使用它时，MongoDB会为我们创建它。

创建集合

现在我们已连接，让我们创建我们的第一个集合！我们将在图书馆中创建一个书籍集合：

async function createCollection() {
const db = await connect();
try {
const result = await db.createCollection('books');
console.log('成功创建集合：', result.namespace);
} catch (error) {
if (error.code === 48) {
console.log('集合已存在');
} else {
console.error('创建集合时出错：', error);
}
} finally {
await client.close();
}
}

createCollection();

让我们分解一下：

1. 我们使用createCollection方法创建一个名为'books'的新集合。
2. 如果集合创建成功，我们记录一条成功消息。
3. 如果有错误，我们检查是否因为集合已存在（错误代码48）。如果是这样，我们记录一条消息说集合已存在。对于任何其他错误，我们记录错误详情。
4. 最后，我们关闭数据库连接。

为我们的集合添加选项

MongoDB允许我们在创建集合时指定选项。让我们创建一个带有一些选项的集合：

async function createCollectionWithOptions() {
const db = await connect();
try {
const options = {
capped: true,
size: 1000000,
max: 5000
};
const result = await db.createCollection('logs', options);
console.log('带有选项成功创建集合：', result.namespace);
} catch (error) {
console.error('带有选项创建集合时出错：', error);
} finally {
await client.close();
}
}

createCollectionWithOptions();

在这个例子中，我们正在创建一个名为'logs'的集合，并带有以下选项：

• capped: true - 这创建了一个固定大小的 capped 集合。
• size: 1000000 - 这将集合的最大大小设置为100万字节。
• max: 5000 - 这将集合可以持有的最大文档数设置为5000。

这些选项对于具有"滚动"性质的集合很有用，例如日志文件，你只想保留最近的条目。

检查集合是否存在

有时，在尝试创建集合之前，你可能想检查集合是否已存在。以下是如何操作的：

async function checkCollectionExists(collectionName) {
const db = await connect();
try {
const collections = await db.listCollections({name: collectionName}).toArray();
if (collections.length > 0) {
console.log(`集合 ${collectionName} 存在`);
} else {
console.log(`集合 ${collectionName} 不存在`);
}
} catch (error) {
console.error('检查集合时出错：', error);
} finally {
await client.close();
}
}

checkCollectionExists('books');

这个函数使用listCollections方法检查给定名称的集合是否存在。如果返回的数组长度大于0，则意味着集合存在。

一切结合

现在我们已经学习了创建集合，让我们在单个脚本中将它们全部放在一起：

const { MongoClient } = require('mongodb');

const url = 'mongodb://localhost:27017';
const dbName = 'myLibrary';
const client = new MongoClient(url);

async function connect() {
try {
await client.connect();
console.log('成功连接到数据库');
return client.db(dbName);
} catch (error) {
console.error('连接到数据库时出错：', error);
}
}

async function createCollections() {
const db = await connect();
try {
// 创建 'books' 集合
await db.createCollection('books');
console.log('成功创建书籍集合');

// 创建带有选项的 'logs' 集合
const logOptions = { capped: true, size: 1000000, max: 5000 };
await db.createCollection('logs', logOptions);
console.log('成功创建带有选项的日志集合');

// 检查 'authors' 集合是否存在
const collections = await db.listCollections({name: 'authors'}).toArray();
if (collections.length > 0) {
console.log('作者集合已存在');
} else {
await db.createCollection('authors');
console.log('成功创建作者集合');
}
} catch (error) {
console.error('在 createCollections 中出错：', error);
} finally {
await client.close();
}
}

createCollections();

这个脚本结合了我们学到的所有概念：

1. 连接到数据库
2. 创建一个简单的集合 ('books')
3. 创建一个带有选项的集合 ('logs')
4. 在创建之前检查集合是否存在 ('authors')

结论

恭喜你！你已经迈出了进入MongoDB和Node.js世界的第一步。我们学习了如何连接到MongoDB数据库、创建集合、为集合添加选项以及检查集合是否存在。这些都是你在继续使用MongoDB进行数据库管理时必备的技能。

记住，熟能生巧。尝试创建不同类型的集合，尝试不同的选项，不要害怕犯错误——这是我们学习的方式！

下面是我们使用的主要方法的总结：

方法	描述
MongoClient.connect()	连接到MongoDB服务器
db.createCollection()	创建一个新的集合
db.listCollections()	列出现有的集合

继续编码，继续学习，最重要的是，享受乐趣！下次见，快乐地管理数据库！

Credits: Image by storyset