ping (接続確認)
最終更新:2026-10-09
ping (接続確認)
ping は MongoDB サーバーが到達可能で応答するかを確認し、成功時は { ok: 1 } を返します。最もシンプルなヘルスチェックコマンドで、スクリプト起動時の接続確認や監視プローブに使われます。db.adminCommand({ ping: 1 }) と同じです。
| カテゴリ | 監視と診断 |
|---|---|
| MongoDB バージョン | 1.0+ |
| 例の言語 | mongosh(シェル) |
📝 構文
db.adminCommand({ ping: 1 })
▶ 例
以下のコマンドをローカルの mongosh で実行してください(mongod が起動済みである必要があります):
// ping: 接続のセルフチェック
const res = db.adminCommand({ ping: 1 })
if (res.ok === 1) {
print("MongoDB connection OK")
} else {
print("Connection failed: " + res.errmsg)
}
出力:
MongoDB connection OK
📌 注意事項
- { ok: 1 } が返れば接続は健全
- レプリカセット・シャーディングクラスタでも動作(到達可能な任意のメンバーに)
- ping はデータ I/O を行わず、コストはほぼ無視できる
🏷️ 関連タグ
💡 関連ケース
📚 関連チュートリアル
❓ よくある質問
Qping でレイテンシを測定できますか?
A直接はできません。db.runCommand({ ping: 1 }) を自分で計測するか、ドライバのサーバー監視 API を使います。
Qping は何を返しますか?
A成功時は { ok: 1 } を返します。到達不能なサーバーはネットワークエラーを発生させるか ok: 0 を返します。
Qping と hello の違いは?
Aping は到達可能性のみを確認します。hello はサーバーの役割・バージョン・トポロジーを報告します。