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

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 ノードに送信されます。. より前のバージョンのMongoDBでは、 はすぐにシャットダウンし、5 0mongostimeoutSecs を使用しません。

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

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

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

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