『 MongoDB Atlas 실전 연동 가이드 ③ 』 MongoDB Atlas 연결 문자열 복사와 접속 테스트

3강. MongoDB Atlas 연결 문자열 복사와 접속 테스트

이번 강의에서 다룰 내용

앞에서 생성한 MongoDB Atlas 클러스터에 실제로 접속하기 위한 절차를 안내합니다. 이번 강의의 핵심은 다음과 같습니다.

• MongoDB Atlas에서 연결 문자열(Connection String) 복사하기
• 연결 문자열의 구성 요소 이해하기
• MongoDB Compass 또는 VS Code에서 접속 테스트하기
  

MongoDB Atlas에서 연결 문자열 복사하기

1. MongoDB Atlas 접속 → 프로젝트 선택 → Clusters 탭
2. 생성한 클러스터 옆의 Connect 버튼 클릭
3. 연결 방식 선택 화면에서 "Connect your application" 선택
4. 아래처럼 연결 문자열이 생성됩니다:

mongodb+srv://<username>:<password>@cluster0.xxxxxx.mongodb.net/myDatabase?retryWrites=true&w=majority

여기서:

• <username> → 생성한 DB 사용자명
• <password> → 생성 시 입력한 비밀번호
• cluster0.xxxxxx.mongodb.net → 클러스터 주소
• myDatabase → 사용할 데이터베이스명 (자유롭게 설정 가능)
  
  

연결 문자열 분석

mongodb+srv://testuser:test1234@cluster0.abcd123.mongodb.net/myDB?retryWrites=true&w=majority

• mongodb+srv: SRV 레코드를 사용하는 클라우드 MongoDB 접속 방식
• testuser:test1234: 사용자 인증 정보
• @cluster0.abcd123.mongodb.net: MongoDB Atlas 클러스터 주소
• /myDB: 접속할 데이터베이스 이름
• retryWrites=true&w=majority: 쓰기 안정성을 위한 옵션
  
  

접속 테스트 방법

방법 1: MongoDB Compass에서 접속

1. MongoDB Compass 설치 (없다면 공식 사이트에서 다운로드)
2. 시작 화면에서 Connection String 입력
3. Connect 클릭 → 데이터베이스 및 컬렉션 확인 가능

방법 2: VS Code MongoDB 확장으로 접속

1. VS Code에서 MongoDB for VS Code 확장 설치
2. 왼쪽 사이드바에서 MongoDB 아이콘 클릭
3. New Connection 선택 후 연결 문자열 입력
4. 클러스터 및 컬렉션이 VS Code 내에서 표시됨
   
   

자주 발생하는 연결 오류

오류 메시지 원인

Authentication failed	사용자명 또는 비밀번호 오류
IP not whitelisted	Network Access에 현재 IP 미등록
DNS resolution failed	연결 주소 오타 또는 DNS 설정 문제
connection timeout	Atlas 서버와의 네트워크 문제 또는 방화벽

단계 요약

• Atlas에서 연결 문자열을 복사하고 사용자 정보 포함해 완성
• MongoDB Compass 또는 VS Code로 접속 시도
• 클러스터 및 데이터베이스에 정상 연결되면 준비 완료

다음 4강에서는 Node.js 환경에서 mongoose를 이용해 이 연결 문자열로 직접 클라우드 MongoDB에 접속하는 코드를 작성합니다. 백엔드와 클라우드 DB 연동의 실질적인 시작입니다.

 

💬 댓글

이번 글이 도움이 되었길 바랍니다. 궁금한 점이나 요청이 있다면 언제든 댓글로 남겨주세요. 댓글은 저에게 큰 힘이 됩니다. 다음 글도 기대해주세요.