defaultMaxTimeMS

Definición

defaultMaxTimeMS

Nuevo en la versión 8.0.

Disponible para ambos mongod y mongos.

Especifica un límite de tiempo por defecto en milisegundos para que se completen las operaciones individuales de lectura. Si una query especifica una opción maxTimeMS(), ese valor reemplazará el valor defaultMaxTimeMS.

defaultMaxTimeMS se aplica a las siguientes operaciones de lectura:

• aggregate (excepto las etapas $merge y $out)

• count

• dbHash

• distinct

• find

Control de acceso

Para modificar los parámetros del clúster, se debe autenticar como un usuario que tenga uno de los siguientes roles:

• clusterAdmin

• clusterMonitor

Sintaxis

Para configurar defaultMaxTimeMS para su implementación, ejecute el siguiente comando en la base de datos de admin:

db.adminCommand(
   {
      setClusterParameter: {
         defaultMaxTimeMS: { readOperations: <value> }
      }
   }
)

Para ver el valor actual de defaultMaxTimeMS, ejecuta el siguiente comando en la base de datos admin:

db.adminCommand( { getClusterParameter: "defaultMaxTimeMS" } )

Comportamiento

Por defecto, defaultMaxTimeMS.readOperations es 0, lo que significa que no se establece un tiempo de espera predeterminado para la query. Si no hay un tiempo de espera de query predeterminado, la query se ejecuta hasta que se devuelva un resultado o se produzca un error.

Si una query especifica una opción maxTimeMS(), ese valor sobrescribe el valor defaultMaxTimeMS.

Ejemplo

El siguiente comando establece el tiempo de espera por defecto de la query en 5000 milisegundos:

db.runCommand( {
   setClusterParameter: {
      defaultMaxTimeMS: { readOperations: 5000 }
   }
} )

Para comprobar el valor de defaultMaxTimeMS, ejecute el siguiente comando:

db.adminCommand( { getClusterParameter: "defaultMaxTimeMS" } )

{
   "clusterParameters" : [
      {
         "_id" : "defaultMaxTimeMS",
         "clusterParameterTime" : Timestamp(1711564868, 17),
         "readOperations" : Long(5000)
      }
   ],
   "ok" : 1,
   "$clusterTime" : {
      "clusterTime" : Timestamp(1712161244, 1),
      "signature" : {
         "hash" : BinData(0,"AAAAAAAAAAAAAAAAAAAAAAAAAAA="),
         "keyId" : Long(0)
      }
   },
   "operationTime" : Timestamp(1712161244, 1)
}

db.test.find( { name: "Carol" } )
db.test.find( { name: "Carol" } ).maxTimeMS( 8000 )