Para agentes de IA: hay un índice de documentación disponible en https://www.mongodb.com/es/docs/llms.txt — versiones en markdown de todas las páginas están disponibles agregando .md a cualquier ruta URL.
Docs Menu
Docs Home
/ /
Driver Rust
Docs Home
/
Librerías de clientes
/
Rust
/
Driver Rust
Docs Home
/
Librerías de clientes
/
Rust
/
Driver Rust

Bases de datos y colecciones

Overview

En esta guía, aprenderás a utilizar el driver Rust para acceder y gestionar 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 Database desde tu cliente. Puedes usar una Database instancia para realizar operaciones a nivel de base de datos y acceder a las colecciones que contiene.

Llama a uno de los siguientes métodos en una instancia de Cliente para crear Database un:

Tip

Para especificar la base de datos por defecto para su cliente, establezca el campo default_database de su estructura ClientOptions. Si no configuras este campo, el controlador obtiene la base de datos predeterminada del componente defaultauthdb de tu cadena de conexión.

Si se pasan el nombre de una base de datos inexistente a los métodos database() o database_with_options(), el controlador aún devuelve una instancia de Database. Cuando insertas cualquier dato en una colección de esta base de datos, el servidor lo crea.

El siguiente ejemplo utiliza el método database() para acceder a una base de datos llamada test_db:

let db = client.database("test_db");

Listar bases de datos

Para ver una lista de las bases de datos de su implementación, llame al método list_database_names() en su Client instancia. Este método devuelve un Vec<String> tipo, un vector que contiene los nombres de las bases de datos como cadenas.

Para ver información detallada sobre cada base de datos, llame al método list_databases() en su Client instancia. Este método devuelve un Vec<DatabaseSpecification> tipo. El tipo DatabaseSpecification contiene campos que describen cada base de datos, como su tamaño y si contiene datos.

El siguiente ejemplo muestra cómo imprimir una lista de bases de datos utilizando el método list_database_names():

let db_list = client.list_database_names().await?;
println!("{:?}", db_list);

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 drop() en su Database instancia. El siguiente código muestra cómo eliminar una base de datos a la que hace referencia la db variable:

db.drop().await?;

Advertencia

Cuando eliminas una base de datos, se borran datos

Al eliminar una base de datos, se borran de forma permanente todos los documentos de las colecciones de la base de datos y todos los índices de esas colecciones. Después de descartar una base de datos, no puedes acceder ni restaurar ninguno de sus datos.

Acceder a una colección

Puedes acceder a una colección recuperando una instancia de Collection de tu base de datos. Puedes usar una Collection instancia para realizar operaciones de datos, crear agregaciones y administrar índices. Llama a uno de los siguientes métodos en una Database instancia para recuperar Collection una:

Si pasas el nombre de una colección inexistente a los métodos collection() o collection_with_options(), el controlador aún devuelve una instancia Collection. Cuando insertas cualquier dato en esta colección, el servidor lo crea. Para aprender a crear una colección explícitamente, consulte la sección Crear una colección de esta guía.

Este ejemplo utiliza el método collection_with_options() para realizar las siguientes acciones:

  • Acceda a una colección llamada coll_xyz desde una base de datos referenciada por la variable db

  • Establece una preferencia de guardar en la colección del tipo CollectionOptions

let wc = WriteConcern::builder().journal(true).build();
let coll_opts = CollectionOptions::builder().write_concern(wc).build();
let my_coll: Collection<Document> = db.collection_with_options("coll_xyz", coll_opts);

Para obtener más información sobre los niveles de confirmación de escritura (write concerns), consulta Nivel de confirmación de escritura (write concern) en el manual del servidor.

Parametrización de colecciones

Debes parametrizar tu instancia de Collection especificando en qué tipo de dato quieres serializar los datos de la colección. Cuando llamas a un método en una instancia Collection que está parametrizada con un tipo específico, el método acepta o devuelve instancias de este tipo.

Nota

Si no parametrizas tu instancia de Collection, el compilador inferirá el tipo genérico cuando realices una operación CRUD con un tipo de datos especificado en el mismo ámbito.

El siguiente ejemplo muestra formas equivalentes de parametrizar una colección con el tipo Document:

let my_coll: Collection<Document> = client.database("test_db").collection("coll_xyz");
let my_coll = client.database("test_db").collection::<Document>("coll_xyz");

Tip

Te recomendamos que parametrices tu instancia de Collection con un tipo personalizado que modele tus datos en vez del tipo Document. Puedes evitar la serialización y validación repetitivas si defines un tipo que modele tus datos específicos.

Para obtener más información sobre la serialización en el driver de Rust, consulte la guía sobre modelado de datos y serialización.

Crear una colección

Puedes crear una colección explícitamente llamando al método create_collection() en una Database instancia. Este método recibe el nombre de la colección como parámetro. Puedes usar una Collection instancia para realizar operaciones de datos, crear agregaciones y administrar índices.

El siguiente código muestra cómo crear una colección llamada coll_abc dentro de una base de datos referenciada por la variable db:

db.create_collection("coll_abc").await?;

Al crear una colección, puedes implementar validación de esquema para mantener un esquema de documentos coherente y controlar si alguna operación de escritura puede pasar por alto las reglas de validación. Para aprender cómo habilitar esta funcionalidad, consulta la guía sobre Validación de esquema.

Listar colecciones

Para ver los nombres de las colecciones en una base de datos, llame al método list_collection_names() en su Database instancia. Este método devuelve un Vec<String> tipo, un vector que contiene los nombres de las colecciones como cadenas.

To see detailed information about each collection, call the list_collections() method on your Database instance. This method returns a Vec<CollectionSpecification> type. The CollectionSpecification type contains fields describing each collection, such as its type and settings.

El siguiente ejemplo muestra cómo imprimir los nombres de las colecciones en una base de datos referenciadas por la variable db utilizando el método list_collection_names():

let coll_list = db.list_collection_names().await?;
println!("{:?}", coll_list);

Descarta una colección

Dropping a collection permanently deletes all the data in that collection. To drop a collection, call the drop() method on your Collection instance. The following code shows how to drop a collection referenced by the my_coll variable:

my_coll.drop().await?;

Advertencia

Al descartar una colección, se borran datos

Al borrar una colección de tu base de datos, se eliminan permanentemente todos los documentos dentro de esa colección y todos los índices de esa colección. Después de que descartes una colección, no puedes acceder ni hacer la restauración de ninguno de sus datos.

Información Adicional

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

Volver
AWS Lambda
Next
Operaciones CRUD
Califique esta página

En esta página