Docs Menu
Docs Home
/
MongoDB Atlas
/

クラスターへの接続

項目一覧

  • 必要なアクセス権
  • 前提条件
  • Atlas クラスターへの接続
  • 次のステップ

推定所要時間: 5 分

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

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

注意

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

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

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

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

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

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

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

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

2

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

3

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

4

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

5
6
  • ターミナル。

  • テキストエディタ。

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

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

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

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

2

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

3

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

4
5

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

6
7

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

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

MongoDB Enterprise GettingStarted-shard-0:PRIMARY>

重要

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

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

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

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

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

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

2

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

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

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

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

4

配置で単一のクラウドプロバイダーを使用している場合、または 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
  1. まだ表示されていない場合は、希望するプロジェクトを含む組織を選択しますナビゲーション バーのOrganizationsメニュー

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

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

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

2

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

3

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

4

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

5
6

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

注意

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

7

次のサンプル アプリケーションは、文字列を使用して 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
  1. まだ表示されていない場合は、希望するプロジェクトを含む組織を選択しますナビゲーション バーのOrganizationsメニュー

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

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

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

2

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

3

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

4

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

5
6

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

注意

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

7

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

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

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

    go get go.mongodb.org/mongo-driver/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/bson"
    8 "go.mongodb.org/mongo-driver/mongo"
    9 "go.mongodb.org/mongo-driver/mongo/options"
    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 // Connect to your Atlas cluster
    18 client, err := mongo.Connect(context.TODO(), options.Client().ApplyURI(uri))
    19 if err != nil {
    20 panic(err)
    21 }
    22 defer client.Disconnect(context.TODO())
    23
    24 // Send a ping to confirm a successful connection
    25 var result bson.M
    26 if err := client.Database("admin").RunCommand(context.TODO(), bson.D{{"ping", 1}}).Decode(&result); err != nil {
    27 panic(err)
    28 }
    29 fmt.Println("Successfully connected to Atlas")
    30}
  4. アプリケーションを実行するには、次のコマンドを使用します。

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

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

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

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

2

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

3

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

4

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

5
6

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

注意

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

7

次のサンプル アプリケーションは、接続文字列を使用して 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
  1. まだ表示されていない場合は、希望するプロジェクトを含む組織を選択しますナビゲーション バーのOrganizationsメニュー

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

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

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

2

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

3

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

4

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

5
6

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

注意

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

7

次のサンプルアプリケーションは、文字列を使用して 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
  1. まだ表示されていない場合は、希望するプロジェクトを含む組織を選択しますナビゲーション バーのOrganizationsメニュー

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

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

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

2

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

3

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

4

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

5
6

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

注意

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

7

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

from pymongo import MongoClient
8

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

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

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

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

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

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

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