Mongo.startSession() (método mongosh)

Definición

Mongo.startSession(<options>)

Inicia una sesión para la conexión. asigna el ID de sesión a los comandos asociados con lamongosh sesión.

Importante

Método mongosh

Esta página documenta un método.mongosh Esta no es la documentación para comandos de base de datos ni controladores específicos de lenguaje, como Node.js.

Para el comando de base de datos, consulta el comando startSession.

Para los drivers de API de MongoDB, consulte la documentación del driver de MongoDB específica del lenguaje.

Una sesión sólo se puede utilizar con el objeto MongoClient que la creó. Una sola sesión no se puede utilizar de forma simultánea. Las operaciones que utilizan una única sesión deben ejecutarse de forma secuencial.

El método puede tomar un documento con opciones de sesión. Las opciones disponibles startSession() son:

Campo	Descripción
Coherencia causal	Booleano. Habilita o deshabilita la consistencia causal para la sesión. Mongo.startSession() causalConsistency habilita por defecto. Mutuamente excluyente snapshot con. Después de iniciar una sesión, no se puede modificar su configuración causalConsistency. La sesión puede tener habilitada la consistencia causal incluso aunque el objeto de conexión Mongo() tenga la consistencia causal deshabilitada o viceversa. Para establecer la coherencia causal en el objeto de conexión, consulta Mongo.setCausalConsistency().
readConcern	Documento. Especifica el nivel de consistencia de lectura. Para modificar la configuración después de iniciar una sesión, consulta Session.getOptions().setReadConcern().
readPreference	documento. Especifica la preferencia de lectura. El documento readPreference contiene el campo mode y el campo opcional tags: { mode: <string>, tags: <array> } Para modificar la configuración después de iniciar una sesión, consulta Session.getOptions().setReadPreference().
retryWrites	booleano. Habilita o deshabilita la capacidad de reintentar guardados al encontrar errores de red transitorios. Si inicia mongosh con la --retryWrites opción, retryWrites se habilita de forma predeterminada Mongo.startSession() para. Después de iniciar una sesión, no se puede modificar su configuración retryWrites.
snapshot	booleano. Habilita lecturas de snapshot para la sesión en implementaciones de MongoDB 5.0+ . Mutuamente excluyente con causalConsistency.
writeConcern	documento. Especifica el nivel de confirmación de escritura (write concern). Para modificar la configuración después de iniciar una sesión, consulta Session.getOptions().setWriteConcern().

Compatibilidad

Este método está disponible en implementaciones alojadas en los siguientes entornos:

• MongoDB Atlas: El servicio totalmente gestionado para implementaciones de MongoDB en la nube

• MongoDB Enterprise: La versión basada en suscripción y autogestionada de MongoDB

• MongoDB Community: La versión de MongoDB con código fuente disponible, de uso gratuito y autogestionada.

Ejemplos

Lo siguiente inicia una sesión con consistencia causal y escrituras reintentables habilitadas en el Mongo() objeto de conexión asociado con mongosh la db variable global de:

db = db.getMongo().startSession({retryWrites: true, causalConsistency: true}).getDatabase(db.getName());