AI エージェント向け: ドキュメントインデックスは https://www.mongodb.com/ja-jp/docs/llms.txt で利用できます。すべてのページの markdown バージョンは、いずれかの URL パスに .md を追加することで利用できます。

mongosh経由でクラスターに接続する

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

このチュートリアルに従うには、マシンに mongosh がインストールされている必要があります。手順については、「mongosh のインストール」を参照してください。

Atlas クラスターに接続するには、クライアントが TLS をサポートしている必要があります。

Clients must support the SNI TLS extension to connect to an Atlas Free cluster (formerly known as M0) or a Flex cluster. MongoDB shell supports the SNI TLS extension.

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

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

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

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

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

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

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

2

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

3

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

注意

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

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

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

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

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
  1. Shell を選択します。

  2. ドロップダウン メニューから [mongosh] を選択します。shell の最新バージョンにアップグレードすることをお勧めします。mongosh のインストール済みバージョンを確認するには、次を実行します。

    mongosh --version
  3. Atlas モーダルのステップ 2では、クラスターで認証できる MongoDB ユーザーの名前を含むコピー可能な接続文字列が表示されます。この文字列をコピーします。異なる MongoDB ユーザーとして接続するには、--username オプションを変更します。

  4. mongosh コマンドと接続文字列をターミナルに貼り付けます。コマンドを実行します。shell はパスワードの入力を要求します。

注意

入力デバイスがターミナルでない場合、 mongosh はパスワードを要求しません。代わりに、 mongosh 接続文字列の後の stdin への入力をパスワードとして解釈します。

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