Docs Menu
Docs Home
/
MongoDB Atlas
/
クラスターの作成と接続
/
接続方法

Compass 経由で接続

項目一覧

  • 前提条件
  • クラスターへの接続
  • トラブルシューティング

クラスターの Connect ダイアログ ボックスには、　Compass を使用してクラスターに接続するための詳細が表示されます。

前提条件

TLS

Atlas クラスターに接続するには、MongoDB Compass 1.5 以降を使用します。これらのバージョンは、必要な SNI TLS 拡張機能をサポートしています。

MongoDB Compass

この手順を完了するには、以下のいずれかの操作を行います。

  • MongoDB Compass をインストールします。「Compass のインストール」を参照してください。

  • Atlas Connect ダイアログ ボックスのリンクから MongoDB Compass をダウンロードして、MongoDB Compass の最新バージョンにアップグレードします。これらのリンクにアクセスするには、接続しようとするクラスターの [Connect] をクリックし、次に [Compass] をクリックします。

IP アクセス リスト

クラスターにアクセスするには、Atlas プロジェクトの IP アクセス リストにある IP アドレスから接続する必要があります。IP アクセス リストに IP アドレスを追加する必要がある場合は、Connect ダイアログ ボックスで追加できます。 の [ネットワーク アクセス] タブから IP アドレスを追加することもできます。

データベースユーザー

クラスターにアクセスするには、Atlas クラスター上の目的のデータベースへのアクセス権を持つ データベース ユーザー を作成する必要があります。データベース ユーザーは Atlas ユーザーとは別です。データベース ユーザーは MongoDB データベースにアクセスでき、Atlas ユーザーは Atlas アプリケーション自体にアクセスできます。

Connect ダイアログ ボックスで、Atlas クラスターにアクセスするためのデータベースユーザーを作成できます。クラスター ビューからデータベースユーザーを追加することもできます。

クラスターへの接続

次の手順に従って MongoDB Compass 1 . 8 以降のバージョンを Atlas クラスターに接続します。

1

AtlasGoClustersAtlas で、プロジェクトの ページにGoします。

  1. まだ表示されていない場合は、希望するプロジェクトを含む組織を選択しますナビゲーション バーのOrganizationsメニュー

  2. まだ表示されていない場合は、ナビゲーション バーのProjectsメニューから目的のプロジェクトを選択します。

  3. まだ表示されていない場合は、サイドバーの [Clusters] をクリックします。

    [ Clusters （クラスター） ] ページが表示されます。

2

クリック Connect

接続するクラスターの Connect をクリックします。

3

接続セキュリティを選択します。

Choose Connection Type （使用可能なボタンのセットから選択）。

注意

機能が有効な場合のオプション表示

Atlas は、ピアリングのプライベート IP、プライベートエンドポイント、またはその両方を有効にすると、接続タイプのオプションを表示します。どちらの機能も有効にしていない場合、ボタンは表示されず、接続タイプのデフォルトは標準になります。

許可されたパブリック IP アドレスにはこの接続タイプを使用します。

ピアリングを有効にした場合は、次の接続タイプを使用します。

  • Google Cloud または Azure の場合、ピアリングされたネットワークから Compass に接続している場合、または

  • AWS の場合、カスタム DNS サービスを使用するピア ネットワークから Compass に接続しています。

これらのいずれも当てはまらない場合は、IP アドレスを IP アクセス リストに追加し、標準接続文字列を使用します。オフィスまたは自宅のネットワークから Atlas に直接接続する場合は、このオプションが望ましいでしょう。

注意

ピアリングが利用可能である必要があります

ピアの 1 つが AVAILABLE としてマークされていない限り、このオプションを選択することはできません。ピアのステータスを確認するには:

Atlas で、プロジェクトの [Network Access] ページに移動します。

  1. まだ表示されていない場合は、プロジェクトを含む組織をナビゲーション バーの Organizations メニューで選択します。

  2. まだ表示されていない場合は、ナビゲーション バーの Projects メニューからプロジェクトを選択します。

  3. サイドバーで、 Security見出しの下のNetwork Accessをクリックします。

    [ネットワーク アクセス]ページが表示されます。

注意

マルチクラウドクラスター

アプリケーションがクラスターのプライマリと同じクラウドサービスプロバイダーでホストされていない場合、アプリケーションはセカンダリ読み取りのみを実行できます。

