다음을 통해 공유


MongoDB Atlas SQL 인터페이스

비고

이 커넥터는 MongoDB에서 소유하고 제공합니다.

요약

Item Description
배포 상태 일반 공급
Products Power BI (의미론적 모델)
Power BI(데이터 흐름)
패브릭(데이터플로우 Gen2)
지원되는 인증 유형 데이터베이스(사용자 이름/암호)
X.509 인증서
OAuth(OIDC)
AWS ID 및 액세스 관리

비고

사용자 이름/암호 이외의 인증 메커니즘(예: X.509 인증서, OAuth(OIDC) 또는 AWS IAM)을 사용하는 경우 연결 대화 상자에서 사용자 이름 및 암호 필드를 비워 둘 수 있습니다. 적절한 자격 증명은 선택한 인증 방법을 통해 처리됩니다.

필수 조건

MongoDB Atlas SQL 커넥터를 사용하려면 Atlas 페더레이션 데이터베이스 설정이 있어야 합니다.

페더레이션된 데이터베이스 인스턴스에 대한 연결 정보 가져오기

  1. 페더레이션된 데이터베이스 인스턴스로 이동합니다. Atlas의 왼쪽 탐색 패널에서 데이터 페더레이션 을 선택합니다.
  2. Connect를 선택하여 연합된 데이터베이스 인스턴스 연결 창을 엽니다.
  3. Atlas SQL 인터페이스를 사용하여 연결을 선택합니다.
  4. Power BI 커넥터를 선택합니다.
  5. 페더레이션된 데이터베이스 이름 및 MongoDB URI를 복사합니다. 이후 단계에서 필요합니다.

비고

데이터 중 일부 또는 전부가 Atlas 클러스터에서 가져온 경우 해당 클러스터가 Atlas SQL을 활용하려면 MongoDB 버전 5.0을 사용해야 합니다.

MongoDB Atlas SQL 커넥터를 사용하려면 MongoDB Atlas SQL ODBC 드라이버가 필요합니다.

지원되는 기능

  • Import
  • DirectQuery(Power BI 의미 체계 모델)

파워 쿼리 데스크톱에서 Atlas SQL 인터페이스를 사용하여 MongoDB Atlas 페더레이션 데이터베이스에 연결

Atlas SQL 인터페이스를 사용하여 연결하려면 다음을 수행합니다.

  1. Power BI Desktop의 리본에서 데이터 가져오기를 선택합니다.

  2. 왼쪽의 범주에서 데이터베이스를 선택하고 MongoDB Atlas SQL을 선택한 다음 연결을 선택합니다.

    MongoDB Atlas SQL 커넥터가 선택된 데이터 가져오기 대화 상자의 스크린샷

  3. MongoDB Atlas SQL 커넥터에 처음으로 연결하는 경우 타사 알림이 표시됩니다. 이 메시지를 다시 표시하지 않으려면 "이 커넥터로 다시 경고하지 마세요" 를 선택합니다.

    를 선택합니다 계속.

  4. 표시되는 MongoDB Atlas SQL 창에서 다음 값을 입력합니다.

    • MongoDB URI입니다. 필수

      필수 구성 요소에서 가져온 MongoDB URI를 사용합니다. 사용자 이름과 암호가 포함되어 있지 않은지 확인합니다. 사용자 이름 및/또는 암호를 포함하는 URI는 거부됩니다.

    • 페더레이션된 데이터베이스 이름입니다 . 필수

      필수 구성 요소에서 가져온 페더레이션된 데이터베이스의 이름을 사용합니다.

    • SQL 쿼리입니다. 선택 사항

      즉시 실행하려면 네이티브 Atlas SQL 쿼리를 입력합니다. 데이터베이스가 이전에 사용한 것과 동일한 경우 쿼리에서 생략할 수 있습니다.

      SELECT * FROM orders
      
    • 원하는 데이터 연결 모드에 대해 가져오기 또는 DirectQuery를 선택합니다.

    확인을 선택합니다.

    연결 정보를 입력하는 MongoDB Atlas SQL 연결 대화 상자의 스크린샷

  5. Atlas MongoDB 데이터베이스 액세스 사용자 이름 및 암호를 입력하고 연결을 선택합니다.

    자격 증명을 입력하는 MongoDB Atlas SQL 인증 대화 상자의 스크린샷

    비고

    특정 Atlas 페더레이션 데이터베이스에 대한 사용자 이름 및 암호를 입력하면 Power BI Desktop은 후속 연결 시도에서 동일한 자격 증명을 사용합니다. 파일>옵션 및 설정>데이터 원본 설정으로 이동하여 해당 자격 증명을 수정할 수 있습니다.

  6. 탐색기에서 Power BI Desktop에서 가져오고 사용할 하나 이상의 요소를 선택합니다. 그런 다음 로드 를 선택하여 Power BI Desktop에서 테이블을 로드하거나 데이터 변환 을 선택하여 사용하려는 데이터 집합을 필터링 및 구체화할 수 있는 파워 쿼리 편집기를 연 다음, 구체화된 데이터 집합을 Power BI Desktop으로 로드합니다.

파워 쿼리 Online에서 Atlas SQL 인터페이스를 사용하여 MongoDB Atlas 페더레이션 데이터베이스에 연결

Atlas SQL 인터페이스를 사용하여 연결하려면 다음을 수행합니다.

  1. 파워 쿼리 - 데이터 원본 선택 페이지에서 MongoDB Atlas SQL을 선택합니다.

  2. 연결 설정 페이지에서 다음 값을 입력합니다.

    • MongoDB URI입니다. 필수.

      필수 구성 요소에서 가져온 MongoDB URI를 사용합니다. 사용자 이름과 암호가 포함되어 있지 않은지 확인합니다. 사용자 이름 및/또는 암호를 포함하는 URI는 거부됩니다.

    • 페더레이션된 데이터베이스 이름입니다 . 필수

      필수 구성 요소에서 가져온 페더레이션된 데이터베이스의 이름을 사용합니다.

    • 연결 이름을 입력합니다.

    • 데이터 게이트웨이를 선택합니다.

    • Atlas MongoDB 데이터베이스 액세스 사용자 이름 및 암호를 입력하고 다음을 선택합니다.

    연결 설정을 입력하는 온라인 데이터 원본 연결 대화 상자의 스크린샷

  3. 탐색기 화면에서 필요한 데이터를 선택한 다음 데이터 변환을 선택합니다. 이 선택 영역은 사용하려는 데이터 집합을 필터링하고 구체화할 수 있도록 파워 쿼리 편집기를 엽니다.

    변환할 데이터를 선택하는 온라인 탐색기의 스크린샷.

Troubleshooting

연결을 성공적으로 설정할 수 없는 경우 일반 오류 메시지가 The driver returned invalid (or failed to return) SQL_DRIVER_ODBC_VER: 03.80 표시됩니다. 먼저 자격 증명을 확인하고 페더레이션된 데이터베이스에 액세스하는 데 네트워크 문제가 없는지 확인합니다.

다음 정보가 유용할 수도 있습니다.