このページでは、 Atlas CLI または Atlas UIを使用して Atlas クラスターに接続する方法について説明します。
前提条件
IP アクセス リスト
クラスターにアクセスするには、Atlas プロジェクトの IP アクセス リストにある IP アドレスから接続する必要があります。IP アクセス リストに IP アドレスを追加する必要がある場合は、Connect ダイアログ ボックスで追加できます。[ネットワーク アクセス] タブから IP アドレスを追加することもできます。
データベースユーザー
クラスターにアクセスするには、Atlas クラスター上の目的のデータベースへのアクセス権を持つ データベース ユーザー を作成する必要があります。データベース ユーザーは Atlas ユーザーとは別です。データベース ユーザーは MongoDB データベースにアクセスでき、Atlas ユーザーは Atlas アプリケーション自体にアクセスできます。
Connect ダイアログ ボックスで、Atlas クラスターにアクセスするためのデータベースユーザーを作成できます。クラスター ビューからデータベースユーザーを追加することもできます。
Atlas データベースにアクセスするにはポート 27015 から 27017 を開きます
アプリケーションが MongoDB Atlas 環境にアクセスできることを確認してください。アプリケーション環境から Atlas への受信ネットワーク アクセスを追加するには、次のいずれかを実行します。
パブリック IP アドレスを IP アクセス リストに追加する
VPC / VNet ピアリングを使用して、プライベート IP アドレスを追加します。
プライベートエンドポイントを追加します。
Tip
ファイアウォールが送信ネットワーク接続をブロックする場合は、アプリケーション環境から Atlas への送信アクセスも開く必要があります。アプリケーションがクラスターのホスト名またはIPアドレス上のTCPトラフィックにポート 27015 ~ 27017 への送信接続を行えるようにファイアウォールを構成する必要があります。これにより、アプリケーションは Atlas に保存されているデータベースにアクセスできるようになります。
クラスターIPアドレスの現在のリストを取得するには、 Atlas 管理APIの 1 つのプロジェクトのすべてのIPアドレスを返すエンドポイントとなる接続されたデバイス を使用します。
curl --header "Authorization: Bearer <access-token>" \ --header "Accept: application/vnd.atlas.2025-03-12+json" \ --request GET \ "https://cloud.mongodb.com/api/atlas/v2/groups/{GROUP-ID}/ipAddresses"
注意
デフォルトでは、MongoDB Atlas クラスターはアプリケーション環境への接続を開始できる必要はありません。LDAP 認証と承認 を使用して Atlas クラスターを有効にする場合は、Atlas クラスターから安全な LDAP へのネットワーク アクセスを直接許可する必要があります。パブリック DNS ホスト名が Atlas クラスターがアクセスできる IP を指している限り、パブリック IP またはプライベート IP を使用して LDAP へのアクセスを許可できます。
VPC / VNet ピアリングを使用しておらず、パブリック IP アドレスを使用して Atlas に接続する予定の場合は、追加情報については次のページを参照してください。
Considerations
Atlas は、トポロジーの変更中にホスト名がノード型に関して一貫性を保つことを保証しません。
例
分析ノード foo123-shard-00-03-a1b2c.mongodb.net:27017 を含む foo123 という名前のクラスターがある場合、Atlas では、ノード数やリージョン数を変更するために クラスターをスケーリングするなどのトポロジの変更後も、特定のホスト名が引き続き分析ノードを参照することが保証されません。
クラウド クラスターに接続する
配置の接続文字列を取得するには、Atlas CLI または Atlas UI を使用できます。
他の方法を使用してクラウドクラスターに接続する
クラスターに接続するには、配置の 接続文字列 を取得する必要があります。接続文字列を取得したら、次の接続方法を使用して配置に接続できます。
注意
mongodump または mongorestore を使用して接続するには、Cluster サイドバーの [ コマンドライン ツール ] オプションを使用します。これにより、ご希望のツールで Atlas クラスターに接続するための自動生成テンプレートが作成されます。
トラブルシューティング
クラスターへの接続に問題がある場合は、「接続の問題のトラブルシューティング」を参照してください。