/ /

/ /

Librerías de clientes

Driver C#/.NET

Fundamentals

Configurar operaciones en conjuntos de réplicas

Overview

En esta guía, puede aprender a usar las configuraciones de preocupaciónde escritura,preocupación de lectura y preferencia de lectura para modificar la forma en que MongoDB ejecuta operaciones de creación, lectura, actualización y eliminación (CRUD) en conjuntos de réplicas.

Puede establecer estas configuraciones en los siguientes niveles:

Cliente, que establece el valor predeterminado para todas las ejecuciones de operaciones a menos que se anule
Transacción
Database
Colección

Esta lista está en orden de precedencia creciente. Por ejemplo, si se configuran preocupaciones de lectura tanto a nivel de cliente como de base de datos, la preocupación de lectura especificada a nivel de base de datos anula la preocupación de lectura a nivel de cliente.

Nivel de confirmación de escritura

La preocupación de escritura especifica el nivel de confirmación solicitado a MongoDB para las operaciones de escritura antes de que la operación se retorne correctamente. Las operaciones que no especifican una preocupación de escritura explícita heredan la configuración global predeterminada de preocupación de escritura.

Puede configurar el problema de escritura configurando el WriteConcern opción en un objeto MongoClientSettings, MongoDatabaseSettings o MongoCollectionSettings, o utilizando el método WithWriteConcern() de una instancia de cliente, base de datos o colección.

La opción WriteConcern y el método WithWriteConcern() aceptan una instancia WriteConcern como parámetro. Puede especificar el problema de escritura utilizando uno de los siguientes valores:

WriteConcern.Acknowledged:La operación de escritura regresa después de que la operación se escribe en la memoria.
WriteConcern.W1:La operación de escritura regresa después de que solo el nodo principal reconoce la operación de escritura, sin esperar el reconocimiento de los nodos secundarios.
WriteConcern.W2:La operación de escritura regresa después de que el nodo principal y al menos un nodo secundario reconocen la operación de escritura.
WriteConcern.W3:La operación de escritura regresa después de que el nodo principal y al menos dos nodos secundarios reconocen la operación de escritura.
WriteConcern.WMajority:La operación de escritura regresa después de que la mayoría de los miembros del conjunto de réplicas reconocen la operación de escritura.
WriteConcern.Unacknowledged:La operación de escritura regresa después de que el nodo principal procesa la operación de escritura.

El siguiente ejemplo establece la preocupación de escritura en WriteConcern.WMajority para una instancia de MongoClient:

var mongoClientSettings = MongoClientSettings.FromConnectionString("<connection string URI>");
mongoClientSettings.WriteConcern = WriteConcern.WMajority;
var mongoClient = new MongoClient(mongoClientSettings);

El siguiente ejemplo establece la preocupación de escritura en WriteConcern.WMajority para una colección:

var collection = database.GetCollection<BsonDocument>("<collection name>")
                         .WithWriteConcern(WriteConcern.WMajority);

Nota

Los clientes, las colecciones y las bases de datos son inmutables

IMongoClientLas instancias IMongoDatabase y IMongoCollection son inmutables. Al configurar la preocupación de escritura en un cliente, una base de datos o una colección, el método devuelve una nueva instancia con la configuración especificada y no afecta a la instancia original.

Para obtener más información sobre la preocupación por la escritura, consulte Escriba Preocupación en el manual del servidor MongoDB.

readConcern

La lectura de preocupación especifica los siguientes comportamientos:

Nivel de consistencia causal entre conjuntos de réplicas
Garantías de aislamiento mantenidas durante una consulta

Puede especificar la preocupación de lectura configurando la opción ReadConcern en un objeto MongoClientSettings, MongoDatabaseSettings o MongoCollectionSettings, o utilizando el método WithReadConcern() en un cliente, base de datos o colección.

Tanto la opción ReadConcern como el método WithReadConcern() aceptan un único parámetro que especifica el nivel de preocupación de lectura.

