数据库和集合

Overview

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

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

要了解有关文档数据格式的更多信息，请参阅 MongoDB Server手册中的 文档 。

访问数据库

您可以通过检索 IMongoDatabase 来访问权限数据库IMongoClient 实例中的实例。您可以使用返回的IMongoDatabase 实例执行数据库级操作并访问权限数据库包含的集合。

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

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

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

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

listDatabases

要查看部署的数据库列表，请调用异步 ListDatabaseNamesAsync() 方法或同步 ListDatabaseNames() IMongoClient实例上的方法。

若要查看有关每个数据库的详细信息，请调用异步 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");

访问集合

您可以通过检索 IMongoCollection 来访问集合 数据库中的实例。您可以使用IMongoCollection实例执行数据操作、创建聚合和管理索引。 要检索IMongoCollection ，请调用 GetCollection() IMongoDatabase实例上的方法。您还可以传递可选的 MongoCollectionSettings 作为参数来自定义访问集合的方式。

如果将不存在的集合名称传递给此方法，驱动程序仍会返回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实例上的方法。

要查看有关每个数据库的详细信息，请调用异步 ListCollectionsAsync() 方法或同步 ListCollections() IMongoDatabase实例上的方法。这些方法返回描述数据库中集合的字段，例如它们的类型和设置。

以下代码演示如何使用异步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