Docs Menu
Docs Home
/
MongoDB Atlas
/
클러스터 생성 및 연결
/
연결 메서드

Compass를 통해 연결합니다.

이 페이지의 내용

  • 전제 조건
  • 클러스터 연결
  • 문제 해결

클러스터의 Connect 대화 상자는 Compass를 사용하여 클러스터에 연결하기 위한 세부 정보를 제공합니다.

전제 조건

TLS

MongoDB Compass 1.5 이상을 사용해 Atlas 클러스터에 연결합니다. 이러한 버전은 필수 SNI TLS 확장을 지원합니다.

MongoDB Compass

이 절차를 완료하려면 다음 중 하나를 수행하세요.

  • MongoDB Compass를 설치합니다. Compass 설치를 참조하세요.

  • Atlas Connect 대화 상자의 링크에서 MongoDB Compass를 다운로드하여 최신 버전의 MongoDB Compass로 업그레이드합니다. 이러한 링크에 액세스하려면 연결하려는 클러스터에 대해 Connect를 클릭한 후 Compass를 클릭합니다.

IP 액세스 목록

클러스터에 액세스하려면 Atlas 프로젝트의 IP 액세스 목록에 있는 IP 주소에서 연결해야 합니다. IP 액세스 목록에 IP 주소를 추가해야 하는 경우 Connect 대화 상자에서 추가할 수 있습니다. 네트워크 액세스 탭에서 IP 주소를 추가할 수도 있습니다.

데이터베이스 사용자

클러스터에 액세스하려면 Atlas 클러스터에서 원하는 데이터베이스에 대한 액세스 권한이 있는 데이터베이스 사용자 를 만들어야 합니다. 데이터베이스 사용자는 Atlas 사용자와는 별개입니다. 데이터베이스 사용자는 MongoDB 데이터베이스에 대한 액세스 권한이 있는 반면 Atlas 사용자는 Atlas 애플리케이션 자체에 대한 액세스 권한이 있습니다.

Connect 대화 상자에서 Atlas 클러스터에 액세스할 데이터베이스 사용자를 생성할 수 있습니다. 클러스터 보기에서 데이터베이스 사용자를 추가할 수도 있습니다.

클러스터 연결

MongoDB Compass 1.8 이상 버전을 Atlas 클러스터에 연결하려면 다음 절차를 따르세요.

1

AtlasGo Atlas 에서 프로젝트 의 Clusters 페이지로 고 (Go) 합니다.

  1. 아직 표시되지 않은 경우 탐색 표시줄의 Organizations 메뉴에서 원하는 프로젝트가 포함된 조직을 선택합니다.

  2. 아직 표시되지 않은 경우 탐색 표시줄의 Projects 메뉴에서 원하는 프로젝트를 선택합니다.

  3. 아직 표시되지 않은 경우 사이드바에서 Clusters 클릭하세요.

    Clusters(클러스터) 페이지가 표시됩니다.

2

클릭 Connect

연결하려는 클러스터에 대해 Connect를 클릭합니다.

3

Connection Security를 선택합니다.

Choose Connection Type 사용 가능한 버튼 세트에서.

참고

기능이 허용된 경우 옵션이 표시됩니다.

Private IP for Peering, Private Endpoint 혹은 모두를 활성화하면 Atlas에 연결 유형 옵션이 표시됩니다. 두 기능 중 하나를 허용하지 않은 경우 버튼이 표시되지 않고 Connection Type 기본값은 Standard로 설정됩니다.

허용된 공개 IP 주소에 대해 이 연결 유형을 사용하십시오.

피어링을 사용하도록 설정한 경우 이 연결 유형을 사용합니다.

  • Google Cloud 또는 Azure의 경우 피어링된 네트워크에서 Compass에 연결 중이거나

  • AWS의 경우 사용자 지정 DNS 서비스를 사용하는 피어링 네트워크에서 Compass와 연결합니다.

이들 중 어느 것도 적용되지 않으면 IP 주소를 IP 액세스 목록에 추가하고 표준 연결 문자열을 사용하세요. 사무실이나 홈 네트워크에서 Atlas에 직접 연결하는 경우 이 옵션을 선호할 수 있습니다.

