Mongo.startSession() (método mongosh)

Definición

Mongo.startSession(<options>)

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

Importante

Método mongosh

Esta página documenta un método mongosh. No se trata de la documentación de comandos de base de datos ni de controladores específicos de lenguajes de programación, como Node.js.

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

Para obtener información sobre los controladores de la API de MongoDB, consulte la documentación del controlador 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 startSession() puede tomar un documento con opciones de sesión. Las opciones disponibles son:

Campo	Descripción
Coherencia causal	Booleano. Habilita o deshabilita la consistencia causal para la sesión. Mongo.startSession() habilita causalConsistency por defecto. Mutuamente excluyente con snapshot. 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 opción --retryWrites, retryWrites se habilita de forma predeterminada para Mongo.startSession(). 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 administrado 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 objeto de conexión Mongo() asociado con la variable global db de mongosh:

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