デフォルトMaxTimeMS

定義

defaultMaxTimeMS

バージョン8.0の新機能。

Atlas クラスターとセルフホスト型配置

個々の読み取り操作が完了するまでのクラスター全体のデフォルトの時間制限（ミリ秒単位）を指定します。クエリで maxTimeMS() オプションが指定されている場合、その値は defaultMaxTimeMS の値を上書きします。

defaultMaxTimeMS 次の読み取り操作に適用されます。

• aggregate （ $merge } ステージと$outステージを除く）

• count

• dbHash

• distinct

• find

アクセス制御

クラスター パラメーターを変更するには、次のいずれかのロールを持つユーザーとして認証する必要があります。

• clusterAdmin

• clusterMonitor

構文

配置用にdefaultMaxTimeMSを設定するには、 adminデータベースで次のコマンドを実行します。

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

defaultMaxTimeMSの現在の値を表示するには、 adminデータベースで次のコマンドを実行します。

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

動作

デフォルトでは 、 defaultMaxTimeMS.readOperationsは0であり、デフォルトのクエリ タイムアウトは設定されていません。 デフォルトのクエリ タイムアウトがない場合、クエリは結果を返すか失敗するまで実行されます。

クエリでmaxTimeMS()オプションが指定されている場合、その値はdefaultMaxTimeMSの値を上書きします。

例

次のコマンドは、デフォルトのクエリ タイムアウトを5000ミリ秒に設定します。

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

defaultMaxTimeMSの値を確認するには、次のコマンドを実行します。

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 )