db.shutdownServer()

項目一覧

動作

アクセス制御
例

バージョン 5.0 での変更。

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`秒です。

フィールド

説明

力

任意: 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コマンドのラッパーを提供します。

動作

mongod自己管理型配置の認証を使用して開始されたの場合、認証された接続を介してdb.shutdownServer() を実行する必要があります。詳しくは、「アクセス制御」を参照してください。

mongod自己管理型配置で認証なしで開始されたの場合、ローカルホストdb.shutdownServer() インターフェースに接続されたクライアントからを実行する必要があります。たとえば、mongosh --host "127.0.0.1"と同じホストマシンでオプションを使用してmongod を実行します