このページでは、 Atlas CLI または Atlas UIを使用して Atlas クラスターに接続する方法について説明します。
前提条件
IP アクセス リスト
クラスターにアクセスするには、Atlas プロジェクトのIP アクセス リストにあるIPアドレスから接続する必要があります。 IPConnect アクセス リストにIPアドレスを追加する必要がある場合は、 ダイアログ ボックスで追加できます。 ネットワーク アクセスタブから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 は、トポロジーの変更中にホスト名がノード型に関して一貫性を保つことを保証しません。
クラウド クラスターに接続する
配置の接続文字列を取得するには、Atlas CLI または Atlas UI を使用できます。
他の方法を使用してクラウドクラスターに接続する
クラスターに接続するには、配置の 接続文字列 を取得する必要があります。接続文字列を取得したら、次の接続方法を使用して配置に接続できます。
注意
mongodumpまたはmongorestore を使用して接続するには、 サイドバーの [ コマンドラインCluster ツール ] オプションを使用します。これにより、ご希望のツールで Atlas クラスターに接続するための自動生成テンプレートが作成されます。
トラブルシューティング
クラスターへの接続に問題がある場合は、「接続の問題のトラブルシューティング」を参照してください。