db.shutdownServer()

db.shutdownServer()

現在のmongodまたはmongosプロセスを正常かつ安全にシャットダウンします。 db.shutdownServer()管理データベース に対して 操作を発行する必要があります。

db.shutdownServer()の構文は次のとおりです。

db.shutdownServer({
  force: <boolean>,
  timeoutSecs: <int>
})

メソッドは次のフィールドを取ります。

フィールド	説明
力	任意: mongod または mongos を強制的にシャットダウンするには、true を指定します。強制シャットダウンは、mongod または mongos で実行中の操作を中断し、予期しない動作が発生する可能性があります。 force を使用して、進行中のインデックスビルドを一時停止および再開できます。 db.shutdownServer()詳細については、「レプリカセット ノード」の を参照してください。
timeoutSecs	任意。 MongoDB 5.0 以降では、mongod と mongos は、シャットダウン前に進行中のデータベース操作を完了できるように休止期間に入ります。 mongod プライマリがシャットダウン要求を受信すると、プライマリは次の処理を実行します。 セカンダリへのステップダウンを試みます。 ステップダウンに失敗し… shutdownまたはdb.shutdownServer() コマンドが実行された場合、 はmongod forceフィールドが true の場合のみシャットダウン手順を続行します。 SIGTERMシグナルがmongodに送信された場合、 mongodは常にシャットダウン手順を続行します。 休止期間に入ります。 残りのデータベース操作を終了します。 シャットダウンします。 mongod セカンダリまたは mongos シャットダウン要求の場合、シャットダウンが要求された後に休止期間に入ります。 休止期間は、次の方法で指定されます。 または コマンドが実行された場合は shutdowndb.shutdownServer()timeoutSecsフィールド、または SIGTERM シグナルが mongodに送信された場合は、shutdownTimeoutMillisForSignaledShutdown サーバー パラメーター、または SIGTERM シグナルが mongos に送信された場合は、mongosShutdownTimeoutMillisForSignaledShutdown になります。 クライアントは、シャットダウン中の mongod または mongos への新しい接続を開くことができません。 timeoutSecs は、秒単位で期間を指定します。デフォルトのとおりです。 MongoDB 5.0 以降のバージョンでは 15 秒です。 MongoDB 5.0 以前のバージョンでは 10 秒です。 mongodは timeoutSecs を次のように使用します。 現在のノードがレプリカセットの プライマリノードである場合、mongod は プライマリノード を降格する前に、選挙可能な ノードが追いつくまで timeoutSecsフィールドで指定された秒数まで待機します。キャッチアップ時間の詳細については、 「 レプリケーションラグ 」を参照してください。 プライマリから降格した後に現在のノードがSECONDARY 状態になっている場合、 timeoutSecs で指定された残りの時間は休止期間に使用され、既存の操作を完了できます。新しい操作は他のレプリカセットノードに送信されます。 MongoDB5.0 以降、mongos は timeoutSecs を休止期間として使用し、既存の操作を完了できるようにします。新しい操作は他のmongos ノードに送信されます。5.0 より前のバージョンのMongoDBでは、 mongosはすぐにシャットダウンし、 timeoutSecs を使用しません。 MongoDB4.4 以前では、mongod プライマリ の場合、 timeoutSecs はセカンダリが追いつくまでプライマリが待機する秒数です。指定された時間内にどのセカンダリも追いつかなければ、コマンドは失敗します。 デフォルトは 10 秒です。

この操作はshutdownコマンドのラッパーを提供します。

db.getSiblingDB("admin").shutdownServer()

db.getSiblingDB("admin").shutdownServer({ "force" : true })

db.getSiblingDB("admin").shutdownServer({ "timeoutSecs": 60 })