문서 메뉴

문서 홈MongoDB 실행 및 관리MongoDB Atlas

Atlas BI Connector에서 Atlas SQL로 전환

이 페이지의 내용

  • Atlas SQL
  • Atlas SQL 제한 사항
  • Atlas SQL 가격
  • Atlas SQL로의 전환 준비
  • Atlas SQL로 전환
  • Atlas SQL 문제 해결

MongoDB는 Atlas BI Connector 에서 최신 Atlas SQL 인터페이스로 마이그레이션할 것을 권장합니다.

참고

Atlas BI Connector와 온프레미스 BI Connector는 별도의 도구입니다. 이 가이드는 MongoDB가 단계적으로 지원 중단할 Atlas BI Connector에서 마이그레이션하는 방법에 대해 설명합니다.

Atlas BI Connector와 유사하게 Atlas SQL을 사용하면 Tableau 및 Power BI와 같은 다양한 SQL 기반 도구를 사용하여 Atlas cluster의 데이터를 분석할 수 있습니다.

Atlas BI Connector와 비교했을 때 Atlas SQL은 다음과 같은 이점을 제공합니다.

  • Atlas Data Federation 인프라를 사용하여 Atlas cluster 이외의 소스에서 데이터를 읽을 수 있습니다.

  • 스키마를 설정할 수 있습니다.

  • 사용량에 대해서만 비용을 지불합니다. 구독이 필요하지 않습니다.

  • Tableau 및 Power BI에 사용자 지정 MongoDB 커넥터를 사용할 수 있습니다.

Atlas SQL에 대해 자세히 알아보려면 Atlas SQL을 사용한 쿼리를 참조하세요.

  • Atlas SQL은 읽기 전용입니다.

  • Atlas SQL은 SQL 92 언어와만 호환됩니다. 다른 SQL 언어는 지원되지 않습니다.

  • Atlas SQL은 Atlas Data Federation의 기능이므로 모든 Atlas Data Federation 제한 사항 이 적용됩니다.

Atlas SQL에는 Atlas Data Federation 쿼리 비용과 AWS 전송 비용만 발생합니다. Atlas SQL 인터페이스 자체는 무료로 사용할 수 있습니다. 연합 데이터베이스 인스턴스를 쿼리하는 비용에 대해 자세히 알아보려면 Data Federation 비용을 참조하세요.

참고

Atlas SQL 쿼리로 인해 발생한 비용은 쿼리한 연합 데이터베이스 인스턴스 아래의 청구서에 '데이터 처리' 또는 '데이터 반환 및 전송' 요금으로 표시됩니다.

Atlas BI Connector에서 Atlas SQL로 전환하려면 배포가 다음 전제 조건을 충족하는지 확인하세요.

또한 MongoDB는 전환 계획을 세우는 데 도움이 되도록 전환 준비 보고서 를 생성할 것을 권장합니다.

  • 쿼리 가능 데이터가 포함된 연합 데이터베이스 인스턴스입니다.

  • 연합 데이터베이스 인스턴스에 연결할 MongoDB 데이터베이스 사용자입니다.

MongoDB는 Atlas BI Connector에서 Atlas SQL 인터페이스로의 전환을 계획하는 데 도움이 되는 Atlas SQL 전환 준비 도구를 제공합니다. 이 도구는 과거 Atlas BI Connector 사용량을 기반으로 보고서를 생성하여 스키마 제안을 제공하고 Atlas SQL을 사용하여 제대로 실행하기 위해 구문 변경이 필요한 쿼리를 강조 표시합니다.

보고서를 생성하려면 다음 세부 정보 중 하나 이상을 도구에 제공해야 합니다.

  • 쿼리 분석을 위한 Atlas BI Connector 로그입니다.

  • 스키마 분석을 위한 클러스터 URI 입니다.

쿼리, 스키마 또는 둘 다를 분석할 수 있습니다.

1

아래에서 운영 체제의 탭을 선택하고 실행 파일을 다운로드합니다.

2

파일에 아직 실행 권한이 없는 경우 권한을 부여합니다.

3

Atlas BI Connector 로그를 제공하면 준비 보고서 도구에서 다음 정보를 보고할 수 있습니다.

  • 볼륨 및 빈도와 같은 기록 쿼리 데이터입니다.

  • Atlas SQL에서 실패할 쿼리 구문입니다.

  • 관계형 데이터베이스에 알 수 없는 데이터 유형이 있는 컬렉션 필드입니다.

