startSession (comando de base de datos)

Definición

startSession

El comando inicia una nueva operación startSession lógica. sesión para una secuencia de operaciones.

Tip

mongoshEn, este comando también se puede ejecutar a través del método Mongo.startSession() auxiliar.

Los métodos asistente son convenientes para usuarios de mongosh, pero es posible que no proporcionen el mismo nivel de información que los comandos de base de datos. En los casos en que no se necesite la conveniencia o se requieran campos de retorno adicionales, utiliza el comando de base de datos.

Compatibilidad

Este comando 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.

Sintaxis

El comando tiene la siguiente sintaxis:

db.runCommand(
   {
     startSession: 1
   }
)

Para ejecutar,startSession db.runCommand( { <command> } ) utilice el método.

db.runCommand(
   {
     startSession: 1
   }
)

Comportamiento

Si la implementación exige autenticación/autorización, debe estar autenticado para ejecutar el comando. El startSession startSession usuario que ejecuta es el propietario de la sesión creada y solo él puede usarla.

Si la implementación no exige autenticación/autorización, la sesión creada no tendrá propietario y cualquier usuario podrá usarla en cualquier conexión. Si el usuario se autentica y crea una sesión para una implementación que no exige autenticación/autorización, el usuario será el propietario de la sesión. Sin embargo, cualquier usuario en cualquier conexión podrá usarla.

Si la implementación pasa a autenticación sin tiempo de inactividad, no se podrá utilizar ninguna sesión sin propietario.

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.

Salida

Además del estado y el tiempo de operación del comando, devuelve startSession la siguiente información específica de la sesión:

id: { id: <UUID> }