이 가이드에서는 MongoDB Connector for BI와 Atlas BI Connector 모두에서 최신 SQL 인터페이스로 마이그레이션하는 방법을 다룹니다.
중요
BI 용 MongoDB Connector 및 Atlas BI Connector는 2026년 9월에 EOL(End-of-Life)에 도달했습니다.
SQL 인터페이스
BI Connector와 유사하게 SQL Interface를 사용하면 Tableau 및 Power BI와 같은 다양한 SQL 기반 도구를 사용하여 MongoDB 배포서버의 데이터를 분석할 수 있습니다.
BI Connector와 비교하여 SQL Interface는 다음과 같은 이점을 제공합니다.
연합 데이터베이스 인스턴스 없이 Atlas 전용 클러스터에 직접 연결할 수 있습니다. 대부분의 Atlas 연결에 권장되는 경로입니다.
Atlas 연합 데이터베이스 인스턴스를 통해 Atlas 클러스터 이외의 소스에서 데이터를 읽을 수 있습니다. 단일 쿼리가 둘 이상의 데이터 소스에 걸쳐 있어야 할 때 이 경로를 사용합니다.
스키마는 별도로 유지되며 SQL 쿼리 역량을 방해하지 않고 업데이트할 수 있습니다.
Tableau 및 Power BI 용 사용자 지정 MongoDB 커넥터를 사용할 수 있습니다.
두 Atlas 연결 경로를 비교하려면 MongoDB SQL 인터페이스 개요를 참조하세요.
SQL 인터페이스 제한 사항
SQL 인터페이스는 읽기 전용 액세스를 제공합니다.
MongoSQL은 유일하게 지원되는 방언입니다. MongoSQL은 SQL-92과 호환됩니다. 다른 SQL 방언은 지원되지 않습니다.
연합 데이터베이스 인스턴스를 통해 연결하는 경우 모든 Atlas Data Federation 제한 사항도 적용됩니다. 전용 클러스터에 대한 직접 연결에는 적용되지 않습니다.
SQL 인터페이스로 전환 준비
BI Connector에서 SQL Interface로 전환하기 전에 배포서버가 마이그레이션 대상에 대한 필수 구성 요소를 충족하는지 확인하십시오. 또한 MongoDB 는 전환 계획을 세우는 데 도움이 되는 전환 준비 보고서 를 생성할 것을 권장합니다.
전제 조건
마이그레이션 대상에 따라 사전 요구 사항이 달라집니다. Atlas 대상을 비교하려면 MongoDB SQL 인터페이스 개요를 참조하세요.
Atlas 전용 클러스터: 연결할 MongoDB 데이터베이스 사용자 입니다. SQL Interface를 활성화하려면
Project Cluster Manager또는Project Replica Set Manager역할이 있는 Atlas user도 필요합니다.Atlas 연합 데이터베이스 인스턴스: 쿼리 가능한 데이터와 연결할 MongoDB 데이터베이스 사용자가 포함된 연합 데이터베이스 인스턴스입니다.
자체 관리형 Enterprise Advanced (EA) 배포서버: 필요한 데이터베이스 권한을 가진 MongoDB 데이터베이스 사용자입니다. Atlas 프로젝트 역할은 필요하지 않습니다.
전환 준비 보고서 생성
MongoDB는 BI Connector에서 SQL 인터페이스로의 전환을 계획하는 데 도움이 되는 MongoSQL 전환 준비 도구를 제공합니다. 이 도구는 과거 BI Connector 사용량을 기반으로 보고서를 생성하여 실시간 스키마 분석 및 제안을 제공하고 MongoSQL을 사용하여 올바르게 실행하기 위해 구문 변경이 필요한 쿼리를 강조 표시합니다.
보고서를 생성하려면 다음 세부 정보 중 하나 이상을 도구에 제공해야 합니다.
쿼리 분석을 위한 BI Connector 로그입니다.
스키마 분석을 위한 클러스터 URI 입니다.
쿼리, 스키마 또는 둘 다를 분석 할 수 있습니다.
(선택 사항) BI Connector 로그를 다운로드하고 압축을 풉니다.
BI Connector 로그를 제공하면 준비 보고서 도구에서 다음 정보를 보고할 수 있습니다.
볼륨 및 빈도와 같은 기록 쿼리 데이터입니다.
MongoSQL에서 실패하는 쿼리 구문입니다.
관계형 데이터베이스에 알 수 없는 데이터 유형이 있는 컬렉션 필드입니다.
온프레미스 BI Connector의 경우, 로그는 mongosqld 로그 경로를 구성한 위치에 있습니다.
Atlas BI Connector 로그를 다운로드하려면 다음을 수행합니다.
Atlas UI에서 분석하려는 BI 연결이 있는 Atlas 클러스터로 이동합니다.
클러스터 옵션(), Download Logs 을(를) 선택합니다.
다운로드
mongosql.gz.새 디렉토리 를 만든 다음 이 디렉토리에
mongosql.gz의 압축을 풉니다.
(선택 사항) 클러스터 URI를 복사합니다.
Atlas cluster URI 를 제공하면 준비 보고서 도구가 컬렉션 스키마를 분석 하고 SQL 도구에서 알 수 없는 데이터 유형이 포함된 필드를 식별할 수 있습니다.
Atlas 클러스터 URI 를 찾으려면 다음을 수행합니다.
Atlas UI에서 분석하려는 컬렉션이 있는 클러스터로 이동합니다.
Connect를 클릭합니다.
연결 옵션 목록에서 Shell을 선택합니다.
연결 URI 만 복사합니다.
연결 URI 는
mongodb+srv://bicluster.example.mongodb.net/과 유사합니다. shell 실행 파일,mongosh및 shell별 명령줄 옵션을 제외합니다.
보고서를 생성합니다.
터미널에서 Readiness Report Tool 실행 파일을 실행하여 다운로드한 로그 또는 클러스터 URI를 제공합니다.
데이터베이스 사용자 이름 을 포함해야 합니다.
--input,--uri또는 둘 다를 포함해야 합니다. URI 를 포함하면 준비 보고서 도구에서 데이터베이스 사용자 비밀번호를 입력하라는 메시지가 표시됩니다.생성된 보고서에 대해
--output대상을 지정할 수 있습니다. 그렇지 않은 경우 현재 디렉토리에 생성됩니다.--resolver를 지정하여 네트워크 요청에 대한 DNS 확인자를 선택할 수 있습니다. 가능한 값은cloudflare,google및quad9입니다.--include또는--exclude를 사용하여 네임스페이스 목록의 범위를 좁힐 수 있습니다. 글로벌 구문이 지원됩니다. 기본값 으로 모든 네임스페이스가 포함됩니다.
--help 옵션은 준비 보고서 도구 옵션의 전체 목록을 반환합니다.
<executable-filename> --helpOptions: -i, --input <INPUT> Sets the input file or directory to analyze BIC logs (optional). One of `--input` or `--uri` must be provided, or both -o, --output <OUTPUT> Sets the output directory (optional). If not specified, the current directory is used --uri <URI> The Atlas cluster URI to analyze schema (optional). One of `--input` or `--uri` must be provided, or both -u, --username <USERNAME> Username for authentication (optional). This is required if the username and password is not provided in the URI --quiet Enables quiet mode for less output --resolver <RESOLVER> The specified resolver (optional) [possible values: cloudflare, google, quad9] --include <INCLUDE> A list of namespaces to include (optional). If not provided, all namespaces are included. Glob syntax is supported --exclude <EXCLUDE> A list of namespaces to exclude (optional). If not provided, no namespaces are excluded -h, --help Print help (see more with '--help') -V, --version Print version준비 보고서 도구는 출력을 구성하고 보고서를 쉽게 탐색할 수 있도록 클릭 가능한 인덱스 파일 을 생성합니다.
SQL 인터페이스로 전환
SQL Interface의 기본 아키텍처는 BI Connector 와 다르므로 스키마 나 쿼리를 조정해야 할 수 있습니다.
SQL 인터페이스로 전환하려면 MongoSQL에서 실패하는 기존 BI Connector 쿼리를 식별하고 스키마 또는 구문을 업데이트하여 수정합니다.
경고
프로덕션 환경을 변경하기 전에 샌드박스 환경에서 전체 전환 프로세스를 테스트하는 것이 좋습니다. 스키마나 쿼리를 조정하지 않고 BI Connector에서 SQL Interface로 전환하면 호환성이 손상되는 변경이 발생할 수 있습니다.
Atlas 클러스터에서 SQL 인터페이스를 활성화합니다.
대부분의 Atlas 배포서버의 경우 전용 클러스터에서 직접 SQL 인터페이스를 활성화합니다. 이는 권장되는 마이그레이션 대상이며 연합 데이터베이스 인스턴스가 필요하지 않습니다. 단일 SQL 쿼리가 둘 이상의 데이터 소스에 걸쳐 있어야 하는 경우 대신 연합 데이터베이스 인스턴스를 사용하십시오.
SQL 인터페이스 활성화 및 사용에 대해 자세히 학습하려면 SQL 인터페이스 서버 설정을 참조하세요.
SQL 인터페이스를 사용하여 데이터에 연결합니다.
SQL 인터페이스를 통한 연결에 대해 자세히 알아보려면 SQL 도구를 MongoDB에 연결을 참조하세요.
쿼리를 테스트합니다.
새 SQL Interface 연결로 쿼리를 테스트하여 쿼리가 실행되고 예상한 결과를 반환하는지 확인하세요.
MongoSQL을 사용한 쿼리에 대해 자세히 학습하려면 MongoSQL 문을 사용한 쿼리를 참조하세요.
스키마를 보고 필요한 경우 수정하세요.
SQL 인터페이스의 스키마에 대해 자세히 알아보려면 스키마 관리를 참조하세요.
실패한 쿼리를 조정합니다.
BI Connector에서 SQL Interface로 전환할 때 일부 쿼리 구문을 변경해야 할 수 있습니다.
MongoSQL 쿼리 구문에 대해 자세히 학습하려면 MongoSQL 언어 참조를 참조하세요.
SQL 인터페이스 문제 해결
다음 MongoDB 리소스는 SQL 인터페이스 구성 문제를 해결하는 데 도움이 될 수 있습니다.
Reddit 또는 Stack Overflow의 MongoDB 커뮤니티
고객 성공 팀