Puedes establecer los siguientes niveles de consistencia de lectura:

ReadConcern.LocalLa consulta devuelve los datos más recientes de la instancia. No garantiza que los datos se hayan escrito en la mayoría de los miembros del conjunto de réplicas.
ReadConern.AvailableLa consulta devuelve los datos más recientes de la instancia. No garantiza que los datos se hayan escrito en la mayoría de los miembros del conjunto de réplicas. ReadConcern.Available no está disponible para sesiones y transacciones causalmente consistentes.
ReadConcern.Majority:La consulta devuelve datos que han sido reconocidos por la mayoría de los miembros del conjunto de réplicas.
ReadConcern.Linearizable:La consulta devuelve datos que reflejan todas las escrituras exitosas que se completaron antes del inicio de la operación de lectura. ReadConcern.Linearizable no está disponible para su uso con sesiones y transacciones causalmente consistentes.
ReadConcern.Snapshot:La consulta devuelve datos mayoritariamente confirmados tal como aparecen en los fragmentos, desde un único punto específico en el pasado reciente.

Para obtener más información sobre los niveles de preocupación de lectura, consulte Niveles de preocupación de lectura en el manual de MongoDB Server.

El siguiente ejemplo establece la preocupación de lectura en ReadConcern.Majority para una instancia de MongoClient:

var mongoClientSettings = MongoClientSettings.FromConnectionString("<connection string URI>");
mongoClientSettings.ReadConcern = ReadConcern.Majority;
var mongoClient = new MongoClient(mongoClientSettings);

El siguiente ejemplo establece la preocupación de lectura en ReadConcern.Majority para una colección:

var collection = database.GetCollection<BsonDocument>("<collection name>")
                         .WithReadConcern(ReadConcern.Majority);

Para obtener más información sobre la preocupación de lectura, consulte Preocupación de lectura en el manual de MongoDB Server.

preferencia de lectura

La preferencia de lectura determina qué miembro de un conjunto de réplicas lee MongoDB al ejecutar una consulta. Puede configurar la preferencia de lectura configurando la opción ReadPreference en un objeto MongoClientSettings, MongoDatabaseSettings o MongoCollectionSettings, o usando el método WithReadPreference() en un cliente, base de datos o colección.

La opción ReadPreference y el método WithReadPreference() aceptan un modo de preferencia de lectura como parámetro. Puede establecer el modo de preferencia de lectura en uno de los siguientes valores:

ReadPreference.Primary:La consulta devuelve datos del nodo principal.
ReadPreference.PrimaryPreferredLa consulta devuelve datos del nodo principal si está disponible. De lo contrario, devuelve datos de un nodo secundario.
ReadPreference.Secondary:La consulta devuelve datos de un nodo secundario.
ReadPreference.SecondaryPreferred:La consulta devuelve datos de un nodo secundario si está disponible. De lo contrario, la consulta devuelve datos del nodo principal.
ReadPreference.Nearest:La consulta devuelve datos del nodo con la latencia de red más baja.

El siguiente ejemplo establece la preferencia de lectura en ReadPreference.Secondary para una instancia de MongoClient:

var mongoClientSettings = MongoClientSettings.FromConnectionString("<connection string URI>");
mongoClientSettings.ReadPreference = ReadPreference.Secondary;
var mongoClient = new MongoClient(mongoClientSettings);

El siguiente ejemplo establece la preferencia de lectura en ReadPreference.Secondary para una colección:

var collection = database.GetCollection<BsonDocument>("<collection name>")
                         .WithReadPreference(ReadPreference.Secondary);

Para obtener más información sobre las preferencias de lectura, consulte Preferencias de lectura en el manual de MongoDB Server.

Documentación de la API

Para obtener más información sobre cualquiera de los tipos analizados en esta guía, consulte la siguiente documentación de API:

Volver

Almacene archivos grandes

Monitoring