数据库和集合

Overview

在本指南中，您可以了解如何使用 .NET/C# 驱动程序访问和管理 MongoDB 数据库和集合。

MongoDB 以分层结构组织数据。 MongoDB 部署包含一个或多个数据库，每个数据库又包含一个或多个集合。 在每个collection中，MongoDB 将数据存储为包含字段与值对的文档。

要学习；了解有关文档数据格式的更多信息，请参阅服务器手册中的文档。

访问数据库

You can access a database by retrieving an IMongoDatabase instance from your IMongoClient instance. You can use the returned IMongoDatabase instance to perform database-level operations and access collections that the database contains.

要创建IMongoDatabase ，请在 IMongoClient 实例上调用 GetDatabase() 方法，并将数据库名称作为参数传递。您还可以传递可选的 MongoDatabaseSettings 作为参数，以自定义访问权限数据库的方式。

如果将不存在的数据库名称传递给GetDatabase()方法，驱动程序仍会返回IMongoDatabase实例。 当您将任何数据插入此数据库中的集合时，服务器会同时创建数据库和集合。

以下示例创建一个客户端，然后使用GetDatabase()方法访问名为test_db的数据库：

var client = new MongoClient("<connection string>");
var myDB = mongoClient.GetDatabase("test_db");

listDatabases

To see a list of your deployment's databases, call the asynchronous ListDatabaseNamesAsync() method or synchronous ListDatabaseNames() method on your IMongoClient instance.

要查看有关每个数据库的详细信息，请在 实例上调用异步 ListDatabasesAsync() 方法或同步 ListDatabases() IMongoClient方法。这些方法返回描述集群中数据库的字段，例如它们的大小以及是否包含数据。

以下代码演示如何使用异步ListDatabaseNamesAsync()方法或同步ListDatabaseNames()方法列出集群中的数据库名称：

await mongoClient.ListDatabaseNamesAsync();

mongoClient.ListDatabaseNames();

删除数据库

删除数据库会永久删除该数据库集合中的所有数据。要删除数据库，请对 实例调用异步 DropDatabaseAsync() 方法或同步 DropDatabase() IMongoClient方法，并将数据库名称作为参数传递。

以下代码演示如何使用异步DropDatabaseAsync()方法或同步DropDatabase()方法删除名为test_db的数据库：

await mongoClient.DropDatabaseAsync("test_db");

mongoClient.DropDatabase("test_db");

访问集合

You can access a collection by retrieving an IMongoCollection instance from your database. You can use an IMongoCollection instance to perform data operations, create aggregations, and manage indexes. To retrieve an IMongoCollection, call the GetCollection() method on an IMongoDatabase instance. You can also pass an optional MongoCollectionSettings as a parameter to customize how you access a collection.

如果将不存在的集合名称传递给此方法，驱动程序仍会返回IMongoCollection实例。 当您将任何数据插入此集合时，服务器都会创建该数据。 要了解如何显式创建集合，请参阅本指南的创建集合部分。

此示例使用GetCollection()方法从myDB变量引用的数据库访问名为coll_xyz的集合：

var myColl = myDB.GetCollection<BsonDocument>("coll_xyz");

var collection = database.GetCollection<BsonDocument>("coll_xyz", settings);

创建集合

您可以通过在 实例上调用异步 CreateCollectionAsync() 方法或同步 CreateCollection() IMongoDatabase方法来显式创建集合。

此方法将集合名称和可选的CreateCollectionOptions类型作为参数。然后，您可以访问权限创建的集合以执行数据操作、创建聚合和管理索引。

以下代码演示如何使用异步CreateCollectionAsync()方法或同步CreateCollection()方法在myDB变量引用的数据库中创建名为coll_abc的集合：

await myDB.CreateCollectionAsync("coll_abc");

myDB.CreateCollection("coll_abc");

listCollections

若要查看数据库中的集合列表，请对 实例调用异步 ListCollectionNamesAsync() 方法或同步 ListCollectionNames() IMongoDatabase方法。

To see detailed information about each database, call the asynchronous ListCollectionsAsync() method or synchronous ListCollections() method on your IMongoDatabase instance. These methods return fields describing the collections in the database, such as their types and settings.

以下代码演示如何使用异步ListCollectionNamesAsync()方法或同步ListCollectionNames()方法列出数据库中集合的名称：

await myDB.ListCollectionNamesAsync();

myDB.ListCollectionNames();

删除集合

删除集合会永久删除该集合中的所有数据。要删除集合，请对 实例调用异步 DropCollectionAsync() 方法或同步 DropCollection() IMongoCollection方法。

以下代码演示如何使用异步DropCollectionAsync()方法或同步DropCollection()方法删除名为coll_abc的数据库：

await myDB.DropCollectionAsync("coll_abc");

myDB.DropCollection("coll_abc");

更多信息

有关本指南中概念的更多信息，请参阅以下文档：

• 插入文档指南

• 手册中的 数据库和集合MongoDB Server

• 手册中的 文档MongoDB Server