経由で接続 mongosh
クラスターの Connect ダイアログ ボックスには、MongoDB shell、mongosh を介してクラスターに接続するための詳細が表示されます。
前提条件
TLS
Atlas クラスターに接続するには、クライアントが TLS をサポートしている必要があります。
クライアントは AtlasM0 無料クラスターまたは 共有クラスターに接続するために SNI TLSM2/M5 拡張機能をサポートしている必要があります。MongoDB4MongoDB.0 以降のshell シェルは SNI TLS 拡張をサポートしています。
IP アクセス リスト
クラスターにアクセスするには、Atlas プロジェクトの IP アクセス リストにある IP アドレスから接続する必要があります。IP アクセス リストに IP アドレスを追加する必要がある場合は、Connect ダイアログ ボックスで追加できます。 の [ネットワーク アクセス] タブから IP アドレスを追加することもできます。
データベースユーザー
クラスターにアクセスするには、Atlas クラスター上の目的のデータベースへのアクセス権を持つ データベース ユーザー を作成する必要があります。データベース ユーザーは Atlas ユーザーとは別です。データベース ユーザーは MongoDB データベースにアクセスでき、Atlas ユーザーは Atlas アプリケーション自体にアクセスできます。
Connect ダイアログ ボックスで、Atlas クラスターにアクセスするためのデータベースユーザーを作成できます。クラスター ビューからデータベースユーザーを追加することもできます。
クラスターへの接続
AtlasGoClustersAtlas で、プロジェクトの ページにGoします。
まだ表示されていない場合は、希望するプロジェクトを含む組織を選択しますナビゲーション バーのOrganizationsメニュー
まだ表示されていない場合は、ナビゲーション バーのProjectsメニューから目的のプロジェクトを選択します。
まだ表示されていない場合は、サイドバーの [Clusters] をクリックします。
[ Clusters （クラスター） ] ページが表示されます。
接続セキュリティを選択します。
Choose Connection Type （使用可能なボタンのセットから選択）。
注意
機能が有効な場合のオプション表示
Atlas は、ピアリングのプライベート IP、プライベートエンドポイント、またはその両方を有効にすると、接続タイプのオプションを表示します。どちらの機能も有効にしていない場合、ボタンは表示されず、接続タイプのデフォルトは標準になります。
許可されたパブリック IP アドレスにはこの接続タイプを使用します。
ピアリングを有効にした場合は、次の接続タイプを使用します。
Google Cloud または Azure でピアリングされたネットワークから {{connChoice}} に接続している場合、または
AWS でカスタム DNS サービスを使用するピアリングされたネットワークから {{connChoice}} に接続している場合。
これらのいずれも当てはまらない場合は、IP アドレスを IP アクセス リストに追加し、標準接続文字列を使用します。オフィスまたは自宅のネットワークから Atlas に直接接続する場合は、このオプションが望ましいでしょう。
注意
ピアリングが利用可能である必要があります
ピアの 1 つがAVAILABLEとしてマークされていない限り、このオプションを選択することはできません。同僚のステータスを確認するには：
Atlas で、プロジェクトの [Network Access] ページに移動します。
まだ表示されていない場合は、プロジェクトを含む組織をナビゲーション バーの Organizations メニューで選択します。
まだ表示されていない場合は、ナビゲーション バーの Projects メニューからプロジェクトを選択します。
サイドバーで、 Security見出しの下のNetwork Accessをクリックします。
[ネットワーク アクセス]ページが表示されます。
注意
マルチクラウドクラスター
アプリケーションがクラスターのプライマリと同じクラウドサービスプロバイダーでホストされていない場合、アプリケーションはセカンダリ読み取りのみを実行できます。
マルチクラウド クラスターの場合は、readPreference 接続オプションを接続文字列 に追加することを検討してください。次のいずれかの値を使用します。
プライベートエンドポイント接続を介して {{connChoice}} と接続している場合、{{{connChoice}} は次の理由で、適切なインターフェイスエンドポイントの接続文字列を使用します。
クラウドプロバイダー ネットワーク内で実行されます、または
クラウドプロバイダー ネットワークへの推移的なネットワーク アクセスを持ちます。
最適化された接続文字列 を使用したいと考えています。
これらのいずれにも当てはまらない場合は、IP アドレスを IP アクセス リストに追加し、標準接続文字列を使用します。オフィスや自宅のネットワークから Atlas に直接接続する場合は、このオプションが望ましいでしょう。
注意
構成された PrivateLink 接続が使用可能状態になっていない限り、このオプションを選択することはできません。AWS PrivateLink のステータスを確認するには以下のようにします。
Atlas で、プロジェクトの [Network Access] ページに移動します。
まだ表示されていない場合は、プロジェクトを含む組織をナビゲーション バーの Organizations メニューで選択します。
まだ表示されていない場合は、ナビゲーション バーの Projects メニューからプロジェクトを選択します。
サイドバーで、 Security見出しの下のNetwork Accessをクリックします。
[ネットワーク アクセス]ページが表示されます。
クラスターへの接続を制限する方法を選択します。
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 アクセス リストに追加します。
Choose Connection Type で Private Endpoint を選択します。
Private Link Typeオプションが表示された場合は、次のいずれかのオプションを選択します。
Optimized SRV Connection 負荷分散された接続用。
Legacy SRV Connection 負荷分散されていない接続の場合。
詳細については、「プライベートエンドポイントの背後にあるシャーディングされたクラスターの接続パフォーマンスの向上」を参照してください。
[ Choose Private Endpoint] で、使用するエンドポイントを選択します。
データベースユーザーを作成します。
重要
Atlas がSetup connection security の手順でプロジェクトに少なくとも 1 人のデータベースユーザーが設定されていることを示している場合は、この手順をスキップします。既存のデータベースユーザーを管理するには、「データベースユーザーの構成」を参照してください。
クラスターにアクセスするには、プロジェクト内の目的のデータベースまたはクラスター上のデータベースにアクセスできる MongoDB ユーザーが必要です。プロジェクトに MongoDB ユーザーがいない場合、Atlas は Atlas 管理者ロールを持つ新しいユーザーを作成するように要求します。
新しいユーザーの Username を入力します。
この新しいユーザーの Password を入力するか、Autogenerate Secure Password をクリックします。
Create Database User をクリックしてユーザーを保存します。
次のステップでは、このユーザーを使用してクラスターに接続します。
IP アクセス リストに IP アドレスを追加し、データベースユーザーを追加したら、Choose Your Connection Method をクリックします。
を使用して Atlasmongosh クラスターに接続します。
Shell を選択します。
次の画面では、システムに mongosh がすでにインストールされているかどうかに基づいて、続行するためのオプションが提供されます。
ドロップダウンメニューからOSを選択します。
次のいずれかのオプションを使用してダウンロードします。
[ Download mongosh ] をクリックしてダウンロードを開始します。
[Copy download URL] をクリックしてダウンロード URL をクリップボードにコピーし、次のいずれかを実行します。
curlを使用して URL からインストーラファイルを取得するか、ブラウザ ウィンドウに URL を貼り付けます。
MongoDB Shell ページからインストーラーをダウンロードします。
ダウンロードしたアーカイブからファイルを抽出します。
mongoshバイナリをPATH環境変数に追加します。抽出された MongoDB Shell バイナリがファイルシステム内の目的の場所にあることを確認し、その場所を
PATH環境変数に追加します。Control Panelを開きます。
System and Security カテゴリで、[System] をクリックします。
[ Advanced system settingsをクリックします。 [ System Propertiesモーダルが表示されます。
[Environment Variables] をクリックします。
[Path ] を選択し、[Edit] をクリックします。
Newをクリックして、
mongoshバイナリにファイルパスを追加します。Atlas モーダルのステップ 3 は、コピー可能な接続文字列を表示します。この文字列には、クラスターで認証できる MongoDB ユーザーの名前が含まれます。この文字列をコピーします。別の MongoDB ユーザーとして接続するには、 --usernameオプションを変更します。
mongoshコマンドと接続文字列をターミナルに貼り付けます。コマンドを実行します。shell はパスワードの入力を要求します。
提供されている Homebrew コマンドを使用します。
Atlas UI ウィンドウから Homebrew コマンドをコピーし、ターミナルで実行します。
Atlas モーダルのステップ 3 は、コピー可能な接続文字列を表示します。この文字列には、クラスターで認証できる MongoDB ユーザーの名前が含まれます。この文字列をコピーします。別の MongoDB ユーザーとして接続するには、 --usernameオプションを変更します。
mongoshコマンドと接続文字列をターミナルに貼り付けます。コマンドを実行します。shell はパスワードの入力を要求します。
次のいずれかのオプションを使用してインストーラーをダウンロードします。
[ Download mongosh ] をクリックしてダウンロードを開始します。
[Copy download URL] をクリックしてダウンロード URL をクリップボードにコピーし、次のいずれかを実行します。
curlを使用して URL からインストーラファイルを取得するか、ブラウザ ウィンドウに URL を貼り付けます。
MongoDB Shell ページからインストーラーをダウンロードします。
注意
ダウンロードするファイルの種類は、選択したオペレーティング システムによって異なります。次のバージョンを選択した場合:
Ubuntu または Debian では、
.debパッケージを受け取ります。RHEL、Amazon Linux、または SUSE の場合、
.rpmパッケージを受け取ります。
ご使用のオペレーティング システムがリストにない場合は、
mongoshドキュメントの「.tgz インストール手順」を参照してください。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 Atlas モーダルのステップ 3 では、コピー可能な接続文字列が表示されます。この文字列には、クラスターで認証できる MongoDB ユーザーの名前が含まれます。この文字列をコピーします。異なる MongoDB ユーザーとして接続するには、
--usernameオプションを変更します。mongoshコマンドと接続文字列をターミナルに貼り付けます。コマンドを実行します。shell からパスワードの入力を求められます。
ドロップダウン メニューから [
mongosh] を選択します。shell の最新バージョンにアップグレードすることをお勧めします。mongoshのインストール済みバージョンを確認するには、次を実行します。mongosh --version Atlas モーダルのステップ 2では、クラスターで認証できる MongoDB ユーザーの名前を含むコピー可能な接続文字列が表示されます。この文字列をコピーします。異なる MongoDB ユーザーとして接続するには、--username オプションを変更します。
mongoshコマンドと接続文字列をターミナルに貼り付けます。コマンドを実行します。shell はパスワードの入力を要求します。
トラブルシューティング
クラスターへの接続に問題がある場合は、「接続の問題のトラブルシューティング」を参照してください。