クラスターの Connect ダイアログ ボックスには、 Compass を使用してクラスターに接続するための詳細が表示されます。
Atlas クラスターに接続するには、MongoDB Compass 1.5 以降を使用します。これらのバージョンは、必要な SNI TLS 拡張機能をサポートしています。
この手順を完了するには、以下のいずれかの操作を行います。
MongoDB Compass をインストールします。「Compass のインストール 」を参照してください。
Atlas Connect ダイアログ ボックスのリンクから MongoDB Compass をダウンロードして、MongoDB Compass の最新バージョンにアップグレードします。これらのリンクにアクセスするには、接続しようとするクラスターの [Connect ] をクリックし、次に [Compass ] をクリックします。
クラスターにアクセスするには、Atlas プロジェクトの IP アクセス リストにある IP アドレスから接続する必要があります。IP アクセス リストに IP アドレスを追加する必要がある場合は、Connect ダイアログ ボックスで追加できます。 の [ネットワーク アクセス] タブ から IP アドレスを追加することもできます。
クラスターにアクセスするには、Atlas クラスター上の目的のデータベースへのアクセス権を持つ データベース ユーザー を作成する必要があります。データベース ユーザーは Atlas ユーザーとは別です。データベース ユーザーは MongoDB データベースにアクセスでき、Atlas ユーザーは Atlas アプリケーション自体にアクセスできます。
Connect ダイアログ ボックスで、Atlas クラスターにアクセスするためのデータベースユーザーを作成できます。クラスター ビュー からデータベースユーザーを追加することもできます。
Compass 1.8 以降
Compass 1.7 またはそれ以前
次の手順に従って MongoDB Compass 1 . 8 以降のバージョンを Atlas クラスターに接続します。
警告: ナビゲーションの改善中 現在、新しく改良されたナビゲーション エクスペリエンスを導入中です。次の手順が Atlas UI の表示と一致しない場合は、「プレビュー ドキュメント 」を参照してください。
まだ表示されていない場合は、希望するプロジェクトを含む組織を選択します ナビゲーション バーのOrganizations メニュー
まだ表示されていない場合は、ナビゲーション バーのProjects メニューから目的のプロジェクトを選択します。
まだ表示されていない場合は、サイドバーの [Clusters ] をクリックします。
[ Clusters (クラスター) ] ページが表示されます。
接続するクラスターの Connect をクリックします。
Atlas は、ピアリングのプライベート IP 、プライベートエンドポイント 、またはその両方を有効にすると、接続タイプのオプションを表示します。どちらの機能も有効にしていない場合、ボタンは表示されず、接続タイプ のデフォルトは標準 になります。
[Choose Connection Type ] で、次のいずれかの接続タイプを選択します。
標準接続
ピアリング用のプライベート IP
プライベートエンドポイント接続
許可されたパブリック IP アドレスにはこの接続タイプを使用します。 オフィスまたは自宅のネットワークから Atlas に直接接続する場合は、このオプションが望ましいでしょう。
ピアリングを有効にした場合は、次の接続タイプを使用します。
注意 マルチクラウドクラスター アプリケーションがクラスターのプライマリ と同じクラウドサービスプロバイダーでホストされていない場合、アプリケーションはセカンダリ読み取りのみを実行できます。
マルチクラウド クラスターの場合は、readPreference 接続オプションを接続文字列 に追加することを検討してください。次のいずれかの値を使用します。
プライベートエンドポイント接続を介して Compass と接続している場合は、次の理由で、適切なインターフェイスエンドポイントの接続文字列を使用します。
MongoDB Compass はクラウドプロバイダーネットワーク内で実行されます
MongoDB Compass はクラウドプロバイダーネットワークへの推移的なネットワーク アクセスを持ちます
最適化された接続文字列 を使用したいと考えています。
警告: 構成された PrivateLink 接続が使用可能状態になっていない限り、このオプションを選択することはできません。AWS PrivateLink のステータスを確認する方法については、プライベートエンドポイント接続の問題のトラブルシューティング をご覧ください。
標準接続
ピアリング用のプライベート IP
プライベートエンドポイント接続
Add a Connection IP Address
重要: Atlas が Setup connection security ステップで、クラスターに IP アクセス リスト エントリーがすでに設定されていることを示している場合は、このステップをスキップします。IP アクセス リストを管理するには、「IP アクセス リスト エントリの構成 」を参照してください。
Atlas はプロジェクトの IP アクセス リスト のエントリからクラスターへの標準クライアント接続を許可します。プロジェクトの IP アクセス リストは、API アクセス リスト とは異なります。APIアクセスリストは、特定の IP アドレスまたは CIDR アドレスへの API アクセスを制限します。
IP アクセス リストが空の場合、Atlas はプロジェクトの IP アクセス リストに IP アドレスを追加するように求めます。次のいずれかを実行できます。
新しく追加された IP アドレスまたは CIDR 範囲の説明を任意で入力します。[Add IP Address ] をクリックして、アドレスを IP アクセス リストに追加します。
Add a Connection IP Address
重要: Atlas が Setup connection security ステップで、クラスターに IP アクセス リスト エントリーがすでに設定されていることを示している場合は、このステップをスキップします。IP アクセス リストを管理するには、「IP アクセス リスト エントリの構成 」を参照してください。
Atlas はプロジェクトの IP アクセス リスト のエントリからクラスターへの標準クライアント接続を許可します。プロジェクトの IP アクセス リストは、API アクセス リスト とは異なります。APIアクセスリストは、特定の IP アドレスまたは CIDR アドレスへの API アクセスを制限します。
IP アクセス リストが空の場合、Atlas はプロジェクトの IP アクセス リストに IP アドレスを追加するように求めます。単一の IP アドレスまたは CIDR 表記のアドレス範囲を追加するには、[Add a Different IP Address ] をクリックします。
新しく追加された IP アドレスまたは CIDR 範囲の説明を任意で入力します。[Add IP Address ] をクリックして、アドレスを IP アクセス リストに追加します。
重要: Atlas がSetup connection security の手順でプロジェクトに少なくとも 1 人のデータベースユーザーが設定されていることを示している場合は、この手順をスキップ します。既存のデータベースユーザーを管理するには、「データベースユーザーの構成 」を参照してください。
クラスターにアクセスするには、プロジェクト内の目的のデータベースまたはクラスター上のデータベースにアクセスできる MongoDB ユーザーが必要です。プロジェクトに MongoDB ユーザーがいない場合、Atlas は Atlas 管理者 ロールを持つ新しいユーザーを作成するように要求します。
新しいユーザーの Username を入力します。
この新しいユーザーの Password を入力するか、Autogenerate Secure Password をクリックします。
Create Database User をクリックしてユーザーを保存します。
次のステップでは、このユーザーを使用してクラスターに接続します。
IP アクセス リストに IP アドレスを追加し、データベースユーザーを追加したら、Choose Your Connection Method をクリックします。
[I have MongoDB Compass ] をクリックします。
ドロップダウンで MongoDB Compass のバージョンを選択します。システムにインストールされている MongoDB Compass のバージョンを確認するには、アプリケーションで About MongoDB Compass をクリックします。
Atlas Connect ダイアログ ボックスに表示される接続文字列をコピーします。
配置で単一のクラウドプロバイダーを使用している場合、または SSL、認証証明書、または SSH トンネルのいずれも使用していない場合は、コピーした接続文字列を使用して MongoDB Compass に接続します。
New Connection をクリックし、接続文字列を Paste your connection string フィールドに貼り付けます。
(任意 )後で使用するために接続を保存するには、 Create Favorite をクリックして、接続の名前を追加します。保存したお気に入りの接続は、MongoDB Compass Connect ウィンドウの左のペインの Favorites の下にあります。
[Connect ] をクリックします。
配置が複数のクラウドプロバイダーにまたがっている場合、または SSL、認証証明書、SSH トンネルのいずれかを使用している場合は、接続フィールドを個別に入力します。
[Fill in Connection Fields Individually ] をクリックします。
hostname タブで、ホスト名とポートを入力し、ドロップダウンから認証メカニズムを選択します。
More options タブで以下を設定します。
詳細については、MongoDB Compass ドキュメントの「MongoDB への接続 」を参照してください。
(任意 )後で使用するために接続を保存するには、 Create Favorite をクリックして、接続の名前を追加します。保存したお気に入りの接続は、MongoDB Compass Connect ウィンドウの左のペインの Favorites の下にあります。
[Connect ] をクリックします。
MongoDB Compass 1 . 7 またはそれ以前のバージョンの場合、Compass で新しい接続を手動で作成できます。
MongoDB Compass から Atlas クラスターにNew Connection を設定するには、MongoDB Compass に次の情報を入力し、[Connect ] をクリックします。
レプリカセットのプライマリのホスト名、またはシャーディングされたクラスターの mongos のホスト名。
Atlas UI でレプリカセット プライマリのホスト名を見つけるには、次のようにします。
Atlas で、プロジェクトの [Clusters ] ページに移動します。
警告: ナビゲーションの改善が進行中
現在、新しく改良されたナビゲーション エクスペリエンスを導入中です。次の手順が Atlas UI の表示と一致しない場合は、プレビュー ドキュメント を参照してください。
まだ表示されていない場合は、希望するプロジェクトを含む組織を選択します ナビゲーション バーのOrganizations メニュー
まだ表示されていない場合は、ナビゲーション バーのProjects メニューから目的のプロジェクトを選択します。
まだ表示されていない場合は、サイドバーの [Clusters ] をクリックします。
[ Clusters (クラスター) ] ページが表示されます。
接続するクラスターをクリックします。
PRIMARY としてマークされているレプリカセット ノードをクリックします。
レプリカセットのホスト名をコピーします。
Atlas user インターフェイスでシャーディングされたクラスターのホスト名を見つけるには、次の手順を実行します。
クラスタの [Connect ] をクリックします。
[Drivers ] をクリックします。
URI 接続文字列 から mongos ホスト名を抽出します。
プライマリまたは mongos のポート番号をメモします。そのポートを使用して、MongoDB Compass の Port フィールドに入力します。
レプリカセットの場合はプライマリのポート、シャーディングされたクラスターの場合は mongos のポート。
Username / Password を選択します。
MongoDB ユーザーAtlas 接続文字列には、クラスタに設定された MongoDB 管理ユーザが表示されます。別の MongoDB ユーザーと接続できます。
指定された MongoDB ユーザーに関連付けられたパスワード
Atlas クラスターのレプリカセットの名前。
レプリカセット名を検索するには、次のようにします。
クラスターの [ Connect ] ボタンをクリックします。
Connect Your Application を選択します。
URI 接続文字列の replicaSet 値からレプリカセット名を抽出します。
MongoDB Compass が読み取り操作をどのように指示するかを指定します。オプションは Primary、Primary Preferred、 Secondary、Secondary Preferred、Nearest です。/core/read-preference を参照してください。
選択する "Use System CA / Atlas Deployment"
接続をお気に入りとして保存するには、接続の名前を入力します。