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で指定された残りの時間は休止期間に使用され、既存の操作を完了できます。 新しい操作は他のレプリカセット ノードに送信されます。 MongoDB 5.0以降、 mongosはtimeoutSecsを休止期間として使用し、既存の操作を完了できるようにします。 新しい操作は他のmongosノードに送信されます。 5より前のバージョンの MongoDB で 。 0 、 mongosはすぐにシャットダウンし、 timeoutSecsを使用しません。 MongoDB 4.4以前では、 mongodプライマリの場合、 timeoutSecsはセカンダリが追いつくまでプライマリが待機する秒数です。 指定された時間内にどのセカンダリも追いつかなければ、コマンドは失敗します。 デフォルトは10秒です。

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

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

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

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