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

Você pode acessar um banco de dados de dados recuperando uma instância do IMongoDatabase da sua instância do IMongoClient . Você pode usar a instância IMongoDatabase retornada para executar operações em nível de banco de dados e acessar collections que o banco de dados de dados contém.

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

Para ver uma lista dos bancos de dados de seu sistema, chame o método assíncrono ListDatabaseNamesAsync() ou o método síncrono ListDatabaseNames() em sua instância IMongoClient .

Para ver informações detalhadas sobre cada banco de dados, chame o método assíncrono ListDatabasesAsync() ou o método síncrono ListDatabases() em sua instância IMongoClient . Esses métodos retornam campos descrevendo os bancos de dados no cluster, como seus tamanhos e se contêm dados.

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

await mongoClient.ListDatabaseNamesAsync();

mongoClient.ListDatabaseNames();

Soltar um banco de dados

A eliminação de um banco de dados exclui permanentemente todos os dados nas coleções desse banco de dados. Para descartar um banco de dados, chame o método assíncrono DropDatabaseAsync() ou o método síncrono DropDatabase() em sua instância IMongoClient , passando o nome do banco de dados como parâmetro.

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

await mongoClient.DropDatabaseAsync("test_db");

mongoClient.DropDatabase("test_db");

Acessar uma coleção

Você pode acessar uma coleção recuperando uma instância IMongoCollection do seu banco de dados. Você pode usar uma instância IMongoCollection para executar operações de dados, criar agregações e gerenciar índices. Para recuperar um IMongoCollection, chame o método GetCollection() em uma instância IMongoDatabase . Você também pode passar um MongoCollectionSettings opcional como parâmetro para personalizar como você acessa uma coleção.

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

Você pode criar explicitamente uma coleção chamando o método assíncrono CreateCollectionAsync() ou o método síncrono CreateCollection() em sua instância IMongoDatabase .

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 CreateCollectionAsync() assíncrono ou o método síncrono CreateCollection() para criar uma coleção chamada coll_abc dentro de um banco de dados referenciado pela variável myDB :

await myDB.CreateCollectionAsync("coll_abc");

myDB.CreateCollection("coll_abc");

Listar coleções

Para ver uma lista de coleções em um banco de dados, chame o método assíncrono ListCollectionNamesAsync() ou o método síncrono ListCollectionNames() em sua instância IMongoDatabase .

Para ver informações detalhadas sobre cada banco de dados, chame o método assíncrono ListCollectionsAsync() ou o método síncrono ListCollections() em sua instância IMongoDatabase . Esses métodos retornam campos descrevendo as collections no banco de dados, como seus tipos e configurações.

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

await myDB.ListCollectionNamesAsync();

myDB.ListCollectionNames();

Solte uma coleção

A eliminação de uma coleção exclui permanentemente todos os dados dessa coleção. Para soltar uma coleção, chame o método assíncrono DropCollectionAsync() ou o método síncrono DropCollection() em sua instância IMongoCollection .

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

await myDB.DropCollectionAsync("coll_abc");

myDB.DropCollection("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