データベース

MongoDB Compassの使い方:接続・クエリ・集計・explainの手順と業務端末での安全設定

MongoDB Compassの使い方:接続・クエリ・集計・explainの手順と業務端末での安全設定

MongoDB Compassは、MongoDB社が無料で配布している公式のGUIで、2026年11月時点の安定版は1.53.2です。この記事では、インストールから、Dockerで立てた検証用MongoDBへの接続、クエリバーでの絞り込み、集計パイプライン、Explain Planとインデックスの確認までを、同じ注文データで順に進めます。後半では、業務端末に配るときにreadOnly設定だけでは書き込みを止められない理由と、設定ファイルで固定すべき項目を示します。

まとめ:MongoDB Compassで作業を始める前に押さえる前提と使い方の結論

Compass 1.53系が接続できるのはMongoDB 7.0以上です。6.0以前のサーバーが社内に残っているなら、先にサーバーの更新計画を立てるか、mongoshで作業します。

操作の流れは、接続文字列で繋ぐ、Documentsタブのクエリバーで絞り込む、Aggregationsタブで集計を組む、Explainで走査件数を確かめる、Indexesタブでインデックスを作る、の5段階です。画面で組んだクエリは「Export Code」でPythonやJavaのコードに書き出せるため、試行錯誤をGUIで済ませてアプリへ移す使い方に向いています。

業務端末に配るときは、Compassの readOnly 設定に頼らず、DB側で read ロールだけを持つユーザーを発行します。公式ドキュメントも、readOnly は書き込み操作のボタンを隠すだけだという説明です。設定ファイルで readOnly・シェル無効・AI機能無効を固定すると、利用者が画面から設定を戻せなくなります。

MongoDB Compassとは:1.53系の機能と7.0以上という接続条件

Compassの画面でできる作業と、mongoshで書いたほうが早い作業の分担

公式ドキュメントの概要ページは、Compassを「クエリ・集計・分析を視覚的な環境で行うGUI」と説明し、macOS・Windows・Linuxで動く無料のツールと位置づけています。ソースはGitHubのmongodb-js/compassで公開され、誰でも中身を読めるツールです。MongoDB本体の構造はMongoDBとは?ドキュメント指向データベースの仕組み・利点・使い方入門で整理しています。

画面が強いのは、コレクションの中身を眺める作業です。Schemaタブはサンプリングしたドキュメントから各フィールドの型の割合や欠損率を出し、文字列と数値の混在を一目で示します。

反対に、大量の更新や繰り返す処理はmongoshで書いたほうが速く、記録も残ります。Compassには1.22からmongoshが内蔵されており、画面右上の「Open MongoDB shell」で同じ接続のまま切り替えられます。

1.53.2の動作要件:対応OSの版とMongoDB 7.0未満に繋がらない制約

GitHubのリリース一覧では、2026年10月27日公開の1.53.2が最新の安定版です(11月時点で1.53.3のベータが並行して出ています)。インストールページが示す要件は次の通りです。

OS 対応する版(64bit) 非推奨の告知
Windows 10、Server 2019・2022・2025 10とServer 2019は将来削除
macOS 14以降(x64・ARM64) 記載なし
RHEL系 RHEL 8以降、SLES 15以降 RHEL 8は将来削除
Ubuntu系 Ubuntu 20.04・Debian 12以降 20.04とDebian 12は将来削除

どのOSでも、接続先は「MongoDB 7.0以上」と明記されています。古い記事の手順どおりに入れても、6.0や5.0のサーバーには繋がりません。Linuxの仮想デスクトップ環境も対象外です。

Compassのインストール手順:Windows・macOS・Linuxの入れ方

OS別のインストーラ形式と、Linuxでコマンドから入れる手順

Windowsはダウンロードページから .exe・.msi・.zip のいずれかを選びます。PowerShellでのサイレントインストールやAzure Virtual Desktopへの導入は、管理者権限で始めることが必要です。macOSは .dmg を開いてApplicationsフォルダへドラッグし、Apple Silicon向けには別のバイナリが用意されています。

Linuxは公式手順がwgetでパッケージを取得する形です。Ubuntu・Debianでは次のように入れて、版を確かめてから起動します。

wget https://downloads.mongodb.com/compass/mongodb-compass_1.53.2_amd64.deb
sudo apt install ./mongodb-compass_1.53.2_amd64.deb
mongodb-compass --version
mongodb-compass

