Docs Menu
Docs Home
/
MongoDBマニュアル
/ / /

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() ノード」の を参照してください。

任意。

MongoDB 5.0 以降では、mongodmongos は、シャットダウン前に進行中のデータベース操作を完了できるように休止期間に入ります。

mongod プライマリがシャットダウン要求を受信すると、プライマリは次の処理を実行します。

  1. セカンダリへのステップダウンを試みます。

    ステップダウンに失敗し…

    • shutdownまたはdb.shutdownServer() コマンドが実行された場合、 はmongod forceフィールドが true の場合のみシャットダウン手順を続行します。

    • SIGTERM シグナルがmongodに送信された場合、mongod は常にシャットダウン手順を続行します。

  2. 休止期間に入ります。

  3. 残りのデータベース操作を終了します。

  4. シャットダウンします。

mongod セカンダリまたは mongos シャットダウン要求の場合、シャットダウンが要求された後に休止期間に入ります。

休止期間は、次の方法で指定されます。

クライアントは、シャットダウン中の mongod または mongos への新しい接続を開くことができません。

timeoutSecs は、秒単位で期間を指定します。デフォルトは次のとおりです。

  • MongoDB 5.0 以降のバージョンでは 15 秒です。

  • MongoDB 5.0 以前のバージョンでは 10 秒です。

mongod timeoutSecs を次のように使用します。

MongoDB5.0 以降、mongos timeoutSecs を休止期間として使用し、既存の操作を完了できるようにします。新しい操作は他の ノードに送信されます。mongos より前のバージョンのMongoDBで5 。0 、mongos はすぐにシャットダウンし、 timeoutSecs を使用しません。

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

このメソッドは、次の環境でホストされている配置で使用できます。

重要

このコマンドは、 MongoDB Atlasクラスターではサポートされていません。 すべてのコマンドの Atlas サポートの詳細については、「 サポートされていないコマンド 」を参照してください。

  • MongoDB Enterprise: サブスクリプションベースの自己管理型 MongoDB バージョン

  • MongoDB Community: ソースが利用可能で、無料で使用できる自己管理型の MongoDB のバージョン

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

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

{db.shutdownServer() mongodレプリカセット メンバーが インデックス ビルド などの特定の操作を実行している場合、 は失敗します。force: trueを指定すると、インデックスのビルド進行状況をディスクに保存できます。 mongodは再起動時にインデックス構築を回復し、保存されたチェックポイントから続行します。

MongoDB 5.0 以降では、mongodmongos は、シャットダウン前に進行中のデータベース操作を完了できるように休止期間に入ります。

mongod プライマリがシャットダウン要求を受信すると、プライマリは次の処理を実行します。

  1. セカンダリへのステップダウンを試みます。

    ステップダウンに失敗し…

    • shutdownまたはdb.shutdownServer()コマンドが実行された場合、 mongodforceフィールドが true の場合のみシャットダウン手順を続行します。

    • SIGTERM シグナルがmongodに送信された場合、mongod は常にシャットダウン手順を続行します。

  2. 休止期間に入ります。

  3. 残りのデータベース操作を終了します。

  4. シャットダウンします。

mongod セカンダリまたは mongos シャットダウン要求の場合、シャットダウンが要求された後に休止期間に入ります。

休止期間は、次の方法で指定されます。

クライアントは、シャットダウン中の mongod または mongos への新しい接続を開くことができません。

timeoutSecsは、秒単位で期間を指定します。 デフォルトは次のとおりです。

  • MongoDB 5.0 以降のバージョンでは 15 秒です。

  • MongoDB 5.0 以前のバージョンでは 10 秒です。

mongodtimeoutSecsを次のように使用します。

  • 現在のノードがレプリカセットのプライマリノードである場合、 mongodはプライマリ ノードを降格する前に、選択可能なノードが追いつくまでtimeoutSecsフィールドで指定された秒数まで待機します。 キャッチアップ時間の詳細については、「レプリケーションラグ 」を参照してください。

  • プライマリから降格した後に現在のノードがSECONDARY状態になっている場合、 timeoutSecsで指定された残りの時間は休止期間に使用され、既存の操作を完了できます。 新しい操作は他のレプリカセット ノードに送信されます。

MongoDB 5.0以降、 mongostimeoutSecsを休止期間として使用し、既存の操作を完了できるようにします。 新しい操作は他のmongosノードに送信されます。 5より前のバージョンの MongoDB で 。 0 、 mongosはすぐにシャットダウンし、 timeoutSecsを使用しません。

警告

プライマリを強制的にシャットダウンすると、セカンダリにまだレプリケートされていない書込みが ロールバックされる可能性があります。

db.shutdownServer()自己管理型配置で認証をmongod 強制する で を実行するには、認証されたユーザーに 特権が db.shutdownServer()必要 です。たとえば、組み込みロールhostManagerを持つユーザーには適切な権限があります。

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

戻る

db.setProfilingLevel