연결 문제 해결

가능한 솔루션

사용자를 만들었는데 인증하는 데 문제가 있는 경우 다음을 시도해 보세요:

• 데이터베이스 사용자에 대해 올바른 사용자 이름과 비밀번호를 사용하고 있으며 올바른 클러스터에 연결하고 있는지 확인하세요.

• 연결 문자열에 올바른 authSource 데이터베이스를 지정하고 있는지 확인하세요.

• 비밀번호에 특수 문자가 있는 경우 연결 문자열 비밀번호에 특수 문자 사용을 참조하세요.

가능한 솔루션

• 현재 사용하지 않는 클러스터에 대한 열려 있는 연결을 모두 닫습니다.

• 더 많은 동시 연결을 지원하려면 클러스터를 더 상위 계층으로 스케일링합니다.

• 애플리케이션을 다시 시작합니다.

• 앞으로 이 문제를 방지하려면 maxPoolSize 연결 문자열 옵션을 사용하여 연결 풀의 연결 수를 제한하는 것이 좋습니다.

이 문제를 해결하는 방법을 알아보려면 연결 문제 해결 페이지를 참조하세요.

Atlas UI에 연결

Atlas는 CDN을 사용하여 콘텐츠를 빠르게 제공합니다. 조직에서 방화벽을 사용하는 경우, 방화벽의 허용 목록에 다음 Atlas CDN 호스트를 추가하여 Atlas UI에 액세스하는 데 문제가 발생하지 않도록 하세요: 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 조회를 지원하지 않을 수 있습니다.

이 문제를 해결하려면 공용 DNS 서버 를 사용하도록 DNS 구성을 변경해 볼 수 있습니다.

퍼블릭 DNS 서버를 사용하도록 네트워크 설정을 업데이트한 후 클러스터에 연결합니다.

Ubuntu 18.04에서 DB 도구의 연결 문자열 오류

Ubuntu 18.04를 실행 중이고 DNS 시드 목록 연결 문자열 형식(mongodb+srv://)을 사용하여 MongoDB Database Tools (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단계에서 비안정 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에서 클러스터의 각 노드에 대한 결과가 하나씩 표시되어야 합니다. - 예시:

  ;; 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

• 핑 테스트:

  참고

  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>"