Atlas BI Connector 로그를 다운로드하려면 다음 단계를 따르세요.

  1. Atlas UI에서 분석하려는 BI 연결이 있는 Atlas cluster로 이동합니다.

  2. 클러스터 옵션(), Download Logs 을(를) 선택합니다.

  3. mongosql.gz 를 다운로드합니다.

  4. 새 디렉토리를 만든 다음 이 디렉토리에 mongosql.gz 의 압축을 풉니다.

4

Atlas cluster URI 를 제공하면 준비 보고서 도구가 컬렉션 스키마를 분석하고 SQL 도구에서 알 수 없는 데이터 유형이 포함된 필드를 식별할 수 있습니다.

클러스터 URI 를 찾으려면 다음을 수행합니다.

  1. Atlas UI에서 분석하려는 컬렉션이 있는 클러스터로 이동합니다.

  2. Connect를 클릭합니다.

  3. 연결 옵션 목록에서 Shell 을(를) 선택합니다.

  4. 연결 URI 만 복사합니다.

    연결 URImongodb+srv://bicluster.example.mongodb.net/ 와 유사합니다. 셸 실행 파일 mongosh 및 셸별 명령줄 옵션을 제외합니다.

5

터미널에서 다운로드한 로그 또는 클러스터 URI 를 제공하여 준비성 보고서 도구 실행 파일을 실행합니다.

  • 데이터베이스 사용자 이름을 포함해야 합니다.

  • --input, --uri 또는 둘 다를 포함해야 합니다. URI 를 포함하면 준비 보고서 도구에서 데이터베이스 사용자 비밀번호를 입력하라는 메시지가 표시됩니다.

  • 생성된 보고서에 대해 --output 대상을 지정할 수 있습니다. 그렇지 않으면 현재 디렉토리에 생성됩니다.

--help 옵션은 준비 보고서 도구 옵션의 전체 목록을 반환합니다.

<executable-filename> --help
Options:
-i, --input <INPUT> Sets the input file or directory
-o, --output <OUTPUT> Sets the output directory
--uri <URI> The Atlas cluster URI
-u, --username <USERNAME> Username for authentication
--quiet Enables quiet mode for less output
-h, --help Print help
-V, --version Print version

Atlas SQL의 기본 아키텍처는 Atlas BI Connector와 다르므로 스키마나 쿼리를 조정해야 할 수 있습니다.

Atlas SQL로 전환하려면 Atlas SQL에서 실패한 기존 Atlas BI Connector 쿼리를 식별하고 스키마 또는 구문을 업데이트하여 수정하세요.

경고

MongoDB는 프로덕션 환경을 변경하기 전에 샌드박스 환경에서 전체 전환 프로세스를 테스트할 것을 권장합니다. 스키마나 쿼리를 조정하지 않고 Atlas BI Connector에서 Atlas SQL로 전환하면 호환성이 손상되는 변경이 발생할 수 있습니다.

1

Atlas SQL 활성화 및 사용에 대해 자세히 알아보려면 Atlas SQL 인터페이스 활성화를 참조하세요.

2

Atlas SQL과 연결하는 방법에 대해 자세히 알아보려면 Atlas SQL 인터페이스를 사용하여 연결을 참조하세요.

3

새 Atlas SQL 연결로 쿼리를 테스트하여 쿼리가 실행되고 예상한 결과를 반환하는지 확인하세요.

Atlas SQL을 사용한 쿼리에 대해 자세히 알아보려면 Atlas SQL 문을 사용한 쿼리를 참조하세요.

4

Atlas SQL의 스키마에 대해 자세히 알아보려면 스키마 관리를 참조하세요.

5

Atlas BI Connector에서 Atlas SQL로 전환할 때 일부 쿼리 구문을 변경해야 할 수 있습니다.

Atlas SQL 쿼리 구문에 대해 자세히 알아보려면 Atlas SQL 언어 참조를 참조하세요.

다음 MongoDB 리소스는 Atlas SQL 구성 문제를 해결하는 데 도움이 될 수 있습니다.

← Atlas용 BI Connector로 연결합니다.