db.shutdownServer()（mongoshメソッド）

db.shutdownServer()

Shuts down the current mongod or mongos process cleanly and safely. You must issue the db.shutdownServer() operation against the admin database.

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

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

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

フィールド	説明
力	任意: mongod または mongos を強制的にシャットダウンするには、true を指定します。強制シャットダウンは、mongod または mongos で実行中の操作を中断し、予期しない動作が発生する可能性があります。 You can pause and resume in-progress index builds using force. See db.shutdownServer() on Replica Set Members for more information.
timeoutSecs	任意。 MongoDB 5.0 以降では、mongod と mongos は、シャットダウン前に進行中のデータベース操作を完了できるように休止期間に入ります。 mongod プライマリがシャットダウン要求を受信すると、プライマリは次の処理を実行します。 セカンダリへのステップダウンを試みます。 ステップダウンに失敗し… shutdown or db.shutdownServer() command was run, mongod only continues the shut down steps if the force field is true, or a SIGTERM シグナルがmongodに送信された場合、mongod は常にシャットダウン手順を続行します。 休止期間に入ります。 残りのデータベース操作を終了します。 シャットダウンします。 mongod セカンダリまたは mongos シャットダウン要求の場合、シャットダウンが要求された後に休止期間に入ります。 休止期間は、次の方法で指定されます。 timeoutSecs field if a shutdown or db.shutdownServer() command was run, or 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 ノードに送信されます。. より前のバージョンのMongoDBでは、 はすぐにシャットダウンし、5 0mongostimeoutSecs を使用しません。

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

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

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

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