Configurar las operaciones CRUD

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 opciones de preocupación de escritura, preocupación de lectura y preferencia de lectura en los siguientes niveles:

• Cliente, que establece el valor predeterminado 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 de prioridad creciente de la configuración de las opciones. Por ejemplo, si se establece un nivel de lectura para una transacción, este anulará el nivel de lectura establecido para el cliente.

Estas opciones le permiten personalizar la consistencia causal y la disponibilidad de los datos en sus conjuntos de réplicas.

Nivel de confirmación de escritura

La preocupación de escritura especifica el nivel de confirmación solicitado a MongoDB para operaciones de escritura, como una inserción o una actualización, 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 la preocupación de escritura.

Para más información, consulte Escribir preocupación en el manual del servidor MongoDB. Para obtener documentación detallada de la API, consulte la documentación de la API de Escribir preocupación.

La siguiente tabla describe la 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

La preocupación de lectura especifica los siguientes comportamientos:

• Nivel de consistencia causal entre conjuntos de réplicas

• Garantías de aislamiento mantenidas durante una consulta

Puede especificar la configuración de la preocupación de lectura mediante el parámetro level. El nivel de preocupación de lectura predeterminado es local. Esto significa que el cliente devuelve los datos del miembro del conjunto de réplicas al que está conectado, sin garantía de que se hayan escrito en todos los miembros del conjunto de réplicas.

Para obtener más información sobre las preocupaciones de lectura o sus niveles, consulte "Preocupación 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 preocupación de lectura, consulte "Preocupación de lectura" en la documentación de la 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 qué miembro de un conjunto de réplicas lee MongoDB cuando se ejecuta una consulta.

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 escrituras reintentables

El controlador Ruby vuelve a intentar automáticamente ciertas operaciones de lectura y escritura una vez si fallan debido a un error de red o 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 deshabilita las lecturas y escrituras reintentables 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 reintentable compatibles, consulte "Lecturas reintentables" en el manual de MongoDB Server. Para obtener más información sobre las operaciones de escritura reintentable compatibles, consulte "Escrituras reintentables" en el manual de MongoDB Server.

Documentación de la API

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

• Nivel de confirmación de escritura

• readConcern

• preferencia de lectura