Mongo.startSession() (método mongosh)

Definición

Mongo.startSession(<options>)

Comienza 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. Esta no es la documentación para los comandos de base de datos ni para los drivers específicos de lenguajes, como Nodo.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 solo se puede usar con el objeto MongoClient que la creó. No se pueden usar varias sesiones simultáneamente. Las operaciones que usan una sola sesión deben ejecutarse secuencialmente.

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

Campo	Descripción
Consistencia causal	Booleano. Habilita o deshabilita la consistencia causal de la sesión. Mongo.startSession() causalConsistency habilita por defecto. Mutuamente excluyente snapshot con. Después de iniciar una sesión, no podrás modificar su configuración causalConsistency. La sesión puede tener habilitada la consistencia causal aunque el Mongo() objeto de conexión la tenga deshabilitada, o viceversa. Para configurar la consistencia causal en el objeto de conexión,Mongo.setCausalConsistency() consulte.
readConcern	Documento. Especifica el nivel de consistencia de lectura. Para modificar la configuración después de iniciar una sesión,Session.getOptions().setReadConcern() consulte.
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,Session.getOptions().setReadPreference() consulte.
retryWrites	Booleano. Habilita o deshabilita la posibilidad de reintentar escrituras al detectar errores transitorios de red. 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 podrás modificar su configuración retryWrites.
snapshot	Booleano. Habilita la lectura de instantáneas para la sesión en 5.0implementaciones de MongoDB o más. Se excluye mutuamente causalConsistency con.
writeConcern	Documento. Especifica el asunto de escritura. Para modificar la configuración después de iniciar una sesión,Session.getOptions().setWriteConcern() consulte.

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());