MongoDB 멀티 호스트 커넥션 생성하기

Overview

MongoDB는 단일 호스트로 구성되는 경우 보다 Replica Set 또는 Sharded Cluster(Sharding)형태의 멀티 호스트 구조를 사용하는 경우가 많습니다. 이 경우 멀티 호스트 방식의 커넥션을 생성해야합니다.

MongoDB 커넥션 생성하기

1. MongoDB의 기본적인 Connection String 구조 이해하기

기본적인 MongoDB의 Connection String 구조는 아래와 같습니다.

CODE

mongodb://[Hostname or IP]:[port],[Hostname or IP]:[port],[Hostname or IP]:[port]..../?options

mongodb:// : standard connection string scheme
Hostname or IP : mongodb 클러스터 멤버 호스트의 전체 도메인이름 또는 IP 주소
options : /? 뒤에 접속에 관련된 옵션

replica set 을 사용한는 경우 /? 뒤에 replicaSet=[replica set 이름] 을 입력해야 합니다. ex. /?replicaSet=rs0

2. MongoDB 커넥션 생성하기

Settings > Database Settings > DB Connections > Create Connection > Select a data source

Database Settings 메뉴에서 DB Connections 메뉴로 이동합니다.
우측 상단의 Create Connection 버튼을 클릭합니다.
데이터 소스 선택 단계에서 mongoDB를 선택합니다.

3. Replica Set 형태로 설정하기

스크린샷 2024-01-27 오후 11.18.40.png — Settings > Database Settings > DB Connections > Create Connection > Fill out for configuration

Cluster 스위치를 를 켜서 클러스터 입력을 활성화한 후 다음의 정보들을 입력합니다.
1. Type : 커넥션 정보에 노출되는 영역입니다. Primary 역할이 동적으로 바뀔 수 있으므로 Primary 값을 유지합니다.
2. Connection String : Standard Connection String 을 입력합니다.
  1. replica set의 경우 옵션값으로 replica set 이름을 입력하여야 하므로 마지막에 /?replicaSet=[replica set name]을 추가합니다.
3. Add Instance 버튼을 눌러 각 멤버 호스트를 인스턴스로 추가합니다.
  1. 만약 클러스터가 3개의 호스트로 구성되었다면 각각의 호스트를 mongodb://호스트네임(도메인주소 또는 IP):[port] 형식으로 입력하고 Instance Name을 알맞게 입력합니다.
  2. Expose 는 커넥션 정보에서의 노출 여부를 결정할 수 있는 값입니다.
4. Authentication DB : Authentication DB의 경로를 입력합니다.
5. User Name & Password : 해당 커넥션 데이터베이스의 사용자 이름과 비밀번호를 입력합니다.
Test Connection 버튼을 클릭하여, 커넥션 접속 정보가 유효한지 확인할 수 있습니다.
Next 버튼을 통해 마무리하고 저장합니다.

Cluster 모드에 대한 더 자세한 내용은 수동으로 커넥션 등록하기에서도 확인하실 수 있습니다.

4. Sharded Cluster(Sharding) 형태로 설정하기

Sharded Cluster는 Replica Set과 Connection String의 옵션만 다르고 설정 방법은 같습니다. Replica Set은 replicaSet=[replica set name] 옵션이 필요하지만 Sharded Cluster는 이 옵션이 필요 없습니다.

Settings > Database Settings > DB Connections > Create Connection > Fill out for configuration

Cluster 스위치를 를 켜서 클러스터 입력을 활성화한 후 다음의 정보들을 입력합니다.
1. Type : 커넥션 정보에 노출되는 영역입니다. Primary 역할이 동적으로 바뀔 수 있으므로 Primary 값을 유지합니다.
2. Connection String : Standard Connection String 을 입력합니다.
3. Add Instance 버튼을 눌러 각 mongos를 인스턴스로 추가합니다.
  1. mongodb://호스트네임(도메인주소 또는 IP):[port] 형식으로 입력 후 Instance Name을 알맞게 입력합니다.
  2. Expose 는 커넥션 정보에서의 노출 여부를 결정할 수 있는 값입니다.
4. User Name & Password : 해당 커넥션 데이터베이스의 사용자 이름과 비밀번호를 입력합니다.
Test Connection 버튼을 클릭하여, 커넥션 접속 정보가 유효한지 확인할 수 있습니다.
Next 버튼을 통해 마무리하고 저장합니다.