RHEL系は同じ場所の mongodb-compass-1.53.2.x86_64.rpm を取得し、sudo yum install で入れます。Nvidia製GPUの端末で画面が崩れる場合は、--disable-gpu を付けて起動します。

検証用MongoDBをDockerで起動して接続文字列でCompassから繋ぐ手順

Dockerで認証付きのMongoDB 9.0をローカル限定で起動するコマンド

本番に繋ぐ前に、手元で壊してよい環境を作ります。Docker Hubの公式イメージmongoには9.0タグがあり、Compassの要件である7.0以上に該当するバージョンです。ポートは 127.0.0.1 にだけ公開し、管理ユーザーを環境変数で作ります。

docker run -d --name mongo-compass \
  -p 127.0.0.1:27017:27017 \
  -e MONGO_INITDB_ROOT_USERNAME=admin \
  -e MONGO_INITDB_ROOT_PASSWORD=change-me \
  mongo:9.0

# 練習用の注文データを入れる
docker exec -it mongo-compass mongosh -u admin -p change-me --authenticationDatabase admin --eval '
db.getSiblingDB("shop").orders.insertMany([
  { orderNo: "A-1001", customer: "c01", status: "paid",    total: 12800, items: ["pen", "note"], createdAt: new Date("2026-11-01") },
  { orderNo: "A-1002", customer: "c02", status: "pending", total: 5400,  items: ["note"],        createdAt: new Date("2026-11-03") },
  { orderNo: "A-1003", customer: "c01", status: "paid",    total: 30200, items: ["bag", "pen"],  createdAt: new Date("2026-11-08") }
])'

-p 27017:27017 と書くと全インターフェースに公開され、社内LANから届く状態になります。MongoDBの公開ポートを狙う攻撃は今も続いており、MongoDBの脆弱性CVE-2025-14847(MongoBleed)も認証前の通信で発生する種類でした。検証環境でもバインド先は絞ります。

接続文字列の書き方と、Save・Connectなど3つのボタンの使い分け

Compassを起動したら、左下の「Add New Connection」を押して接続文字列を貼ります。接続ページの公式手順によれば、接続文字列を編集欄で直すとパスワードが平文で表示される仕様です。そこで、URIにはホストと認証DBだけを書き、ユーザー名とパスワードは「Advanced Connection Options」のAuthenticationタブに入れます。

mongodb://127.0.0.1:27017/?authSource=admin

# Atlasの場合はクラスタ画面の Connect から「Compass」を選んで表示される文字列を使う
mongodb+srv://cluster0.example.mongodb.net/?appName=Cluster0

ボタンは3つあり、「Save」は保存だけ、「Connect」は保存せずに接続、既定の「Save & Connect」は両方を行います。共用PCでは「Connect」を選び、接続情報を端末に残しません。1.44.0以降は複数の接続を同時に開けるため、本番の接続にはラベル色を付けて取り違えを防ぎます。Atlas側の接続許可やIPアクセスリストの設定はMongoDB Atlasとは?クラスタ階層・料金・セキュリティ設定と採用判断で説明しています。

踏み台サーバ経由の接続:SSHトンネルの入力欄とレプリカセットの指定

VPC内のMongoDBへは、Advanced Connection Optionsの「Proxy / SSH Tunnel」タブで踏み台を指定します。SSH接続の公式ページにある入力欄は、SSH Hostname、SSH Port(既定22)、SSH Username、パスワードまたはIdentity File、鍵のPassphraseです。

レプリカセットでは、個々のメンバーのホスト名を直接書かないでください。選出でプライマリが切り替わったときに接続が切れたり、古いデータが表示されたりすると公式が注意しています。SRVレコードか replicaSet=rs0 のようなレプリカセット名を接続文字列に含めてください。接続先のレプリカセットを手元で組む手順はMongoDBレプリカセットの構築手順を解説した記事にまとめています。社内プロキシ経由で繋ぐ場合は、環境変数 MONGODB_PROXY や ALL_PROXY でも指定できます。

クエリバーでドキュメントを絞り込む:FilterとProject・Sortの書き方

Filter欄に書く条件の例:日付の範囲・配列の要素・入れ子のフィールド

コレクションを開くとDocumentsタブの上にクエリバーが出ます。クエリの公式ページのとおり、Filter欄に波括弧で条件を書いて「Find」を押す手順です。$text と $expr 以外のクエリ演算子はすべて使えます。先ほどの注文データなら、次のように書けます。

