AI 에이전트의 경우: 문서 인덱스는 https://www.mongodb.com/ko-kr/docs/llms.txt에서 사용할 수 있으며, 모든 페이지의 마크다운 버전은 어떤 URL 경로에 .md를 추가하여 사용할 수 있습니다.
Docs Menu

MongoDB SQL 인터페이스 개요

Atlas 및 Enterprise Advanced (EA) 용 SQL 인터페이스를 통해 개발자가 아닌 사용자도 이미 사용 중인 SQL 도구에서 MongoDB 데이터를 쿼리 할 수 있습니다. It provides live, read-only access over standard ODBC 및 JDBC 연결을 통해 실시간 읽기 전용 액세스 제공하므로 MQL 학습 하거나 분석 위해 MongoDB 에서 데이터를 이동할 필요가 없습니다. 이를 통해 운영 보고 간소화되고, 인사이트를 더 빠르게 얻을 수 있으며, 데이터가 정확하고 일관적인 유지됩니다.

SQL 인터페이스는 세 가지 방법, 즉 Atlas 전용 클러스터 에 직접 배포하거나, Atlas 연합 데이터베이스 인스턴스 통해, 또는 자체 관리되는 EA( Enterprise Advanced ) 배포서버 에 배포 할 수 있습니다. 단일 Atlas cluster 에 직접 SQL 액세스 하려면 전용 클러스터 사용하세요. 이는 대부분의 Atlas 연결에 권장되는 경로이며, 연합 데이터베이스 인스턴스 필요하지 않습니다. 단일 SQL 쿼리 여러 클러스터 또는 S3 버킷과 같이 둘 이상의 데이터 소스 에 걸쳐 있어야 하는 경우 연합 데이터베이스 인스턴스 사용합니다.

전용 클러스터 (Atlas에 권장됨)
연합 데이터베이스 인스턴스
온프레미스(EA)

최적 대상

하나의 Atlas 클러스터에 있는 데이터에 대한 SQL 액세스.

둘 이상의 데이터 소스에 걸쳐 있는 단일 SQL 쿼리입니다.

직접 실행하는 자체 관리형 배포서버에 대한 SQL 액세스.

데이터 소스

전용 클러스터 1개.

여러 Atlas 클러스터, Atlas Data Federation 컬렉션 및 저장 객체에는 AWS S3 버킷, Azure Blob 저장 컨테이너, GCP 저장 버킷, HTTP URL 및 Atlas 온라인 보관이 포함됩니다.

One self-managed Enterprise Advanced (EA) deployment.

배포 요구 사항

전용 클러스터, M10 이상. Free 클러스터, Flex 클러스터 또는 M2 및 M5 공유 클러스터에서는 사용할 수 없습니다.

연합 데이터베이스 인스턴스입니다. 클러스터 계층 요구 사항 없음.

A MongoDB Enterprise cluster. Community clusters are not supported.

MongoDB 버전

6.0 이후.

5.0 이후.

6.0 이후.

데이터베이스 에디션

Atlas Core 데이터베이스 Edition 및 Atlas Infinite 데이터베이스 Edition.

Atlas Core 데이터베이스 Edition 및 Atlas Infinite 데이터베이스 Edition.

해당 사항 없음.

스키마 관리

MongoDB SQL 스키마 빌더 CLI.

Atlas UI에 내장된 Atlas Data Federation SQL 스키마 관리.

MongoDB SQL 스키마 빌더 CLI.

아키텍처

클러스터에 직접 연결합니다.

공유 및 멀티 테넌트. Atlas Data Federation 쿼리 엔진은 모든 기본 데이터 소스에서 데이터를 조회하여 집계합니다.

자체 환경에서 실행됩니다.

연결 및 쿼리 제한

클러스터 자체를 팔로우하세요.

연합 데이터베이스 인스턴스는 자체적인 동시 연결 및 쿼리 제한을 시행합니다.

배포서버 자체를 팔로우하세요.

세 가지 옵션 모두 실시간 읽기 전용 액세스를 제공하며 SQL-92과 호환되는 MongoSQL 방언을 사용합니다. SQL 인터페이스를 사용하여 배포서버에서 문서를 삽입, 업데이트 또는 삭제할 수 없으며, SQL 인터페이스는 다른 SQL 방언을 지원하지 않습니다.

