MongoDB Shell에서 연결
이 페이지의 내용
이 페이지에서는 MongoDB Shell(mongosh)을 통해 연합 데이터베이스 인스턴스에 연결하는 방법에 대해 설명합니다.
전제 조건
하나 이상의 데이터 저장소에 매핑된 연합 데이터베이스 인스턴스입니다.
참고
데이터의 일부 또는 전부를 Atlas 클러스터에서 가져오는 경우, 해당 클러스터에서 Atlas SQL을 활용하려면 MongoDB 버전 5.0 이상을 사용해야 합니다.
절차
Atlas에서 프로젝트의 연합 데이터베이스 인스턴스로 이동합니다.
아직 표시되지 않은 경우 다음에서 프로젝트가 포함된 조직을 선택합니다. Organizations 메뉴를 클릭합니다.
아직 표시되지 않은 경우 내비게이션 바의 Projects 메뉴에서 프로젝트를 선택합니다.
사이드바에서 Services 제목 아래의 Data Federation를 클릭합니다.
Data Federation 페이지가 표시됩니다.
아직 MongoDB Shell을 설치하지 않았다면 설치합니다.
MongoDB Shell이 설치되어 있지 않은 경우:
연결 모달에서 I do not have the MongoDB Shell installed을 선택합니다.
모달 드롭다운 메뉴에서 운영 체제를 선택합니다.
모달에 제공된 운영 체제에 대한 설치 지침을 따릅니다.
(선택 사항)
mongosh를 성공적으로 설치했는지 확인합니다.설치가 성공했는지 확인하려면 터미널에서 다음을 실행합니다.
mongosh --version 성공적으로 설치하는 경우
mongosh에 버전이 표시됩니다.
MongoDB Shell이 이미 설치되어 있는 경우:
연결 모달에서 I have the MongoDB Shell installed을 선택합니다.
모달 드롭다운 메뉴에서
mongosh을 선택합니다.참고
MongoDB Shell 또는
mongosh는 모달 드롭다운 메뉴의mongo버전과는 별개입니다.mongosh설치되었는지 확인하려면 단말기에서 다음을 실행합니다.mongosh --version mongosh가 설치되어 있으면 버전이 표시됩니다.
인증 방법을 선택합니다.
데이터베이스 액세스가 구성된 방식에 따라 인증 방법이 달라집니다. 데이터베이스 액세스에 대해 자세히 알아보려면 데이터베이스 사용자 구성을 참조하세요.
다음을 선택할 수 있습니다.
Password (SCRAM)또는
X.509.
Atlas Data Federation은 인증 방법에 대한 연결 문자열을 제공합니다.
집계 구문 및 단형 구문
Atlas SQL은 집계 파이프라인 단계 구문과 SQL 쿼리 구성을 위한 짧은 형식 구문을 지원합니다. 이러한 구문 중 하나를 사용하여 MongoDB Shell에서 쿼리를 작성할 수 있습니다.
집계 파이프라인 단계 구문
$sql 집계 파이프라인 단계를 사용하여 Atlas SQL 쿼리를 쓸 수 있습니다. $sql에 제공해야 하는 속성 목록은 $sql을 참조하세요.
다음 예시에서는 $sql 구문을 사용하여 Atlas SQL 문 select * from Users limit 2를 실행합니다.
db.aggregate( [ { $sql: { statement: "SELECT * FROM users LIMIT 2", format: "jdbc", dialect: "mongosql" } } ] )
참고
Atlas SQL은 mongosql 방언을 사용합니다.
짧은 형식 구문
짧은 형식 구문인 db.sql을 사용하여 Atlas SQL 문을 직접 제공할 수 있습니다.
중요
짧은 형식의 구문은 안정적이지 않으며 향후 변경될 수 있습니다.
db.sql(` SELECT * FROM users LIMIT 2 `);