// 11月2日以降の支払済み注文
{ status: "paid", createdAt: { $gte: new Date("2026-11-02") } }

// itemsにpenを含み、合計が1万円以上
{ items: "pen", total: { $gte: 10000 } }

// 入れ子のフィールドはドット記法で書く
{ "shipping.pref": "東京都" }

日付は new Date() で囲みます。文字列で書くと、Date型のフィールドとは一致しません。

ProjectとSortで返す項目を絞り、Export Codeでアプリのコードに移す

クエリバー右の「Options」を開くと、Project・Sort・Collation・Skip・Limit・Max Time MSの欄が出ます。Projectに { orderNo: 1, total: 1, _id: 0 }、Sortに { total: -1 }、Limitに10と入れれば、高額順の注文番号一覧になります。

形が決まったら「Export Code」を押します。書き出しの公式ページによると、出力先はJava・Node・C#・Python 3・Ruby・Go・Rust・PHPの8言語です。「Include Driver Syntax」を選ぶと、ProjectやSortを含めたドライバの呼び出しまで出力されます。Python 3を選んだ場合は、次のような形のコードになります。

from pymongo import MongoClient

client = MongoClient("mongodb://127.0.0.1:27017/?authSource=admin", username="app", password="change-me")
result = client["shop"]["orders"].find(
    filter={"status": "paid"},
    projection={"orderNo": 1, "total": 1, "_id": 0},
    sort=list({"total": -1}.items()),
    limit=10,
)
for doc in result:
    print(doc)

書き出したコードには接続文字列がそのまま入ります。認証情報は環境変数などから読む形に直してからリポジトリへ入れます。

集計パイプラインをCompassで組む:Stage表示とText表示の使い分け

顧客別の売上合計を$match・$group・$sortの3段で組み立てる例

Aggregationsタブを開くと、コレクションからランダムに選んだ10件がプレビューに並びます。集計パイプラインの公式手順によれば、編集方法はステージを1枚ずつ足すStage View、定型の雛形を選ぶStage Wizard、1ステージだけを拡大して編集するFocus Mode、生の構文を貼るText Viewの4つです。

支払済み注文を顧客ごとに合計して多い順に並べるなら、Text Viewに次を貼ります。

[
  { $match: { status: "paid" } },
  { $group: { _id: "$customer", orders: { $sum: 1 }, amount: { $sum: "$total" } } },
  { $sort: { amount: -1 } }
]

Stage Viewでは、各ステージ名の右のトグルでそのステージだけを外し、件数の変化から条件の効き方を確かめられます。

$outと$mergeの実行前確認と、プレビュー10件だけで判断しない注意

$out と $merge はコレクションへ書き込むステージで、Compassは実行前に確認ダイアログを出します。ステージの並べ替えはカードの見出しをドラッグするだけなので、誤って書き込みステージを途中に移していないかを「Run」の前に見直します。

プレビューは10件のサンプルです。件数の少ない値や欠損フィールドがサンプルに入らないと、本番データで $group の結果が変わります。全件で確かめるときは右上の「Run」を押し、結果をドキュメント表示で確認してください。Atlasに繋いでいるときだけ、全文検索の $search ステージが選べるようになります。

Explain Planで遅いクエリを見つける:COLLSCANからインデックス作成まで

Explainボタンで確かめる4つの数値:返却件数と検査件数とキー数と時間

クエリバーの「Explain」を押すと、実行計画がツリー表示されます。Explain Planの公式ページによれば、Query Performance Summaryに出るのは実行時間、返却したドキュメント数、検査したドキュメント数、検査したインデックスキー数です。

見るべきは返却数と検査数の比です。返却10件に対して検査が10万件なら、全件を走査するCOLLSCANが起きています。「Raw Output」に切り替えると、mongoshの explain() と同じJSONを確認できる表示です。各項目の意味はExplain Resultsのリファレンスで引けます。読み方とESRの並び順はMongoDBのインデックス設計:createIndexの書き方・ESRの並び順・explainの読み方で掘り下げています。

Indexesタブでインデックスを作成し、hiddenで削除の影響を先に試す

COLLSCANを見つけたら、Indexesタブの「Create Index」を押します。インデックス管理の公式ページのとおり、型はAscending・Descending・2dsphere・Textから選び、オプションで指定できるのは、ユニーク、TTL、部分インデックスの条件、ワイルドカード、照合順序です。先ほどのクエリなら、status 昇順と createdAt 降順の複合インデックスを作り、もう一度Explainで検査数が減ったかを確かめます。

