Docs Menu
Docs Home
/
Atlas
/

クラスターへの接続

推定所要時間: 5 分

クラスターにはさまざまな方法で接続できます。このチュートリアルでは、次のいずれかの方法を使用します。

➤ [言語の選択]ドロップダウン メニューを使用して、mongoshCompass など、このチュートリアルの接続方法を設定します。

注意

Atlas の使用を開始するためにデフォルトのオプションでatlas setupまたはatlas quickstartコマンドを使用している場合、Atlas CLI はクラスターに接続するためのmongoshコマンドを提供します。

クラスターに接続するには、データベースユーザーである必要があります。

始める前に、以下のものを保持していることを確認します。

mongoshをダウンロードしてインストールするには以下を行います。

1

警告: ナビゲーションの改善が進行中次の手順が Atlas UIのビューと一致しない場合は、プレビュー ドキュメントを参照してください。

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

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

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

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

2

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

3
4

ドロップダウンからオペレーティングシステムを選択します。

5
  • WindowsまたはLinuxを使用している場合は、次のいずれかのオプションを使用してダウンロードします。

    • [ Download mongosh ] をクリックしてダウンロードを開始します。

    • [Copy download URL] をクリックしてダウンロード URL をクリップボードにコピーし、次のいずれかを実行します。

      • インストーラー ファイルを取得するには curl を使います。

      • ブラウザ ウィンドウに URL を貼り付けます。

    • MongoDB Shell ページからインストーラーをダウンロードします。

  • macOSを使用している場合は、提供されている Homebrew コマンドを使用して shell をダウンロードできます。

6

