Docs Menu
Docs Home
/
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 은 읽기 전용입니다.

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

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

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

참고

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

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

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

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

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

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

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

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

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

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

1

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

MongoDB Atlas SQL 준비보고서 도구를 다운로드하세요.

MongoDB Atlas SQL 준비보고서 도구를 다운로드하세요.

MongoDB Atlas SQL 준비보고서 도구를 다운로드하세요.

2

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

chmod +x <executable-filename>
chmod +x <executable-filename>
chmod +x <executable-filename>
3

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

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

  • Atlas SQL 에서 실패하는 쿼리 구문.

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

Atlas BI Connector 로그를 다운로드하려면 다음을 수행합니다.

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

  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/ 와 유사합니다. shell 실행 파일, mongosh 및 shell명령줄 옵션을 제외합니다.

5

터미널에서 Readiness Report Tool 실행 파일을 실행하여 다운로드한 로그 또는 클러스터 URI를 제공합니다.

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

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

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

  • --resolver 를 지정하여 네트워크 요청에 대한 DNS 확인자를 선택할 수 있습니다. 가능한 값은 cloudflare, googlequad9 입니다.

  • --include 또는 --exclude 를 사용하여 네임스페이스 목록의 범위를 좁힐 수 있습니다. 글로벌 구문이 지원됩니다. 기본값 으로 모든 네임스페이스가 포함됩니다.

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

<executable-filename> --help
Options:
-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

준비 보고서 도구는 출력을 구성하고 보고서를 쉽게 탐색할 수 있도록 클릭 가능한 인덱스 파일 을 생성합니다.

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

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

경고

MongoDB recommends testing the full transition process in a sandbox environment before you make changes to your production environment. 스키마 나 쿼리를 조정하지 않고 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 구성 문제를 해결하는 데 도움이 될 수 있습니다.

돌아가기

BI 커넥터