참고

피어를 사용할 수 있어야 합니다.

피어 중 하나가 AVAILABLE로 표시되어 있지 않으면 이 옵션을 선택할 수 없습니다. 피어의 상태를 확인하려면 다음을 수행하세요.

Atlas에서 프로젝트의 Network Access 페이지로 이동합니다.

  1. 아직 표시되지 않은 경우 탐색 표시줄의 Organizations 메뉴에서 프로젝트가 포함된 조직을 선택합니다.

  2. 아직 표시되지 않은 경우 내비게이션 바의 Projects 메뉴에서 프로젝트를 선택합니다.

  3. 사이드바에서 Security 제목 아래의 Network Access를 클릭합니다.

    네트워크 액세스 페이지가 표시됩니다.

참고

멀티 클라우드 클러스터

애플리케이션이 클러스터의 프라이머리와 동일한 클라우드 서비스 제공자에서 호스팅되지 않는 경우 애플리케이션은 세컨더리 읽기만 수행할 수 있습니다.

멀티 클라우드 클러스터의 경우 연결 문자열에 readPreference 연결 옵션을 추가하는 것이 좋습니다. 다음 값 중 하나를 사용합니다.

Compass의 이유로 비공개 엔드포인트 연결을 통해 Compass로 연결하는 경우 적절한 인터페이스 엔드포인트에 대한 연결 문자열을 사용합니다.

  • 클라우드 공급자 네트워크 내에서 실행되거나

  • 클라우드 공급자 네트워크에 전이적 네트워크 액세스가 가능합니다.

  • 최적화된 연결 문자열을 사용하려고 합니다.

이들 중 어느 것도 적용되지 않으면 IP 주소를 IP 액세스 목록에 추가하고 표준 연결 문자열을 사용하세요. 사무실이나 홈 네트워크에서 Atlas에 직접 연결하는 경우 이 옵션을 선호할 수 있습니다.

참고

구성된 PrivateLink 연결을 사용할 준비가 되어 있지 않으면 이 옵션을 선택할 수 없습니다. AWS PrivateLink 상태를 확인하려면 다음을 수행하세요.

Atlas에서 프로젝트의 Network Access 페이지로 이동합니다.

  1. 아직 표시되지 않은 경우 탐색 표시줄의 Organizations 메뉴에서 프로젝트가 포함된 조직을 선택합니다.

  2. 아직 표시되지 않은 경우 내비게이션 바의 Projects 메뉴에서 프로젝트를 선택합니다.

  3. 사이드바에서 Security 제목 아래의 Network Access를 클릭합니다.

    네트워크 액세스 페이지가 표시됩니다.

4

클러스터에 대한 연결을 제한하는 방법을 선택합니다.

Add a Connection IP Address

중요

Setup connection security 단계에서 클러스터에 이미 IP 액세스 목록 항목을 구성했다고 Atlas가 표시하는 경우 이 단계를 건너뜁니다. IP 액세스 목록을 관리하려면 액세스 목록에 항목 추가를 참조하십시오.

Atlas는 프로젝트의 IP 액세스 목록 항목에서 클러스터에 대한 표준 클라이언트 연결을 허용합니다. 프로젝트 IP 액세스 목록은 특정 IP 또는 CIDR 주소로 API 액세스를 제한하는 API 액세스 목록과 다릅니다.

IP 액세스 목록이 비어 있으면 Atlas는 프로젝트의 IP 액세스 목록에 IP 주소를 추가하라는 메시지를 표시합니다. 둘 중 하나를 수행하면 됩니다.

  • 현재 IP 주소에서 액세스를 허용하려면 Add Your Current IP Address을 클릭합니다.

  • Add an IP Address을 클릭하여 단일 IP 주소 또는 CIDR로 표기된 주소 범위를 추가합니다.

새로 추가된 IP 주소 또는 CIDR 범위에 대한 선택적 설명을 제공합니다. Add IP Address를 클릭하여 IP 액세스 목록에 주소를 추가합니다.

Add a Connection IP Address

중요

Setup connection security 단계에서 클러스터에 이미 IP 액세스 목록 항목을 구성했다고 Atlas가 표시하는 경우 이 단계를 건너뜁니다. IP 액세스 목록을 관리하려면 IP 액세스 목록에 항목 추가를 참조하세요.