オペレーティングシステムに基づいて適切なタブを選択します。

  1. 次のいずれかのオプションを使用してダウンロードします。

    • [ Download mongosh ] をクリックしてダウンロードを開始します。

    • [Copy download URL] をクリックしてダウンロード URL をクリップボードにコピーし、次のいずれかを実行します。

      • curl を使用して URL からインストーラファイルを取得するか、

      • ブラウザ ウィンドウに URL を貼り付けます。

    • MongoDB Shell ページからインストーラーをダウンロードします。

  2. ダウンロードしたアーカイブからファイルを抽出します。

  3. mongoshバイナリをPATH環境変数に追加します。

    抽出された MongoDB Shell バイナリがファイルシステム内の目的の場所にあることを確認し、その場所をPATH環境変数に追加します。

    1. Control Panelを開きます。

    2. System and Security カテゴリで、[System] をクリックします。

    3. [ Advanced system settingsをクリックします。 [ System Propertiesモーダルが表示されます。

    4. [Environment Variables] をクリックします。

    5. [Path ] を選択し、[Edit] をクリックします。

    6. Newをクリックして、 mongoshバイナリにファイルパスを追加します。

  1. 提供されている Homebrew コマンドを使用します。

  2. Atlas UI ウィンドウから Homebrew コマンドをコピーし、ターミナルで実行します。

  1. 次のいずれかのオプションを使用してインストーラーをダウンロードします。

    • [ Download mongosh ] をクリックしてダウンロードを開始します。

    • [Copy download URL] をクリックしてダウンロード URL をクリップボードにコピーし、次のいずれかを実行します。

      • curl を使用して URL からインストーラファイルを取得するか、

      • ブラウザ ウィンドウに URL を貼り付けます。

    • MongoDB Shell ページからインストーラーをダウンロードします。

    注意

    ダウンロードするファイルの種類は、選択したオペレーティング システムによって異なります。次のバージョンを選択した場合:

    • Ubuntu または Debian では、 .debパッケージを受け取ります。

    • RHEL、Amazon Linux、または SUSE の場合、.rpm パッケージを受け取ります。

    ご使用のオペレーティング システムがリストにない場合は、mongosh ドキュメントの「.tgz インストール手順」を参照してください。

  2. mongosh パッケージをインストールします。

    dpkg を使用して mongosh をインストールします。

    sudo dpkg -i mongodb-mongosh_<mongosh-version-and-platform>.deb

    rpm を使用して mongosh をインストールします。

    sudo rpm -i mongodb-mongosh_<mongosh-version-and-platform>.rpm

これで、ターミナルを使用してmongoshを実行できるはずです。

7

システム パスにmongoshが正しく追加されたかどうかを確認するには、ターミナルで次のコマンドを実行します。

mongosh --version

次のような出力が表示されます。

0.14.0

MongoDB Compass をダウンロードしてインストールするには、以下を行います。

1

警告: ナビゲーションの改善が進行中次の手順が Atlas UIのビューと一致しない場合は、プレビュー ドキュメントを参照してください。

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

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

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

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

2

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

3

接続モーダルから、 Compassをクリックします。

4

[I do not have MongoDB Compass] をクリックします。ドロップダウンからオペレーティングシステムを選択します。

5
6
  • ターミナル。

  • テキストエディタ。

  • .NET

  • C# プロジェクト。プロジェクトを初期化するには、プロジェクト ディレクトリでdotnet new consoleコマンドを実行します。詳細については、 「C# クイック スタート」を参照してください。

  • ターミナル。

  • テキストエディタ。

  • Go

  • Go プロジェクト。プロジェクトを初期化するには、 go modコマンドを使用します。詳細については、 「Go クイック スタート」を参照してください。

プロジェクトをビルドして実行するように Maven または Gradle を構成するには、 「依存関係として MongoDB を追加する」を参照してください。

Node.js ドライバーをインストールするには、ターミナルプロンプトで次のコマンドを実行します。

npm install mongodb --save
  • ターミナル。

  • テキストエディタ。

  • Python.ご使用のオペレーティング システム用の最新バージョンのPythonをダウンロードするには、Pythonダウンロード ページ を参照してください。

  • ピップパッケージインストーラー。Python 2.7.9 以降およびPython 3.4、https://python.org からダウンロードしたパッケージには pip が含まれています。pip を手動でインストールするには、pip インストールページ を参照してください。このパッケージにはPython.

PyMongo と呼ばれる Python ドライバーをインストールするには次のようにします。

1
2

ターミナルで次のコマンドを実行します。

python -m pip install "pymongo[snappy,gssapi,srv,tls]"

このコマンドは、PyMongo ドライバーとドライバーのいくつかの依存関係をインストールします。詳細については GitHub の Python ドライバーのインストール ページ を参照してください。

3

PyMongo のインストールをテストして、クラスターに正常に接続できることを確認します。

  1. 以下のコマンドを実行して Python shell を開きます。

    python
  2. Python shell で次のコマンドを実行して PyMongo をインポートします。

    import pymongo
  3. 以下のコマンドを使用して PyMongo のバージョンを確認します。

    pymongo.version

    PyMongo が正しくインストールされている場合は、次のような出力が表示されます。

    '3.11.0'

このセクションでは、Atlas からクラスターの接続文字列を取得し、任意の接続方法を使用してクラスターに接続します。

サポートされているすべての方法については、 クラウドクラスターへの接続 を参照してください。その他のドライバーの例については、 「ドライバー経由でクラスターに接続する」 を参照してください。

1

警告: ナビゲーションの改善が進行中次の手順が Atlas UIのビューと一致しない場合は、プレビュー ドキュメントを参照してください。

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

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

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

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

2

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

3

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

注意

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

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

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

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

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

  • AWS の場合、カスタム DNS サービスを使用するピアリングされたネットワークからドライバーに接続します。

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

注意

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

ピアの 1 つが AVAILABLE としてマークされていない限り、このオプションを選択することはできません。ピアのステータスを確認する方法については、Atlas ネットワークピアリング接続の表示 を参照してください。

注意

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

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

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

プライベートエンドポイント接続を介してドライバーに接続する場合は、ドライバーが以下のいずれかの理由で適切なインターフェイスエンドポイントの接続文字列を使用してください。

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

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

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

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

注意

構成された PrivateLink 接続が使用可能状態になっていない限り、このオプションを選択することはできません。AWS PrivateLink のステータスを確認する方法については、プライベートエンドポイント接続の問題のトラブルシューティング を参照してください。

4

接続モーダルから、 Shellをクリックします。

5
6

これは、Atlas クラスターに固有の一意の文字列です。Atlasは、文字列の username を、この手順の前半で作成したデータベース ユーザーのユーザー名に置き換えます。

7
8

入力を求められたら、データベースユーザーのパスワードを入力します。Atlas でデータベースユーザーを作成したときに指定したパスワードを入力するよう求められます。

これで、 mongosh内の Atlas クラスターに接続されるはずです。ターミナルには、次のようなものが表示されます。

MongoDB Enterprise GettingStarted-shard-0:PRIMARY>

重要

接続のトラブルシューティング

クラスタへの接続に問題がある場合は、 IP アドレスが IP アクセスリストに追加されていること、および正しいデータベースユーザー認証情報を指定していることを再確認してください。データベースユーザーの認証情報を忘れた場合でも、いつでも新しいデータベースユーザーを作成できます。

1

警告: ナビゲーションの改善が進行中次の手順が Atlas UIのビューと一致しない場合は、プレビュー ドキュメントを参照してください。

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

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

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

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

2

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

3

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

注意

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

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

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

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

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

  • AWS の場合、カスタム DNS サービスを使用するピアリングされたネットワークからドライバーに接続します。

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

注意

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

ピアの 1 つが AVAILABLE としてマークされていない限り、このオプションを選択することはできません。ピアのステータスを確認する方法については、Atlas ネットワークピアリング接続の表示 を参照してください。

注意

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

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

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

プライベートエンドポイント接続を介してドライバーに接続する場合は、ドライバーが以下のいずれかの理由で適切なインターフェイスエンドポイントの接続文字列を使用してください。

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

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

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

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

注意

構成された PrivateLink 接続が使用可能状態になっていない限り、このオプションを選択することはできません。AWS PrivateLink のステータスを確認する方法については、プライベートエンドポイント接続の問題のトラブルシューティング を参照してください。

4

接続モーダルから、 Compassをクリックします。

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

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

  3. Atlas Connect ダイアログ ボックスで接続文字列をコピーします。

6

配置で単一のクラウドプロバイダーを使用している場合、または 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] をクリックします。

1

警告: ナビゲーションの改善が進行中次の手順が Atlas UIのビューと一致しない場合は、プレビュー ドキュメントを参照してください。

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

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

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

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

2

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

3

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

注意

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

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

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

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

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

  • AWS の場合、カスタム DNS サービスを使用するピアリングされたネットワークからドライバーに接続します。

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

注意

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

ピアの 1 つが AVAILABLE としてマークされていない限り、このオプションを選択することはできません。ピアのステータスを確認する方法については、Atlas ネットワークピアリング接続の表示 を参照してください。

注意

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

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

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

プライベートエンドポイント接続を介してドライバーに接続する場合は、ドライバーが以下のいずれかの理由で適切なインターフェイスエンドポイントの接続文字列を使用してください。

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

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

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

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

注意

構成された PrivateLink 接続が使用可能状態になっていない限り、このオプションを選択することはできません。AWS PrivateLink のステータスを確認する方法については、プライベートエンドポイント接続の問題のトラブルシューティング を参照してください。

4

接続モーダルから、 Driversをクリックします。

5

ドロップダウンからドライバーのバージョンを選択します。接続文字列が表示されます。

6
7

<password>を、データベースユーザーの作成時に指定したパスワードに置き換えます。

注意

パスワード、データベース、または接続文字列に予約済みの URI 文字が含まれている場合は、それらの文字をエスケープする必要があります。たとえば、パスワードが @bc123 の場合、接続文字列でパスワードを指定するときは、%40bc123 などに指定して、@ の文字をエスケープする必要があります。詳細については、「接続文字列パスワードの特殊文字」を参照してください。

8

次のサンプル アプリケーションは、文字列を使用して Atlas クラスターに接続し、接続が成功したことを確認するために ping を送信します。サンプルアプリケーションをテストするには以下を行います。

  1. connectという新しいディレクトリを作成し、 dotnet newコマンドを使用してプロジェクトを初期化します。

    mkdir connect
    cd connect
    dotnet new console
  2. 次のコマンドを実行して、.NET/C# ドライバーを依存関係としてプロジェクトに追加します。

    dotnet add package MongoDB.Driver
  3. Program.cs ファイルの内容を、次のコードで置き換えます。次のように、プレースホルダーを更新した接続文字列に置き換えてください。

    1using MongoDB.Bson;
    2using MongoDB.Driver;
    3
    4public class Connect
    5{
    6 // Replace the following with your Atlas connection string
    7 private const string MongoConnectionString = "mongodb+srv://<db_username>:<db_password>@<clusterName>.mongodb.net/?retryWrites=true&w=majority";
    8
    9 public static void Main(string[] args)
    10 {
    11 // Connect to your Atlas cluster
    12 var client = new MongoClient(MongoConnectionString);
    13
    14 // Send a ping to confirm a successful connection
    15 try {
    16 var result = client.GetDatabase("admin").RunCommand<BsonDocument>(new BsonDocument("ping", 1));
    17 Console.WriteLine("Successfully connected to Atlas");
    18 }
    19 catch (Exception e) { Console.WriteLine(e);}
    20 }
    21}
  4. アプリケーションを実行するには、次のコマンドを使用します。

    dotnet run Program.cs
    Successfully connected to Atlas
1

警告: ナビゲーションの改善が進行中次の手順が Atlas UIのビューと一致しない場合は、プレビュー ドキュメントを参照してください。

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

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

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

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

2

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

3

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

注意

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

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

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

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

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

  • AWS の場合、カスタム DNS サービスを使用するピアリングされたネットワークからドライバーに接続します。

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

注意

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

ピアの 1 つが AVAILABLE としてマークされていない限り、このオプションを選択することはできません。ピアのステータスを確認する方法については、Atlas ネットワークピアリング接続の表示 を参照してください。

注意

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

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

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

プライベートエンドポイント接続を介してドライバーに接続する場合は、ドライバーが以下のいずれかの理由で適切なインターフェイスエンドポイントの接続文字列を使用してください。

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

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

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

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

注意

構成された PrivateLink 接続が使用可能状態になっていない限り、このオプションを選択することはできません。AWS PrivateLink のステータスを確認する方法については、プライベートエンドポイント接続の問題のトラブルシューティング を参照してください。

4

接続モーダルから、 Driversをクリックします。

5

ドロップダウンからドライバーのバージョンを選択します。接続文字列が表示されます。

6
7

<password>を、データベースユーザーの作成時に指定したパスワードに置き換えます。

注意

パスワード、データベース、または接続文字列に予約済みの URI 文字が含まれている場合は、それらの文字をエスケープする必要があります。たとえば、パスワードが @bc123 の場合、接続文字列でパスワードを指定するときは、%40bc123 などに指定して、@ の文字をエスケープする必要があります。詳細については、「接続文字列パスワードの特殊文字」を参照してください。

8

次のサンプル アプリケーションは、文字列を使用して Atlas クラスターに接続し、接続が成功したことを確認するために ping を送信します。サンプルアプリケーションをテストするには以下を行います。

  1. connectという新しいディレクトリを作成し、 go modコマンドを使用してプロジェクトを初期化します。

    mkdir connect
    cd connect
    go mod init connect
  2. Go ドライバーとドライバーの依存関係をダウンロードするには、次のコマンドを実行します。

    go get go.mongodb.org/mongo-driver/v2/mongo
    go get github.com/joho/godotenv
  3. プロジェクトで、 connect.goという新しいファイルを作成し、次のコードを貼り付けます。プレースホルダーを更新した接続文字列に置き換えてください。

    1package main
    2
    3import (
    4 "context"
    5 "fmt"
    6
    7 "go.mongodb.org/mongo-driver/v2/mongo"
    8 "go.mongodb.org/mongo-driver/v2/mongo/options"
    9 "go.mongodb.org/mongo-driver/v2/mongo/readpref"
    10)
    11
    12func main() {
    13
    14 // Replace the following with your Atlas connection string
    15 uri := "mongodb+srv://<db_username>:<db_password>@<clusterName>.mongodb.net/?retryWrites=true&w=majority"
    16
    17 // Connects to your Atlas cluster
    18 client, err := mongo.Connect(options.Client().ApplyURI(uri))
    19 if err != nil {
    20 panic(err)
    21 }
    22 defer client.Disconnect(context.TODO())
    23
    24 // Sends a ping to confirm a successful connection
    25 if err := client.Ping(context.Background(), readpref.Primary()); err != nil {
    26 panic(err)
    27 }
    28 fmt.Println("Successfully connected to Atlas")
    29}
  4. アプリケーションを実行するには、次のコマンドを使用します。

    go run connect.go
    Successfully connected to Atlas
1

警告: ナビゲーションの改善が進行中次の手順が Atlas UIのビューと一致しない場合は、プレビュー ドキュメントを参照してください。

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

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

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

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

2

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

3

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

注意

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

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

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

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

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

  • AWS の場合、カスタム DNS サービスを使用するピアリングされたネットワークからドライバーに接続します。

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

注意

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

ピアの 1 つが AVAILABLE としてマークされていない限り、このオプションを選択することはできません。ピアのステータスを確認する方法については、Atlas ネットワークピアリング接続の表示 を参照してください。

注意

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

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

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

プライベートエンドポイント接続を介してドライバーに接続する場合は、ドライバーが以下のいずれかの理由で適切なインターフェイスエンドポイントの接続文字列を使用してください。

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

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

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

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

注意

構成された PrivateLink 接続が使用可能状態になっていない限り、このオプションを選択することはできません。AWS PrivateLink のステータスを確認する方法については、プライベートエンドポイント接続の問題のトラブルシューティング を参照してください。

4

接続モーダルから、 Driversをクリックします。

5

ドロップダウンからドライバーのバージョンを選択します。接続文字列が表示されます。

6
7

<password>を、データベースユーザーの作成時に指定したパスワードに置き換えます。

注意

パスワード、データベース、または接続文字列に予約済みの URI 文字が含まれている場合は、それらの文字をエスケープする必要があります。たとえば、パスワードが @bc123 の場合、接続文字列でパスワードを指定するときは、%40bc123 などに指定して、@ の文字をエスケープする必要があります。詳細については、「接続文字列パスワードの特殊文字」を参照してください。

8

次のサンプル アプリケーションは、接続文字列を使用して Atlas クラスターに接続し、接続が成功したことを確認するために ping を送信します。サンプル アプリケーションをテストするには、次のコードを Connect.java というファイルにコピーします。

プレースホルダを更新した接続文字列で置き換えてください。

1import com.mongodb.*;
2import org.bson.BsonDocument;
3import org.bson.BsonInt64;
4import org.bson.Document;
5import org.bson.conversions.Bson;
6
7import com.mongodb.client.MongoClient;
8import com.mongodb.client.MongoClients;
9import com.mongodb.client.MongoDatabase;
10
11public class Connect {
12 public static void main(String[] args) {
13 // Replace the placeholder with your Atlas connection string
14 String uri = "mongodb+srv://<db_username>:<db_password>@<clusterName>.mongodb.net/?retryWrites=true&w=majority";
15
16 // Construct a ServerApi instance using the ServerApi.builder() method
17 ServerApi serverApi = ServerApi.builder()
18 .version(ServerApiVersion.V1)
19 .build();
20
21 MongoClientSettings settings = MongoClientSettings.builder()
22 .applyConnectionString(new ConnectionString(uri))
23 .serverApi(serverApi)
24 .build();
25
26 // Create a new client and connect to the server
27 try (MongoClient mongoClient = MongoClients.create(settings)) {
28 MongoDatabase database = mongoClient.getDatabase("admin");
29 try {
30 // Send a ping to confirm a successful connection
31 Bson command = new BsonDocument("ping", new BsonInt64(1));
32 Document commandResult = database.runCommand(command);
33 System.out.println("Successfully connected to Atlas");
34 } catch (MongoException e) {
35 System.err.println(e);
36 }
37 }
38 }
39}

IDE または次のコマンドを使用して、 Connect.javaファイルをコンパイルして実行します。

javac Connect.java
java Connect
Successfully connected to Atlas
1

警告: ナビゲーションの改善が進行中次の手順が Atlas UIのビューと一致しない場合は、プレビュー ドキュメントを参照してください。

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

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

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

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

2

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

3

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

注意

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

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

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

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

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

  • AWS の場合、カスタム DNS サービスを使用するピアリングされたネットワークからドライバーに接続します。

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

注意

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

ピアの 1 つが AVAILABLE としてマークされていない限り、このオプションを選択することはできません。ピアのステータスを確認する方法については、Atlas ネットワークピアリング接続の表示 を参照してください。

注意

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

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

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

プライベートエンドポイント接続を介してドライバーに接続する場合は、ドライバーが以下のいずれかの理由で適切なインターフェイスエンドポイントの接続文字列を使用してください。

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

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

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

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

注意

構成された PrivateLink 接続が使用可能状態になっていない限り、このオプションを選択することはできません。AWS PrivateLink のステータスを確認する方法については、プライベートエンドポイント接続の問題のトラブルシューティング を参照してください。

4

接続モーダルから、 Driversをクリックします。

5

ドロップダウンからドライバーのバージョンを選択します。接続文字列が表示されます。

6
7

<password>を、データベースユーザーの作成時に指定したパスワードに置き換えます。

注意

パスワード、データベース、または接続文字列に予約済みの URI 文字が含まれている場合は、それらの文字をエスケープする必要があります。たとえば、パスワードが @bc123 の場合、接続文字列でパスワードを指定するときは、%40bc123 などに指定して、@ の文字をエスケープする必要があります。詳細については、「接続文字列パスワードの特殊文字」を参照してください。

8

次のサンプルアプリケーションは、文字列を使用して Atlas クラスターに接続し、確認メッセージを返します。サンプル アプリケーションをテストするには、次のコードをconnect.js というファイルにコピーします。

プレースホルダを更新した接続文字列で置き換えてください。

1const { MongoClient } = require("mongodb");
2
3// Replace the following with your Atlas connection string
4const url = "mongodb+srv://<db_username>:<db_password>@<clusterName>.mongodb.net/?retryWrites=true&w=majority";
5
6// Connect to your Atlas cluster
7const client = new MongoClient(url);
8
9async function run() {
10 try {
11 await client.connect();
12 console.log("Successfully connected to Atlas");
13
14 } catch (err) {
15 console.log(err.stack);
16 }
17 finally {
18 await client.close();
19 }
20}
21
22run().catch(console.dir);

サンプル アプリケーションを実行するには、次のコマンドを使用します。

node connect.js
Successfully connected to Atlas
1

警告: ナビゲーションの改善が進行中次の手順が Atlas UIのビューと一致しない場合は、プレビュー ドキュメントを参照してください。

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

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

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

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

2

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

3

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

注意

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

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

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

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

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

  • AWS の場合、カスタム DNS サービスを使用するピアリングされたネットワークからドライバーに接続します。

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

注意

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

ピアの 1 つが AVAILABLE としてマークされていない限り、このオプションを選択することはできません。ピアのステータスを確認する方法については、Atlas ネットワークピアリング接続の表示 を参照してください。

注意

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

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

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

プライベートエンドポイント接続を介してドライバーに接続する場合は、ドライバーが以下のいずれかの理由で適切なインターフェイスエンドポイントの接続文字列を使用してください。

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

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

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

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

注意

構成された PrivateLink 接続が使用可能状態になっていない限り、このオプションを選択することはできません。AWS PrivateLink のステータスを確認する方法については、プライベートエンドポイント接続の問題のトラブルシューティング を参照してください。

4

接続モーダルから、 Driversをクリックします。

5

接続文字列が表示されます。

6
7

<password>を、データベースユーザーの作成時に指定したパスワードに置き換えます。

注意

パスワード、データベース、または接続文字列に予約済みの URI 文字が含まれている場合は、それらの文字をエスケープする必要があります。たとえば、パスワードが @bc123 の場合、接続文字列でパスワードを指定するときは、%40bc123 などに指定して、@ の文字をエスケープする必要があります。詳細については、「接続文字列パスワードの特殊文字」を参照してください。

8

実行中の MongoDB インスタンスに接続するには、PyMongo は MongoClient が必要です。ターミナルで実行されている Python shell 内で、次のコマンドを実行して MongoClient をインポートします。

from pymongo import MongoClient
9

クラスターに接続するためのクライアントを指定するコマンドを作成します。

  1. Python shell で、アップデートした接続文字列を次のコマンドに貼り付けます。

    client = MongoClient('<connection-string>')
  2. データベースユーザーのパスワードを使用して接続文字列をアップデートします。

  3. 接続文字列を一重引用符で囲んでいることを確認してください。

  4. 結果のコマンドを実行します。これは、クラスターに接続するクライアントを指定します。

  5. このクライアントを使用してクラスターに接続します。

クラスターに接続したら、「クラスターでのデータの挿入と表示」に進みます。

項目一覧