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

可能な解決策

作成済みのユーザーの認証で問題が生じた場合は、以下の手順をお試しください。

• データベースユーザーの正しいユーザー名とパスワードを使用していること、および正しいクラスターに接続していることを確認してください。

• 接続文字列で指定している authSource データベースが正しいことを確認してください。

• パスワードに特殊文字が含まれている場合は、「接続文字列パスワードの特殊文字」を参照してください。

可能な解決策

• 現在使用していないクラスターへのオープン接続を閉じてください。

• クラスターをより高い階層にスケーリングすると、より多くの同時接続がサポートされます。

• アプリケーションを再起動します。

• 今後このような問題が生じないように、maxPoolSize 接続文字列オプションを使用して接続プール内の接続数を制限することを検討してください。

この問題を解決する方法については、「接続の問題の修正」を参照してください。

Atlas UI への接続

Atlas は CDN を使用してコンテンツを迅速に提供します。組織でファイアウォールを使用している場合は、Atlas UI へのアクセスに関する問題を防ぐために、Atlas CDN ホスト（https://assets.mongodb-cdn.com/）をファイアウォールの許可リストに追加します。

クラスターへの接続

Atlas クラスターはポート 27017 で動作します。クラスターに接続するには、このポートにアクセスできる必要があります。さらに、次の適切なポートがオープンであることを確認してください。

• シャーディングされたクラスターの場合は、ポート 27016 へのアクセスを許可します。

• BI Connector の場合、ポート 27015 へのアクセスを許可します。

サードパーティの Outgoing port tester を使用して、ポートへのアクセス能力をチェックできます。

これらのポートにアクセスできない場合は、システムのファイアウォール設定を確認し、これらのポートへのアクセスがブロックされていないことを確認してください。

接続文字列の形式が不適切

Atlas への接続に使用する接続文字列の形式は、次のようないくつかの要因によって決まります。

• お使いの mongosh バージョン。詳細については、「mongosh 経由で接続」を参照してください。

• ドライバーのバージョン。詳細については、「ドライバー経由での接続」を参照してください。

本番環境に移行する前に、テスト環境で接続文字列を検証してください。

接続文字列パスワード内の特殊文字

パスワードに特殊文字が含まれていて、接続文字列 URI でパスワードを使用する場合は、特殊文字をエンコードしてください。

パーセント エンコーディング を必要とする特殊文字を使用してパスワードの更新を試みると、次のエラー メッセージが表示されます。

This password contains special characters which will be URL-encoded.

: / ? # [ ] @ ! $ & ' ( ) * , ; = %

p%40ssw0rd%279%27%21

➤ [言語の選択] ドロップダウン メニューを使用して、このセクションで例示されるエンコーディングの言語を設定します。

1
package main
2
3
import (
4
	"context"
5
	"fmt"
6
	"net/url"
7
8
	"go.mongodb.org/mongo-driver/bson"
9
	"go.mongodb.org/mongo-driver/mongo"
10
	"go.mongodb.org/mongo-driver/mongo/options"
11
)
12
13
func main() {
14
	username := "<username>"
15
	password := "<password>"
16
	cluster := "<clusterName>"
17
	authSource  := "<authSource>"
18
	authMechanism := "<authMechanism>"
19
20
	uri := "mongodb+srv://" + url.QueryEscape(username) + ":" + 
21
		url.QueryEscape(password) + "@" + cluster + 
22
		"/?authSource=" + authSource +
23
		"&authMechanism=" + authMechanism
24
25
	client, err := mongo.Connect(context.TODO(), options.Client().ApplyURI(uri))
26
	if err != nil {
27
		panic(err)
28
	}
29
	defer client.Disconnect(context.TODO())
30
31
	collection := client.Database("<dbName>").Collection("<collName>")
32
33
	cursor, err := collection.Find(context.TODO(), bson.D{})
34
	if err != nil {
35
		panic(err)
36
	}
37
38
	var results []bson.D
39
	if err = cursor.All(context.TODO(), &results); err != nil {
40
		panic(err)
41
	}
42
	for _, result := range results {
43
		fmt.Println(result)
44
	}
45
}