Atlas는 프로젝트의 IP 액세스 목록 항목에서 클러스터에 대한 표준 클라이언트 연결을 허용합니다. 프로젝트 IP 액세스 목록은 특정 IP 또는 CIDR 주소로 API 액세스를 제한하는 API 액세스 목록과 다릅니다.

IP 액세스 목록이 비어 있으면 Atlas는 프로젝트의 IP 액세스 목록에 IP 주소를 추가하라는 메시지를 표시합니다. Add a Different IP Address을 클릭하여 단일 IP 주소 또는 CIDR로 표기된 주소 범위를 추가합니다.

새로 추가된 IP 주소 또는 CIDR 범위에 대한 선택적 설명을 제공합니다. Add IP Address를 클릭하여 IP 액세스 목록에 주소를 추가합니다.

  1. Choose Connection Type에서 Private Endpoint을 선택합니다.

  2. Private Link Type 옵션이 표시되면 다음 옵션 중 하나를 선택합니다.

    • Optimized SRV Connection 로드 밸런싱된 연결의 경우.

    • Legacy SRV Connection 로드 밸런싱되지 않은 연결의 경우.

    자세한 내용은 비공개 엔드포인트 뒤의 샤딩된 클러스터에 대한 연결 성능 개선을 참조하세요.

  3. Choose Private Endpoint 아래에서 사용할 엔드포인트를 선택합니다.

5

데이터베이스 사용자를 생성합니다.

중요

Setup connection security 단계에서 프로젝트에 데이터베이스 사용자가 하나 이상 구성되어 있다고 Atlas에서 표시하는 경우 이 단계를 건너뛰세요. 기존 데이터베이스 사용자를 관리하려면 데이터베이스 사용자 구성을 참조하세요.

클러스터에 액세스하려면 프로젝트에 있는 클러스터에서 원하는 데이터베이스에 대한 액세스 권한이 있는 MongoDB 사용자가 필요합니다. 프로젝트에 MongoDB 사용자가 없는 경우 Atlas에서는 Atlas Admin 역할이 있는 새로운 사용자를 생성하라는 메시지가 표시됩니다.

  1. 새로운 사용자의 Username을(를) 입력합니다.

  2. 이 새 사용자에 대한 Password를 입력하거나 Autogenerate Secure Password를 클릭합니다.

  3. 사용자를 저장하려면 Create Database User 을(를) 클릭합니다.

다음 단계에서 이 사용자를 통해 클러스터에 연결합니다.

IP 액세스 목록에 IP 주소를 추가하고 데이터베이스 사용자를 추가한 경우 Choose Your Connection Method 을(를) 클릭합니다.

6

Atlas에서 MongoDB Compass의 연결 문자열을 가져옵니다.

  1. I have MongoDB Compass를 클릭합니다.

  2. 드롭다운에서 MongoDB Compass 버전을 선택합니다. 시스템에 설치된 MongoDB Compass의 버전을 확인하려면 애플리케이션에서 About MongoDB Compass를 클릭하십시오.

  3. Atlas Connect 대화 상자에 표시된 연결 문자열을 복사합니다.

7

MongoDB Compass를 열고 Atlas에 연결합니다.

배포에서 단일 클라우드 공급자를 사용하거나 SSL, 인증 인증서 또는 SSH 터널을 사용하지 않는 경우 복사한 연결 문자열을 사용하여 MongoDB Compass에 연결합니다.

  1. New Connection을 클릭하고 연결 문자열을 Paste your connection string 필드에 붙여 넣습니다.

  2. (선택 사항) 나중에 사용할 수 있도록 이 연결을 저장하려면 Create Favorite를 클릭하고 이 연결의 이름을 추가합니다. 저장된 즐겨찾기 연결은 MongoDB Compass Connect 창의 왼쪽 창에 있는 Favorites 아래에서 찾을 수 있습니다.

  3. Connect를 클릭합니다.

