Bancos de dados e coleções

Visão geral

Neste guia, você pode aprender como usar o Driver .NET/C# para acessar e gerenciar bancos de dados e coleções MongoDB.

O MongoDB organiza os dados em uma estrutura hierárquica. Um sistema do MongoDB contém um ou mais bancos de dados, e cada banco de dados contém uma ou mais collections. Em cada collection, o MongoDB armazena dados como documento que contêm pares de campo e valor.

Para saber mais sobre o formato de dados do documento , consulte Documentos no manual do servidor.

Acessar um banco de dados

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.

Para criar um IMongoDatabase, chame o método GetDatabase() em uma instância do IMongoClient, passando o nome do banco de dados como um parâmetro. Você também pode passar um MongoDatabaseSettings opcional como parâmetro para personalizar como você acessa um banco de dados.

Se você passar o nome de um banco de dados inexistente para o método GetDatabase() , o driver ainda retornará uma instância do IMongoDatabase . Quando você insere quaisquer dados em uma coleção neste banco de dados, o servidor cria o banco de dados e a coleção naquele momento.

O exemplo abaixo cria um cliente e usa o método GetDatabase() para acessar um banco de dados chamado test_db:

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

bancos de dados de lista

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

To see detailed information about each database, call the synchronous ListDatabases() method or asynchronous ListDatabasesAsync() method on your IMongoClient instance. These methods return fields describing the databases in the cluster, such as their sizes and whether they contain data.

O código a seguir mostra como usar o método síncrono ListDatabaseNames() ou o método assíncrono ListDatabaseNamesAsync() para listar os nomes dos bancos de dados em um cluster:

mongoClient.ListDatabaseNames();

await mongoClient.ListDatabaseNamesAsync();

Soltar um banco de dados

Dropping a database permanently deletes all the data in that database's collections. To drop a database, call the synchronous DropDatabase() method or asynchronous DropDatabaseAsync() method on your IMongoClient instance, passing the database name as the parameter.

O código abaixo mostra como usar o método síncrono DropDatabase() ou o método assíncrono DropDatabaseAsync() para descartar um banco de dados chamado test_db:

mongoClient.DropDatabase("test_db");

await mongoClient.DropDatabaseAsync("test_db");

Acessar uma coleção

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.

Se você passar o nome de uma collection inexistente para esse método, o driver ainda retornará uma instância IMongoCollection . Quando você insere quaisquer dados nessa coleção, o servidor os cria. Para saber como criar explicitamente uma collection, consulte a seção Criar uma collection deste guia.

Este exemplo utiliza o método GetCollection() para acessar uma coleção denominada coll_xyz a partir de um banco de dados referenciado pela variável myDB :

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

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

Criar uma coleção

You can explicitly create a collection by calling the synchronous CreateCollection() method or asynchronous CreateCollectionAsync() method on your IMongoDatabase instance.

Este método usa o nome da coleção e um tipo CreateCollectionOptions opcional como parâmetros. Você pode então acessar a coleção criada para executar operações de dados, criar agregações e gerenciar índices.

O código a seguir mostra como usar o método síncrono CreateCollection() ou o método assíncrono CreateCollectionAsync() para criar uma coleção chamada coll_abc dentro de um banco de dados referenciado pela variável myDB:

myDB.CreateCollection("coll_abc");

await myDB.CreateCollectionAsync("coll_abc");

Listar coleções

To see a list of collections in a database, call the synchronous ListCollectionNames() method or asynchronous ListCollectionNamesAsync() method on your IMongoDatabase instance.

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

O seguinte código mostra como utilizar o método síncrono ListCollectionNames() ou o método assíncrono ListCollectionNamesAsync() para listar os nomes das coleções em um banco de dados:

myDB.ListCollectionNames();

await myDB.ListCollectionNamesAsync();

Solte uma coleção

Dropping a collection permanently deletes all the data in that collection. To drop a collection, call the synchronous DropCollection() or the asynchronous DropCollectionAsync() method on your IMongoCollection instance.

O código abaixo mostra como usar o método síncrono DropCollection() ou o método assíncrono DropCollectionAsync() para descartar um banco de dados chamado coll_abc:

myDB.DropCollection("coll_abc");

await myDB.DropCollectionAsync("coll_abc");

Informações adicionais

Para obter mais informações sobre os conceitos deste guia, consulte a seguinte documentação:

• Guia Inserir documentos

• Bancos de dados e collections no manual do servidor MongoDB

• Documentos no manual do servidor MongoDB