Configurar las operaciones CRUD

Overview

En esta guía, puedes aprender a utilizar las configuraciones de nivel de confirmación de escritura (write concern), nivel de consistencia de lectura y preferencia de lectura para modificar la forma en que MongoDB ejecuta operaciones de crear, leer, actualizar y borrar (CRUD) en sets de réplicas.

Puedes establecer las opciones de nivel de confirmación de escritura (write concern), nivel de consistencia de lectura y preferencia de lectura en los siguientes niveles:

• Cliente, que establece el por defecto para todas las ejecuciones de operaciones, a menos que se anule

• sesión

• transacción

• Database

• Colección

La lista anterior también indica el orden creciente de precedencia de la configuración de las opciones. Por ejemplo, si estableces un nivel de consistencia de lectura para una transacción, este anulará cualquier nivel de consistencia de lectura configurado para el cliente.

Estas opciones permiten personalizar la coherencia causal y la disponibilidad de los datos en los sets de réplicas.

Nivel de confirmación de escritura

El nivel de confirmación de escritura (write concern) especifica el nivel de reconocimiento solicitado a MongoDB para las operaciones de escritura, como una inserción o actualización, antes de que la operación se devuelva con éxito. Las operaciones que no especifican un nivel de confirmación de escritura (write concern) explícito heredan la configuración global de nivel de confirmación de escritura (write concern) por defecto.

Para más información, consulte nivel de confirmación de escritura (write concern) en el manual de MongoDB Server. Para obtener documentación detallada de la API, consulta la documentación sobre la API de nivel de confirmación de escritura (write concern).

La siguiente tabla describe el write_concern parámetros:

client = Mongo::Client.new(['IP_ADDRESS_001:27017'], database: 'myDB')
myDB = client.database
myCollection = myDB[:myCollection]
myCollection.insert_one(
  { name: 'anotherDocumentName' },
  write: {
    w: 2,
    wtimeout: 5000
  }
)

myDoc = { name: 'New Document' }
new_write_concern = Mongo::WriteConcern.get(myDB.write_concern)
myDB[:myCollection].with(write: new_write_concern).insert_one(myDoc)

readConcern

El nivel de consistencia de lectura especifica los siguientes comportamientos:

• Nivel de coherencia causal en todos los sets de réplicas

• Garantías de aislamiento mantenidas durante una query

Puede especificar el ajuste de nivel de consistencia de lectura utilizando el parámetro level. El nivel de consistencia de lectura predeterminado es local. Esto significa que el cliente devuelve los datos del miembro del set de réplicas al que está conectado el cliente, sin garantía de que los datos hayan sido escritos en todos los miembros del set de réplicas.

Para obtener más información sobre los niveles de consistencia de lectura o los niveles de consistencia de lectura, consulta Nivel de consistencia de lectura en el manual de MongoDB Server. Para obtener más detalles sobre el read_concern tipo y las definiciones de los niveles de consistencia de lectura, consulte nivel de consistencia de lectura en la documentación de API.

pipeline = [
  { "$match" => { category: 'KITCHENWARE' } },
  { "$unset" => ['_id', 'category'] }
]
result = myCollection.aggregate(pipeline,
read: { read_concern: { level: :available } })

client = Mongo::Client.new(['IP_ADDRESS_001:27017'], 
  database: 'mydb', 
  read_concern: { level: :local })
myDB = client.database

preferencia de lectura

La preferencia de lectura determina de qué nodo de un set de réplicas de MongoDB se realiza una lectura al ejecutar una query.

Para una documentación de la API más detallada, consulta la Documentación de la API de Preferencias de Lectura.

La siguiente tabla muestra las opciones que puede utilizar para personalizar cómo el servidor evalúa a los miembros:

transaction_options = {
  read: { mode: :primary },
  read_concern: { level: :local },
  write_concern: { w: :majority }
}
session = client.start_session
session.start_transaction(transaction_options)
session.commit_transaction
# ...
rescue => e
    session.abort_transaction
    puts "Transaction aborted due to an error: #{e.message}"
ensure
    session.end_session
end

uri = 'mongodb+srv://<user>:<password>@<cluster-url>'
options = {
  read: {
    mode: :secondary,
    max_staleness: 120
  }
}
client = Mongo::Client.new(uri, options)
myDB = client.database

Lecturas y Guardados Reintentarles

El controlador de Ruby reintenta automáticamente ciertas operaciones de lectura y escritura una vez en caso de que fallen debido a un error de red o de servidor.

Puede deshabilitar explícitamente las lecturas o escrituras reintentables modernas configurando las opciones retry_reads o retry_writes en false al crear un nuevo cliente. Si se configura en false, se habilita el comportamiento de reintento heredado.

El siguiente ejemplo desactiva las lecturas y guardados reintentar automáticas modernas para un cliente:

uri = 'mongodb+srv://<user>:<password>@<cluster-url>'
options = { 
  retry_reads: false, 
  retry_writes: false 
}
client = Mongo::Client.new(uri, options)
myDB = client.database

Para obtener más información sobre las operaciones de lectura repetibles admitidas, consulte Lecturas repetibles en el manual de MongoDB Server. Para obtener más información sobre las operaciones de escritura reintentables admitidas, consulta Escrituras reintentables en el manual del MongoDB Server.

Documentación de la API

Para obtener más información sobre los métodos y tipos mencionados en esta guía, vea la siguiente documentación de la API:

• Nivel de confirmación de escritura

• readConcern

• preferencia de lectura