Bases de datos y colecciones

Overview

En esta guía, puedes aprender a usar el driver .NET/C# para acceder y administrar bases de datos y colecciones de MongoDB.

MongoDB organiza los datos en una estructura jerárquica. Una implementación de MongoDB contiene una o más bases de datos, y cada base de datos contiene una o más colecciones. En cada colección, MongoDB almacena datos como documentos que contienen pares de campo y valor.

Para aprender más sobre el formato de datos de los documentos, se puede consultar Documentos en el manual del servidor.

Acceder a una base de datos

Puedes acceder a una base de datos recuperando una instancia de IMongoDatabase de tu IMongoClient instancia. Puedes usar la IMongoDatabase instancia devuelta para realizar operaciones a nivel de base de datos y acceder a las colecciones que contiene la base de datos.

Para crear un IMongoDatabase, llama al método GetDatabase() en una instancia de IMongoClient, pasando el nombre de la base de datos como parámetro. También puedes pasar un MongoDatabaseSettings opcional como parámetro para personalizar cómo accedes a una base de datos.

Si pasas el nombre de una base de datos inexistente al método GetDatabase(), el controlador seguirá devolviendo una instancia de IMongoDatabase. Cuando insertas cualquier dato en una colección de esta base de datos, el servidor crea la base de datos y la colección en ese momento.

El siguiente ejemplo crea un cliente y luego usa el método GetDatabase() para acceder a una base de datos llamada test_db:

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

Listar bases de datos

Para ver una lista de las bases de datos de su implementación, llame al método asíncrono ListDatabaseNamesAsync() method or synchronous ListDatabaseNames() en su instancia IMongoClient.

Para ver información detallada sobre cada base de datos, llame al método asíncrono ListDatabasesAsync() method or synchronous ListDatabases() en su instancia IMongoClient. Estos métodos devuelven campos que describen las bases de datos en el clúster, como su tamaño y si contienen datos.

El siguiente código muestra cómo utilizar el método asíncrono ListDatabaseNamesAsync() o el método síncrono ListDatabaseNames() para listar los nombres de las bases de datos en un clúster:

await mongoClient.ListDatabaseNamesAsync();

mongoClient.ListDatabaseNames();

Descartar una base de datos

Eliminar una base de datos borra permanentemente todos los datos de sus colecciones. Para eliminar una base de datos, llame al método asíncrono DropDatabaseAsync() method or synchronous DropDatabase() en su instancia IMongoClient, pasando el nombre de la base de datos como parámetro.

El siguiente código muestra cómo usar el método asincrónico DropDatabaseAsync() o el método sincrónico DropDatabase() para descartar una base de datos llamada test_db:

await mongoClient.DropDatabaseAsync("test_db");

mongoClient.DropDatabase("test_db");

Acceder a una colección

Puedes acceder a una colección recuperando un método IMongoCollection en una instancia IMongoDatabase. También 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() puedes pasar un objeto MongoCollectionSettings opcional como parámetro para personalizar la forma en que accedes a una colección.

Si pasas el nombre de una colección inexistente a este método, el controlador sigue devolviendo una instancia de IMongoCollection. Cuando insertas cualquier dato en esta colección, el servidor lo crea. Para aprender cómo crear explícitamente una colección, consulta la sección Crear una colección de esta guía.

Este ejemplo utiliza el método GetCollection() para acceder a una colección llamada coll_xyz desde una base de datos referenciada por la variable myDB:

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

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

Crear una colección

Puedes crear explícitamente una colección llamando al método asíncrono CreateCollectionAsync() method or synchronous CreateCollection() en tu instancia IMongoDatabase.

Este método toma el nombre de la colección y un tipo opcional CreateCollectionOptions como parámetros. Luego, puedes acceder a la colección creada para realizar operaciones de datos, crear agregaciones y administrar índices.

El siguiente código muestra cómo usar el método asincrónico CreateCollectionAsync() o el método sincrónico CreateCollection() para crear una colección llamada coll_abc dentro de una base de datos referenciada por la variable myDB:

await myDB.CreateCollectionAsync("coll_abc");

myDB.CreateCollection("coll_abc");

Listar colecciones

Para ver una lista de colecciones en una base de datos, llame al método asíncrono ListCollectionNamesAsync() method or synchronous ListCollectionNames() en su instancia IMongoDatabase.

Para ver información detallada sobre cada base de datos, llame al método asíncrono ListCollectionsAsync() method or synchronous ListCollections() en su instancia IMongoDatabase. Estos métodos devuelven campos que describen las colecciones en la base de datos, como sus tipos y configuraciones.

El siguiente código muestra cómo usar el método asíncrono ListCollectionNamesAsync() o el método sincrónico ListCollectionNames() para listar los nombres de las colecciones en una base de datos:

await myDB.ListCollectionNamesAsync();

myDB.ListCollectionNames();

Descarta una colección

Al eliminar una colección, se borran permanentemente todos los datos que contiene. Para eliminar una colección, llame al método asíncrono DropCollectionAsync() method or the synchronous DropCollection() en su instancia de IMongoCollection.

El siguiente código muestra cómo usar el método asincrónico DropCollectionAsync() o el método sincrónico DropCollection() para descartar una base de datos llamada coll_abc:

await myDB.DropCollectionAsync("coll_abc");

myDB.DropCollection("coll_abc");

Información Adicional

Para más información sobre los conceptos de esta guía, consulta la siguiente documentación:

• Guía para Insertar documentos

• Bases de datos y colecciones en el manual del servidor

• Documentos en el manual del servidor