1
import com.mongodb.client.MongoClient;
2
import com.mongodb.client.MongoClients;
3
import com.mongodb.client.MongoCollection;
4
import com.mongodb.client.MongoDatabase;
5
6
import org.bson.Document;
7
import java.net.URLEncoder;
8
9
public class Encoding {
10
11
    public static void main(String [] args){
12
13
        try{
14
            String username = URLEncoder.encode("<username>", "UTF-8");
15
            String password = URLEncoder.encode("<password>", "UTF-8");
16
            String cluster = "<clusterName>";
17
            String authSource = "<authSource>";
18
            String authMechanism = "<authMechanism>";
19
            
20
            String uri = "mongodb+srv://" + username + ":" + password + "@" + cluster + 
21
                         "/?authSource=" + authSource + "&authMechanism=" + authMechanism;
22
23
            MongoClient mongoClient = MongoClients.create(uri);
24
    
25
            MongoDatabase database = mongoClient.getDatabase("<dbName>");
26
            MongoCollection<Document> collection = database.getCollection("<collName>");
27
            
28
            collection.find().forEach(doc -> System.out.println(doc.toJson()));
29
30
        } catch(Exception e){
31
            System.err.println(e.getCause());
32
33
        }
34
    }
35
}

1
const { MongoClient } = require("mongodb");
2
3
const username = encodeURIComponent("<username>");
4
const password = encodeURIComponent("<password>");
5
const cluster = "<clusterName>";
6
const authSource = "<authSource>";
7
const authMechanism = "<authMechanism>";
8
9
let uri =
10
  `mongodb+srv://${username}:${password}@${cluster}/?authSource=${authSource}&authMechanism=${authMechanism}`;
11
12
const client = new MongoClient(uri);
13
14
async function run() {
15
  try {
16
    await client.connect();
17
18
    const database = client.db("<dbName>");
19
    const ratings = database.collection("<collName>");
20
21
    const cursor = ratings.find();
22
23
    await cursor.forEach(doc => console.dir(doc));
24
  } finally {
25
    await client.close();
26
  }
27
}
28
run().catch(console.dir);

1
import pymongo
2
from urllib.parse import quote_plus
3
4
username = quote_plus('<username>')
5
password = quote_plus('<password>')
6
cluster = '<clusterName>'
7
authSource = '<authSource>'
8
authMechanism = '<authMechanism>'
9
10
uri = 'mongodb+srv://' + username + ':' + password + '@' + cluster + '/?authSource=' + authSource + '&authMechanism=' + authMechanism
11
12
client = pymongo.MongoClient(uri)
13
14
result = client["<dbName"]["<collName>"].find()
15
16
# print results
17
for i in result:
18
    print(i)

接続文字列と互換性のないドライバーのバージョン

このエラー メッセージが表示される場合は、ドライバーが古くなっている可能性があります。ドライバーの更新手順については、特定のドライバーのドキュメントを参照してください。

インターネット サービス プロバイダーの DNS が接続文字列をブロック

DNS シードリスト接続文字列形式を使用して Atlas に接続すると、次のエラーが表示される場合があります。

DNSHostNotFound: Failed to look up service "<MongoDB service name>"

このエラーは、ISP が提供するデフォルトの DNS サーバーを使用している場合に発生することがあります。その DNS サーバーが DNS シードリストの接続文字列形式で使用される SRV lookup をサポートしていない可能性があります。

この問題を解決するには、 DNS 構成を変更してパブリック DNS サーバーを使用することをお試しください。

パブリック DNS サーバーを使用するようにネットワーク設定を更新したら、クラスターに接続します。

Ubuntu 18.04 で DB ツールを使用する場合の接続文字列エラー

Ubuntu 18.04 を実行中に DNS シードリスト接続文字列形式（mongodb+srv://）を使用して MongoDB データベースツール のいずれか（mongodump、mongorestore など）から Atlas に接続すると、次のエラーが表示される場合があります。

lookup nta8e.mongodb.net on 123.45.67.8:27017: cannot unmarshal DNS message