不要そうなインデックスは、いきなり消さずに目のアイコンで「Hide Index」にします。クエリプランナーから見えなくなるだけで定義は残るため、遅くなった場合にも元に戻せる仕組みです。削除するときはインデックス名の入力を求められます。

Usage列の落とし穴:接続中ノード分だけの数値と$indexStatsでの確認

Indexesタブの「Usage」は、インデックスが作成または再起動されてから使われた回数です。公式ページは、この数値がCompassの接続しているノードの分だけだと警告しています。読み取りをセカンダリに振っている構成では、プライマリの画面で0回と出ても実際は使われていることがあります。

// 各ノードに接続して実行し、accesses.ops を比べる
db.orders.aggregate([
  { $indexStats: {} },
  { $project: { name: 1, host: 1, "accesses.ops": 1, "accesses.since": 1 } }
])

$indexStatsのリファレンスが示すように、結果にはホスト名が含まれます。全ノードで0回、かつ再起動から十分な期間が経っていることを確かめてからhiddenに移し、問題が出なければ削除します。

業務端末に配る設定:readOnlyだけでは書き込みを止められない理由と対策

DB側でreadロールだけのユーザーを作り、Compass用の接続を分ける

CompassのreadOnly設定の公式ページには、「readOnlyは書き込みを完全には無効にせず、書き込み操作のUI要素を隠す」と書かれています。接続しているユーザーが書き込み権限を持っていれば、別のツールやドライバからは書けます。従来のReadonly Editionも将来のリリースで非推奨になると告知されており、公式の代替手段は「DB単位で read ロールを付与し、readOnlyを有効にする」組み合わせです。

use admin
db.createUser({
  user: "compass_viewer",
  pwd: passwordPrompt(),
  roles: [ { role: "read", db: "shop" } ]
})

Compassの必要権限一覧では、ドキュメント・スキーマ・インデックス・Explainの閲覧は read、ドキュメント編集とインデックス作成は readWrite、検証ルールの更新は dbAdmin、Performance画面は clusterMonitor です。調査担当にはreadだけを渡し、インデックス作成は別のアカウントで行う運用にします。ロールの中身は組み込みロールのリファレンスで確認できます。

設定ファイルで固定する項目:readOnly・シェル無効・AI無効・接続文字列保護

設定ファイルの公式ページによれば、設定ファイルで指定した項目は画面から変更できません。配置場所はmacOSとLinuxが /etc/mongodb-compass.conf、Windowsは実行ファイルの親フォルダの mongodb-compass.cfg です。msi版を既定の場所に入れた場合は C:\Program Files\mongodb-compass.cfg になります。YAML形式なら次のように書けます。

readOnly: true
enableShell: false
enableGenAIFeatures: false
enableGenAISampleDocumentPassing: false
protectConnectionStrings: true
maxTimeMS: 60000
trackUsageStatistics: false

protectConnectionStrings は接続文字列の編集を禁止し、パスワードを伏せ字にします。maxTimeMS は全操作の上限時間で、条件なしの集計を誤って投げたときの負荷を抑えるための設定です。雛形は実行ファイルに --show-example-config を付けると表示されます。

AI機能で外部に送られる情報:スキーマ情報と、既定で無効のサンプル値

Compassには自然言語でクエリを生成する機能とアシスタントがあります。AIとデータ利用の公式ページによると、提供基盤はMicrosoftがホストするAzure OpenAI Serviceです。自然言語クエリでは、入力した文章に加えて、データベース名・コレクション名・フィールド名・型が送られます。フィールドの実際の値は「Enable sending sample field values」を有効にしたときだけ送られ、この設定は既定で無効です。

項目名に病名や取引先名が入る設計では、フィールド名だけでも社外に出せない場合があります。社内規程でクラウドAIへの送信を制限しているなら、設定ファイルで enableGenAIFeatures: false を固定します。

Compassを使う場面と使わない場面:開発と本番運用での判断基準

採用する条件:開発中のデータ確認・集計の試作・インデックスの検討

Compassが最も効くのは、開発者がスキーマのゆれを見つけ、集計を試作し、Explainでインデックスの効果を確かめる場面です。組んだクエリはExport Codeでアプリに移せます。