배포서버가 둘 이상의 클라우드 공급자에 걸쳐 있거나 SSL, 인증서 인증 또는 SSH 터널 중 하나를 사용하는 경우 연결 필드를 개별적으로 채웁니다.

  1. Fill in Connection Fields Individually를 클릭합니다.

  2. hostname 탭에서 호스트 이름과 포트를 입력하고 드롭다운에서 인증 메커니즘을 선택합니다.

  3. More options 탭에서 다음을 구성합니다.

    자세한 내용은 MongoDB Compass 문서에서 MongoDB에 연결하기를 참조하세요.

  4. (선택 사항) 나중에 사용할 수 있도록 이 연결을 저장하려면 Create Favorite를 클릭하고 이 연결의 이름을 추가합니다. 저장된 즐겨찾기 연결은 MongoDB Compass Connect 창의 왼쪽 창에 있는 Favorites 아래에서 찾을 수 있습니다.

  5. Connect를 클릭합니다.

MongoDB Compass 1.7 또는 이전 버전의 경우 Compass에서 수동으로 새 연결을 만들 수 있습니다.

MongoDB Compass에서 Atlas 클러스터로의 New Connection을 설정하려면 MongoDB Compass에 다음 정보를 입력하고 Connect를 클릭합니다.

필드 이름
설명
Hostname

복제본 세트의 경우 프라이머리의 호스트 이름, 샤딩된 클러스터의 경우 mongos의 호스트 이름입니다.

Atlas UI에서 복제본 세트 프라이머리의 호스트 이름을 찾으려면 다음을 수행합니다.

  1. Atlas에서 프로젝트의 Clusters 페이지로 이동합니다.

    1. 아직 표시되지 않은 경우 탐색 표시줄의 Organizations 메뉴에서 원하는 프로젝트가 포함된 조직을 선택합니다.

    2. 아직 표시되지 않은 경우 탐색 표시줄의 Projects 메뉴에서 원하는 프로젝트를 선택합니다.

    3. 아직 표시되지 않은 경우 사이드바에서 Clusters 클릭하세요.

      Clusters(클러스터) 페이지가 표시됩니다.

  2. 연결하려는 클러스터를 클릭합니다.

  3. PRIMARY로 표시된 복제본 세트 멤버를 클릭합니다.

  4. 복제본 세트의 호스트 이름을 복사합니다.

Atlas user 인터페이스에서 샤딩된 클러스터의 호스트 이름을 찾으려면 다음을 수행합니다.

  1. 클러스터에 대해 Connect를 클릭합니다.

  2. Drivers를 클릭합니다.

  3. URI 연결 문자열에서 mongos호스트 이름을 추출합니다.

프라이머리 또는 mongos의 포트 번호를 기록해 두세요. 해당 포트를 사용해 MongoDB Compass의 Port 필드를 채웁니다.

Port
복제본 세트의 기본 포트 또는 샤딩된 클러스터의 mongos 포트입니다.
Authentication
Username / Password0}을 선택합니다.
Username
MongoDB 사용자. Atlas 연결 문자열은 클러스터에 설정된 MongoDB 관리 사용자를 표시합니다. 다른 MongoDB 사용자와 연결할 수 있습니다.
Password
지정된 MongoDB 사용자와 연결된 비밀번호입니다.
Authentication Database
"admin"를 지정합니다.
Replica Set Name

Atlas 클러스터의 복제본 세트 이름입니다.

복제본 세트 이름을 조회하려면 다음을 수행합니다.

  1. cluster의 Connect 버튼을 클릭합니다.

  2. Connect Your Application0}을 선택합니다.

  3. URI 연결 문자열의 replicaSet 값에서 복제본 세트 이름을 추출합니다.

Read Preference
MongoDB Compass가 읽기 작업을 어떻게 지시하는지 지정합니다. 옵션은 Primary, Primary Preferred, Secondary, Secondary Preferred 및 Nearest입니다. /core/read-preference를 참조하세요.
SSL
SELECT "Use System CA / Atlas Deployment"
SSH Tunnel
SELECT "Off"
Favorite Name
즐겨찾기로 저장하려면 연결의 이름을 입력합니다.

문제 해결

클러스터에 연결하는 데 문제가 있는 경우 연결 문제 해결을 참조하세요.

돌아가기

드라이버

다음

Mongosh