その場合は、次のいずれかの接続オプションを代わりに使用します。

• --uri オプションを 非 SRV 接続文字列 (mongodb://）と併用する。

• 接続ホストを指定するために --host オプションを使用する。

SRV 接続文字列を使用した場合の接続拒否

ドライバーまたは Compass で DNS シードリスト接続文字列形式（mongodb+srv://）を使用する場合、次のエラーが表示されることがあります。

Error: querySrv ECONNREFUSED _mongodb._tcp.<SRV Record>

トラブルシューティングを開始するには、クラスターのシードリスト接続文字列から DNS SRV 名とノードの個々のホスト名およびポート番号の両方が必要です。

DNS SRV名を見つけるには、次の手順に従ってください。

1. 「アプリケーションの接続」の 手順 1 -6 に従ってください。

2. ステップ 7 で、選択したドライバーの最新バージョンを選択します。

3. DNS SRV 名は、パスワードの後の @ 記号から始まり、.mongodb.net で終わります（例: cluster0.dfget.mongodb.net ）。

ノードのホスト名とポート番号を見つけるには、次の手順を実行してください。

1. 「アプリケーションの接続」の 手順 1 -6 に従ってください。

2. ステップ 7 で、選択したドライバーの最新バージョンを選択します。

3. ステップ 7 で、Non-Stable API の下で最も古いドライバー バージョンを選択します

   • 各ホスト名は、パスワードの後の @ 記号の後に始まり、.mongodb.net で終わるカンマ区切りリストに含まれています。

4. 各ホスト名の後のポート番号を記録してください。

   • クラスターの接続文字列は、そのトポロジーと接続方法に応じて、さまざまなホスト名とポートを含む場合があります。

   • プライベートエンドポイントの動作の詳細については、「プライベートエンドポイントの構成」を参照してください。

基本的なネットワーク接続をテストする:

問題が発生しているアプリケーション サーバーのターミナルまたはコマンドプロンプトで、次のコマンドを実行します。

• DNS SRV 解決テスト:

  Linux/MacOS:

  dig SRV _mongodb._tcp.<DNS SRV name>

  Windows:

  nslookup -debug -q=SRV  _mongodb._tcp.<DNS SRV name>

  応答の ANSWER SECTION に、クラスター内の各ノードに対して 1 つの結果が表示されるはずです。以下に例を挙げます。

  ;; ANSWER SECTION:
  _mongodb._tcp.gcluster0.dfget.mongodb.net. 60 IN SRV 0 0 27017 cluster0-shard-00-00.dfget.mongodb.net.
  _mongodb._tcp.gcluster0.dfget.mongodb.net. 60 IN SRV 0 0 27017 cluster0-shard-00-01.dfget.mongodb.net.
  _mongodb._tcp.gcluster0.dfget.mongodb.net. 60 IN SRV 0 0 27017 cluster0-shard-00-02.dfget.mongodb.net.

• DNS ノードのホスト名解決テスト:

  クラスター内の各ホスト名に対して、このコマンドを実行します。

  Linux/MacOS:

  dig <Node Hostname>

  Windows:

  nslookup -debug -q=A <Node Hostname>

  応答の ANSWER SECTION に、DNS ホスト名が解決された IP アドレスが表示されるはずです。

  • 以下に例を挙げます。

  ;; ANSWER SECTION: cluster0-shard-00-00.ag9in.mongodb.net. 60 IN A 10.10.10.10

• Ping テスト:

  注意

  ICMP リクエストは、プライベートエンドポイント接続を通じてクラウドプロバイダーによってブロックされる可能性があります。

  クラスター内の各ホスト名に対して、このコマンドを実行します。

  Linux/Mac OS:

  ping -c 10 <Node Hostname>

  Windows:

  ping /n 10 <Node Hostname>

• エンドツーエンドのネットワーク接続テスト:

  Linux/Mac/OS:

  nc -zv <Node Hostname> <Node Port Number>

  Windows:

  Test-NetConnection -Port <Node Port Number> -InformationLevel "Detailed" -ComputerName "<Node Hostname>"