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 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. 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 inicias mongosh con la opción --retryWrites, retryWrites está habilitado por defecto para Mongo.startSession(). Después de iniciar una sesión, no se puede modificar su configuración retryWrites.
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().

Ejemplos

Lo siguiente inicia una sesión con coherencia 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());