マルチクラウド クラスターの場合は、readPreference 接続オプションを接続文字列 に追加することを検討してください。次のいずれかの値を使用します。

プライベートエンドポイント接続を介して Compass と接続している場合、Compass は次の理由で、適切なインターフェイスエンドポイントの接続文字列を使用します。

  • クラウドプロバイダー ネットワーク内で実行されます、または

  • クラウドプロバイダー ネットワークへの推移的なネットワーク アクセスを持ちます。

  • 最適化された接続文字列 を使用したいと考えています。

これらのいずれにも当てはまらない場合は、IP アドレスを IP アクセス リストに追加し、標準接続文字列を使用します。オフィスや自宅のネットワークから Atlas に直接接続する場合は、このオプションが望ましいでしょう。

注意

構成された PrivateLink 接続が使用可能状態になっていない限り、このオプションを選択することはできません。AWS PrivateLink のステータスを確認するには以下のようにします。

Atlas で、プロジェクトの [Network Access] ページに移動します。

  1. まだ表示されていない場合は、プロジェクトを含む組織をナビゲーション バーの Organizations メニューで選択します。

  2. まだ表示されていない場合は、ナビゲーション バーの Projects メニューからプロジェクトを選択します。

  3. サイドバーで、 Security見出しの下のNetwork Accessをクリックします。

    [ネットワーク アクセス]ページが表示されます。

4

クラスターへの接続を制限する方法を選択します。

Add a Connection IP Address

重要

Atlas が Setup connection security ステップで、クラスターに IP アクセス リスト エントリがすでに設定されていることを示している場合は、このステップをスキップします。IP アクセス リストを管理するには、「アクセス リストへのエントリの追加」を参照してください。

Atlas はプロジェクトの IP アクセス リストのエントリからクラスターへの標準クライアント接続を許可します。プロジェクトの IP アクセス リストは、API アクセス リストとは異なります。APIアクセスリストは、特定の IP アドレスまたは CIDR アドレスへの API アクセスを制限します。

IP アクセス リストが空の場合、Atlas はプロジェクトの IP アクセス リストに IP アドレスを追加するように求めます。次のいずれかを実行できます。

  • 現在の IP アドレスからのアクセスを許可するには、 [Add Your Current IP Address] をクリックします。

  • 単一の IP アドレスまたはCIDR表記のアドレス範囲を追加するには、[Add an IP Address] をクリックします。

新しく追加された 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 アクセス リストに追加します。

  1. Choose Connection Type で Private Endpoint を選択します。

  2. Private Link Typeオプションが表示された場合は、次のいずれかのオプションを選択します。

    • Optimized SRV Connection 負荷分散された接続用。

    • Legacy SRV Connection 負荷分散されていない接続の場合。

    詳細については、「プライベートエンドポイントの背後にあるシャーディングされたクラスターの接続パフォーマンスの向上」を参照してください。

  3. [ Choose Private Endpoint] で、使用するエンドポイントを選択します。

5

データベースユーザーを作成します。

重要

Atlas がSetup connection security の手順でプロジェクトに少なくとも 1 人のデータベースユーザーが設定されていることを示している場合は、この手順をスキップします。既存のデータベースユーザーを管理するには、「データベースユーザーの構成」を参照してください。

クラスターにアクセスするには、プロジェクト内の目的のデータベースまたはクラスター上のデータベースにアクセスできる MongoDB ユーザーが必要です。プロジェクトに MongoDB ユーザーがいない場合、Atlas は Atlas 管理者ロールを持つ新しいユーザーを作成するように要求します。

  1. 新しいユーザーの Username を入力します。

  2. この新しいユーザーの Password を入力するか、Autogenerate Secure Password をクリックします。

  3. Create Database User をクリックしてユーザーを保存します。

次のステップでは、このユーザーを使用してクラスターに接続します。

IP アクセス リストに IP アドレスを追加し、データベースユーザーを追加したら、Choose Your Connection Method をクリックします。

6

Atlas から MongoDB Compass の接続文字列を取得します。

  1. [I have MongoDB Compass] をクリックします。

  2. ドロップダウンで MongoDB Compass のバージョンを選択します。システムにインストールされている MongoDB Compass のバージョンを確認するには、アプリケーションで About MongoDB Compass をクリックします。

  3. Atlas Connectダイアログ ボックスに表示される接続文字列をコピーします。