SQL 인터페이스 배포서버 네 가지 구성 요소로 구성됩니다.

  • 데이터를 분석하는 데 사용되는 BI 시각화 및 보고 도구(예: Tableau 또는 Power BI.)입니다.

  • BI 도구를 MongoDB 데이터베이스에 연결하는 JDBC 또는 ODBC 드라이버. 선택하는 드라이버는 BI 도구에 따라 다릅니다.

  • JSON schema are required to translate SQL queries between your BI tool and MongoDB database. For federated database instances, schema management is built into the Atlas UI. For dedicated clusters and for self-managed Enterprise Advanced (EA) deployments, you download the MongoDB SQL Schema Builder as a CLI tool. To learn more, see Schema Management.

  • 데이터가 상주하는 MongoDB 데이터베이스 ( Atlas 클러스터 또는 자체 관리형 EA 데이터베이스).

스키마 개선 사항
대폭 개선된 스키마 통합을 경험해 보세요. 스키마 계산은 데이터에 맞게 적응되며 컬렉션을 기본적으로 표현합니다. 스키마는 캐시되지 않으며 연결에 영향을 주지 않고 언제든지 새로 고칠 수 있습니다.
간편하고 안전합니다.
복잡한 프록시 구성 없이 간단하게 설정 하여 MongoDB cluster 에 직접 연결할 수 있습니다. X509 및 OIDC 프로토콜을 지원 하여 강력한 인증 제공합니다.
최고 수준의 SQL 경험
네이티브 운전자 지원 으로 풍부한 객체와 배열을 활용하여 데이터 상호 작용을 향상시킵니다. 서버 재시작이 원활하게 이루어지므로 중단 없는 운영과 고가용성 보장됩니다. 이 인터페이스는 MongoDB-Native SQL-92 호환 언어인 MongoSQL을 사용하며, SQL 쿼리 내에서 직접 중첩 객체 병합 및 배열 해제와 같은 복잡한 변환을 지원합니다.
통합 액세스
연합 데이터베이스 인스턴스, 전용 클러스터 및 자체 관리형 EA 데이터베이스에 동일한 드라이버, 커넥터 및 스키마 매핑을 제공합니다.
BI 도구 통합
Power BI Connector는 Microsoft의 인증을 받았으며, Tableau Connector는 Tableau와의 파트너십을 통해 개발되었습니다. DirectQuery를 사용하는 Power BI와 Tableau Desktop, Tableau 서버, Tableau Prep, Tableau 클라우드를 지원합니다. Tableau 클라우드는 SCRAM 인증만 지원합니다.

SQL 인터페이스를 사용할 때는 다음 사항을 고려하여 설정 호환되고 최신 상태인지 확인하세요.

  • 드라이버, 커넥터 및 MongoDB SQL 스키마 빌더를 포함한 SQL 인터페이스 구성 요소에 대한 공식 EOL 은 없습니다. 대신 수명 주기는 작동하도록 설계된 MongoDB 서버 버전 및 언어 런타임의 호환성에 연결됩니다.

  • SQL 인터페이스 구성 요소는 해당 서버 버전의 EOL 후 최대 3 년 동안 MongoDB 서버 버전과 호환됩니다. 자세한 학습 은 MongoDB 소프트웨어 수명 주기 일정을 참조하세요.

  • We recommend upgrading your SQL Interface components to the latest version, especially when upgrading your MongoDB server. This ensures access to new features, performance enhancements, and long-term compatibility. To see the latest versions, go to the MongoDB download center.

  • 이후 버전의 SQL 인터페이스 구성 요소는 이전 MongoDB 서버 버전에 대한 지원을 제거할 수 있습니다. SQL 인터페이스 변경 로그 를 검토하여 호환성 변경 사항 및 업그레이드 요구 사항에 대한 최신 정보를 확인하는 것이 좋습니다.

BI 용 MongoDB Connector는 BI 분석 도구를 MongoDB database 또는 클러스터 에 연결하기 위한 레거시 도구입니다.BI Connector 9월 2026에 EOL(End-of-Life)에 도달합니다.

MongoDB SQL 인터페이스 설치