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 para la sesión. Mongo.startSession() habilita causalConsistency por defecto. 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.
writeConcern	Documento. Especifica el asunto de escritura. Para modificar la configuración después de iniciar una sesión,Session.getOptions().setWriteConcern() consulte.

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