7

MongoDB Compass を開き、Atlas に接続します。

配置で単一のクラウドプロバイダーを使用している場合、または SSL、認証証明書、または SSH トンネルのいずれも使用していない場合は、コピーした接続文字列を使用して MongoDB Compass に接続します。

  1. New Connection をクリックし、接続文字列を Paste your connection string フィールドに貼り付けます。

  2. （任意）後で使用するために接続を保存するには、 Create Favorite をクリックして、接続の名前を追加します。保存したお気に入りの接続は、MongoDB Compass Connect ウィンドウの左のペインの Favorites の下にあります。

  3. [Connect] をクリックします。

配置が複数のクラウドプロバイダーにまたがっている場合、または SSL、認証証明書、SSH トンネルのいずれかを使用している場合は、接続フィールドを個別に入力します。

  1. [Fill in Connection Fields Individually] をクリックします。

  2. hostname タブで、ホスト名とポートを入力し、ドロップダウンから認証メカニズムを選択します。

  3. More optionsタブで以下を設定します。

    詳細については、MongoDB Compass ドキュメントの「MongoDB への接続」を参照してください。

  4. （任意）後で使用するために接続を保存するには、 Create Favorite をクリックして、接続の名前を追加します。保存したお気に入りの接続は、MongoDB Compass Connect ウィンドウの左のペインの Favorites の下にあります。

  5. [Connect] をクリックします。

MongoDB Compass 1 . 7 またはそれ以前のバージョンの場合、Compass で新しい接続を手動で作成できます。

MongoDB Compass から Atlas クラスターにNew Connectionを設定するには、MongoDB Compass に次の情報を入力し、[Connect] をクリックします。

フィールド名
説明

Hostname

レプリカセットのプライマリのホスト名、またはシャーディングされたクラスターの mongos のホスト名。

Atlas UI でレプリカセット プライマリのホスト名を見つけるには、次のようにします。

  1. Atlas で、プロジェクトの [Clusters] ページに移動します。

    1. まだ表示されていない場合は、希望するプロジェクトを含む組織を選択しますナビゲーション バーのOrganizationsメニュー

    2. まだ表示されていない場合は、ナビゲーション バーのProjectsメニューから目的のプロジェクトを選択します。

    3. まだ表示されていない場合は、サイドバーの [Clusters] をクリックします。

      [ Clusters （クラスター） ] ページが表示されます。

  2. 接続するクラスターをクリックします。

  3. PRIMARY としてマークされているレプリカセット ノードをクリックします。

  4. レプリカセットのホスト名をコピーします。

Atlas user インターフェイスでシャーディングされたクラスターのホスト名を見つけるには、次の手順を実行します。

  1. クラスタの [Connect] をクリックします。

  2. [Drivers] をクリックします。

  3. URI 接続文字列 から mongos ホスト名を抽出します。

プライマリまたは mongos のポート番号をメモします。そのポートを使用して、MongoDB Compass の Port フィールドに入力します。

Port

レプリカセットの場合はプライマリのポート、シャーディングされたクラスターの場合は mongos のポート。

Authentication

Username / Password を選択します。

Username

MongoDB ユーザーAtlas 接続文字列には、クラスタに設定された MongoDB 管理ユーザが表示されます。別の MongoDB ユーザーと接続できます。

Password

指定された MongoDB ユーザーに関連付けられたパスワード

Authentication Database

"admin" を指定します。

Replica Set Name

Atlas クラスターのレプリカセットの名前。

レプリカセット名を検索するには、次のようにします。

  1. クラスターの [ Connect ] ボタンをクリックします。

  2. Connect Your Application を選択します。

  3. URI 接続文字列の replicaSet 値からレプリカセット名を抽出します。

Read Preference

MongoDB Compass が読み取り操作をどのように指示するかを指定します。オプションは Primary、Primary Preferred、 Secondary、Secondary Preferred、Nearest です。/core/read-preference を参照してください。

SSL

選択する "Use System CA / Atlas Deployment"

SSH Tunnel

選択する "Off"

Favorite Name

接続をお気に入りとして保存するには、接続の名前を入力します。

トラブルシューティング

クラスターへの接続に問題がある場合は、「接続の問題のトラブルシューティング」を参照してください。

戻る

ドライバー

次へ

mongosh