企画担当にデータを見せる用途でも使えますが、前章のreadロールと設定ファイルの固定を必ず組み合わせます。複数の製品からMongoDBを選ぶ段階なら、NoSQLデータベースの比較:MongoDB・Cassandra・Redis・DynamoDB・Couchbaseを同じ処理で比べるで製品ごとの違いを整理しています。

見送る場面:MongoDB 6.0以前が残る環境と、本番データの日常的な手作業編集

接続先にMongoDB 6.0以前が残っている環境では、Compass 1.53系は使えません。古いCompassを探して入れるより、サーバーの更新を先に進めるべきです。5.0系と6.0系はサポート期限を過ぎた系列で、修正版が出るかどうかは脆弱性ごとに変わります。2026年11月に公表されたMongoDB脆弱性CVE-2026-118383では6.0.30と5.0.35が出ました。一方で2026年9月と10月のCVEは、影響版の一覧に7.0以降の系列しか載っていません。

本番データを画面から日常的に書き換える運用も採用しません。誰が何を変えたかがアプリ側に残らず、誤操作を戻す手段もありません。インポートとエクスポートの公式ページも、Compassはバックアップのための道具ではないと明記しています。定常の修正はスクリプト化してレビューを通すか、管理画面を作る方法を選んでください。MongoDBの権限設計や旧版からの移行計画をまとめて見直したい場合は、一創のデータベース設計・移行支援でご相談を受けています。

MongoDB Compassについてよくある質問:料金・旧版接続・書き出し

Compassの料金、古いサーバーへの接続、データの書き出しなど、導入前によく出る疑問をまとめます。

MongoDB Compassは無料で使えますか?

無料で使えます。公式ドキュメントはCompassを無料のツールと説明しており、リポジトリのライセンス表記はSSPLです。費用は接続先のAtlasやサーバーのほうで発生します。業務端末への配布で確認すべきなのは、料金よりもAI機能のデータ送信と書き込み権限の扱いです。

Compassで古いMongoDBに接続できないのはなぜですか?

Compass 1.53系のインストール要件が、接続先を「MongoDB 7.0以上」と定めているためです。6.0や5.0のサーバーには繋がりません。サーバーを7.0以上へ更新するのが本筋で、それまではmongoshやアプリのドライバで作業します。

MongoDB Compass Readonly Editionはまだ使えますか?

公式ドキュメントは、Readonly Editionが将来のリリースで非推奨になると告知しています。代替は、標準版でreadOnly設定を有効にし、DB側でユーザーに read ロールだけを付与する方法です。

CompassでコレクションをCSVやJSONに書き出せますか?

書き出せます。コレクション全体のほか、Filterや集計パイプラインの結果だけをJSONかCSVで保存することも可能です。CSVは型の情報が失われるため、公式はJSON(既定はExtended JSON)を勧めています。CSVで「=」などで始まる文字列を数式として扱わせない設定は、既定で有効です。

mongoshとCompassはどちらを使うべきですか?

データの形を見る、集計を試作する、Explainを読む作業はCompassが速く、繰り返す処理や大量更新はmongoshのスクリプトが向いています。本番の更新作業は、手順を残せるmongoshかアプリ側のスクリプトで行います。

関連記事

お気に入りに入れた記事の一覧

一創の公式 SNS

X では毎朝の新着記事と IT ニュースの速報を、YouTube・TikTok・Instagram・LinkedIn・Facebook では記事の解説動画を配信しています。

この記事は以下の記事からリンクされています

資料請求

今日のトレンド記事 直近 24 時間で、いつもより多く読まれている記事

  1. 2026.11.13 テックブログ 宝くじ公式サイト不正アクセス:4,436名の対象確認とパスワード再設定、変更された仕組み
  2. 2026.01.30 テックブログ Xで「人間であることを確認」と顔認証が出る理由と対処|ライブネスチェックとOpenAIの生体認証SNS構想
  3. 2026.11.13 テックブログ KARTEの不正アクセス:全機能停止で利用企業がタグ・配信・データ連携を確かめる手順
  4. 2026.11.09 テックブログ あきゅらいず不正アクセス:最大約90万件の対象確認とパスワード変更、退会者データの消し方
  5. 2026.11.13 テックブログ Gemini 4 Hydrogenとは?3.8 Flashからの移行・料金・xhighの使い方を実装目線で解説【2026年11月】

RELATED POSTS 関連記事

目次