/ /

설치

Docs Home

SQL 도구를 MongoDB 에 연결

Tableau, Power BI 또는 DBeaver와 같은 SQL 도구를 MongoDB Atlas 또는 EA( Enterprise Advanced ) 데이터베이스 에 연결합니다.

세 가지 SQL 인터페이스 배포서버 옵션은 모두 동일한 JDBC 및 ODBC 드라이버를 사용하므로 Atlas 전용 클러스터, Atlas 연합 데이터베이스 인스턴스 또는 자체 관리형 EA( Enterprise Advanced ) 배포서버 에 연결하든 이 페이지에 설명된 단계는 동일합니다. 먼저 SQL 연결을 수락하도록 배포서버 구성합니다. 방법을 학습 SQL 인터페이스 서버 설정을 참조하세요.

참고

MongoDB JDBC 및 ODBC 드라이버를 통해 Tableau (데스크톱, 서버 또는 클라우드) 및 Power BI Desktop(데스크톱 및 서비스)을 공식 지원합니다.JDBC 및 ODBC 드라이버를 다른 SQL-92 호환 도구와 함께 사용할 수 있지만, MongoDB 호환성을 보장할 수 없습니다. 특정 SQL 인터페이스 기능을 테스트하여 지원 확인합니다.

Tableau 연결

MongoDB 용 Tableau Connector를 사용하여 Atlas 전용 클러스터, Atlas 연합 데이터베이스 인스턴스 또는 자체 호스팅 EA( Enterprise Advanced ) 데이터베이스 Tableau (데스크톱 또는 서버)에 연결합니다.

전제 조건

SQL 인터페이스용으로 구성된MongoDB database :
- Atlas 전용 클러스터 또는 자체 관리형 Enterprise Advanced (EA) 배포서버 MongoDB 6.0 이상 실행 해야 합니다.
- Atlas 연합 데이터베이스 인스턴스 하나 이상의 데이터 저장소에 매핑되어야 하며, 읽는 각 Atlas cluster 는 MongoDB 5.0 이상을 실행 해야 합니다. 자세한 학습 은 연합 데이터베이스 인스턴스 배포를 참조하세요.

MongoDB JDBC 운전자. 설치하려면 SQL 인터페이스 드라이버 설정을 참조하세요.
Tableau Desktop, 서버 또는 클라우드. Tableau Server에는SCRAM 인증 선호되며, X.509 인증 도 지원됩니다. Tableau Cloud는 SCRAM 인증 만 지원합니다. 지원되는 인증 메커니즘에 대해 자세히 학습 SQL 인터페이스 인증을 참조하세요.

절차

다음 단계에서는 Tableau 사용하여 MongoDB 에 연결하는 방법을 보여 줍니다.

MongoDB 용 Tableau Connector를 다운로드합니다.

참고

Tableau Desktop 및 Tableau Server 버전 2025 이상은 MongoDB 용 Tableau Connector를 번들로 제공합니다. 사용 중인 Tableau 버전에 이미 connector 포함되어 있는 경우 이 단계를 건너뜁니다. Tableau 에 번들로 제공되는 버전이 아닌 다른 버전을 사용하려면 이 단계를 완료하세요.

Tableau Desktop의 경우 Tableau 에서 connector 설치할 수도 있습니다. Tableau Exchange에서 MongoDB SQL interface by MongoDB을 검색한 다음 Install and restart Tableau을 클릭합니다.

MongoDB 다운로드센터에서 최신 Tableau Connector taco 파일 다운로드합니다.
taco 파일 운영 체제에 적합한 디렉토리 로 이동합니다.
- Windows: C:\Users\<user>\Documents\My Tableau Repository\Connectors
- MacOS: ~/Documents/My Tableau Repository/Connectors
- Linux: /opt/tableau/connectors

중요

MongoDB 용 Tableau Connector의 새 버전을 다운로드 경우 Connectors 디렉토리 에서 이전 taco 파일 삭제 Tableau 최신 버전을 사용하도록 합니다.

MongoDB database 연결 정보를 가져옵니다.

연결 정보를 가져오는 방법에 대한 지침을 보려면 배포서버 유형에 해당하는 탭 선택하세요.

프로젝트 의 Atlas 전용 클러스터 또는 연합 데이터베이스 인스턴스 로 고 (Go) .
Connect를 클릭합니다.
Atlas SQL Interface 옵션을 선택합니다.
Select your driver 드롭다운에서 Tableau Connector 옵션을 선택합니다.
드롭다운 메뉴에서 Tableau 을(를) 선택합니다.
Database 드롭다운에서 연결하려는 데이터베이스 선택합니다.
연결 문자열 과 연결 매개변수를 복사합니다.
이 정보를 사용하여 이후 단계에서 Tableau 에 연결할 수 있습니다.

MongoDB Java 운전자 와 호환되는 연결 문자열 사용합니다. 자세히 학습 연결 URI를 참조하세요.

Tableau Desktop 또는 Tableau Server를 엽니다.

Connect 메뉴로 고 (Go) .

MongoDB SQL Interface by MongoDB을(를) 선택합니다.

연결 모달이 표시됩니다.

데이터베이스 연결 정보를 입력합니다.

이전 단계에서 저장한 SQL 인터페이스 연결 문자열 입력합니다.

인증 방법을 선택합니다.

드롭다운에서 Authentication Mechanism 을(를) 선택합니다.

지원되는 모든 인증 메커니즘에 대한 자세한 내용은 SQL 인터페이스 인증을 참조하세요.

Username: MongoDB 사용자 이름 입력합니다.
Password: MongoDB 비밀번호를 입력합니다.

다음 방법 중 하나를 사용하여 PEM 인증서를 구성합니다.

PEM 파일 경로 사용:

mongodb_jdbc.properties 파일 에서 x509pempath 속성 PEM 파일의 경로로 설정하다 . 예시: x509pempath=/certs/client-cert.pem.
- PEM 파일이 암호화되지 않은 경우 Provide PEM Contents를 선택하지 마세요. 추가 조치 는 필요하지 않습니다.
- PEM 파일이 암호화됨 경우 Provide PEM Contents 을(를) 선택하고 Password 필드에 파일의 암호를 입력합니다.
PEM 콘텐츠 제공:

Provide PEM Contents 옆의 확인란을 선택하고 Password 필드 에 인증서 데이터를 입력합니다.
- 암호화되지 않은 콘텐츠: 전체 인증서 콘텐츠를 필드에 직접 붙여넣습니다.
- 암호화된 콘텐츠: 콘텐츠와 암호가 포함된 JSON 객체 붙여넣습니다.
  { "pem": "<PEM-CONTENT>", "passphrase": "<PEM-PASSPHRASE>" }

Username 필드 에 Kerberos 주체 이름을 입력합니다. 예시: user@EXAMPLE.COM.

OIDC의 연결 대화 상자에는 추가 속성이나 필드가 필요하지 않습니다.

Sign In를 클릭합니다.

Tableau 로깅 구성

MongoDB JDBC 운전자 의 로깅 구성을 변경하려면 mongodb_jdbc.properties 파일 에 로깅 속성을 추가합니다. 이 파일 의 위치 플랫폼에 따라 다릅니다.

플랫폼	경로
macOS	`~/Documents/My Tableau Repository/Datasources/mongodb_jdbc.properties` `~/Documents/My Tableau Prep Repository/Datasources/mongodb_jdbc.properties`
Windows	`C:\Users\<username>\Documents\My Tableau Repository\Datasources\mongodb_jdbc.properties` `C:\Users\<username>\Documents\My Tableau Prep Repository\Datasources\mongodb_jdbc.properties`
Tableau Server(RHEL)	`/var/opt/tableau/tableau_server/data/tabsvc/vizqlserver/Datasources/mongodb_jdbc.properties` 이 파일 모든 서버 노드에 복사합니다.

로깅을 구성하려면 파일 에 다음 속성을 추가합니다.

loglevel=INFO
logdir=<path-to-log-directory>

loglevel 속성 운전자 로그의 상세도를 설정합니다. OFF, SEVERE, WARNING, INFO, FINE, FINER과 같은 값을 상세도가 높아지는 순서로 허용합니다. 기본값 은 OFF입니다.

logdir 속성 운전자 로그 파일을 작성하는 디렉토리 를 설정합니다. 디렉토리 이미 존재해야 합니다. logdir를 생략하거나 console로 설정하다 하면 운전자 파일 대신 콘솔에 로그를 기록합니다.

중요

프로덕션 환경에서는 SEVERE 로그 수준으로 시작합니다. 각 수준에는 많은 양의 출력이 추가되므로 문제를 진단해야 하는 경우에만 수준을 올립니다. FINER 수준에서 운전자 각 결과 설정하다 의 각 셀에 대한 데이터를 검색하는 모든 호출을 기록합니다.

Tableau 의 속성 파일에 대해 자세히 학습 Tableau 설명서를 참조하세요.

Power BI 연결

MongoDB 용 Power BI Connector 사용하여 Atlas 전용 클러스터, Atlas 연합 데이터베이스 인스턴스 또는 자체 호스팅 EA( Enterprise Advanced ) 데이터베이스 Power BI 에 연결합니다.

전제 조건

SQL 인터페이스용으로 구성된MongoDB database :
- Atlas 전용 클러스터 또는 자체 관리형 Enterprise Advanced (EA) 배포서버 MongoDB 6.0 이상 실행 해야 합니다.
- Atlas 연합 데이터베이스 인스턴스 하나 이상의 데이터 저장소에 매핑되어야 하며, 읽는 각 Atlas cluster 는 MongoDB 5.0 이상을 실행 해야 합니다. 자세한 학습 은 연합 데이터베이스 인스턴스 배포를 참조하세요.

MongoDB ODBC 운전자. 설치하려면 SQL 인터페이스 드라이버 설정을 참조하세요.다이렉트 쿼리를 사용하려면 1.2 버전 이상을 설치해야 합니다.
Power BI Desktop 64 비트. Microsoft 매월 Power BI 업데이트 및 릴리스하며, Atlas 최신 버전의 Power BI Desktop만 지원합니다.
Windows 운영 체제. Power BI Desktop이 지원하는 Windows OS 버전을 학습하려면 Microsoft 설명서를 참조하세요.

절차

다음 단계에서는 Power BI 사용하여 MongoDB 에 연결하는 방법을 보여줍니다.

MongoDB 용 Power BI Connector 다운로드.

MongoDB 다운로드 센터에서 최신 Power BI Connector pqx 파일 다운로드합니다.
참고
MongoDB 용 Power BI Connector Power BI Desktop과 함께 제공됩니다. 사용 중인 Power BI Desktop 버전에 이미 MongoDB Atlas SQL connector 있는 경우 이 단계를 건너뛰세요. Power BI Desktop에 번들로 제공되는 버전이 아닌 다른 버전을 사용하려면 이 단계를 완료하세요.
connector 파일 다음 디렉토리 경로로 이동합니다.
C:\Users\<user>\Documents\Power BI Desktop\Custom Connectors.
이 폴더가 아직 없는 경우 생성합니다.

MongoDB database 연결 정보를 가져옵니다.

연결 정보를 가져오는 방법에 대한 지침을 보려면 배포서버 유형에 해당하는 탭 선택하세요.

프로젝트 의 Atlas 전용 클러스터 또는 연합 데이터베이스 인스턴스 로 고 (Go) .
Connect 버튼을 클릭합니다.
Atlas SQL Interface 옵션을 선택합니다.
Select your driver 드롭다운에서 Power BI Connector 옵션을 선택합니다.
연결 문자열을 복사합니다.
이 정보를 사용하여 이후 단계에서 Power BI 와 연결합니다.

MongoDB deployment URI를 사용합니다. 자세한 학습 은 연결 문자열을 참조하세요.

Power BI Desktop에서 연결합니다.

Power BI Desktop을 엽니다.
Home 메뉴에서 Get data 을 선택합니다.
MongoDB Atlas SQL 커넥터를 찾아 선택합니다.
1. 검색창에 mongo 을 입력하여 새 커넥터를 찾습니다.
2. MongoDB Atlas SQL0}을 선택합니다.
3. Connect를 클릭합니다.
URI와 데이터베이스 이름을 입력하고 OK을 클릭합니다.
MongoDB URI은 이전 단계에서 복사한 연결 문자열 입니다.
Native query 필드 에 선택적으로 SQL 쿼리 입력할 수 있습니다. Power BI SQL 쿼리 데이터의 직접 소스로 사용합니다. 연결 후 파워 쿼리 편집기에서 SQL 쿼리 추가하거나 변경할 수도 있습니다.
Atlas User name, Password을 입력하고 Connect를 클릭합니다.
기본값 으로 사용자는 자신의 역할 및 연결 URI가 허용하는 모든 네임스페이스 액세스 할 수 있습니다. 사용자 지정 역할을 사용하여 액세스 제한하는 경우 Edit User 메뉴에서 사용자에게 추가 네임스페이스에 대한 액세스 부여할 수 있습니다.자세한 학습 은 데이터베이스 사용자 구성을 참조하세요.
지원되는 다른 인증 메커니즘에 대한 자세한 내용은 SQL 인터페이스 인증을 참조하세요.

Direct Query

다이렉트 쿼리는 MongoDB 용 Power BI Connector 버전 1.2 이상에서 사용할 수 있는 연결 모드 입니다. 다이렉트 쿼리를 사용하려면 MongoDB ODBC 드라이버 버전 1.2 이상을 설치해야 합니다. DSN을 구성할 필요가 없습니다.

직접 쿼리는 표준 가져오기 모드의 대안으로, 데이터베이스 를 직접 쿼리 할 수 있습니다. 이렇게 하면 최신 데이터가 보장 결과를 반환하는 데 시간이 더 걸릴 수 있습니다.

직접 쿼리 일부 작업을 지원 하지 않습니다. 지원되지 않는 조치 수행하려고 하면 가져오기 모드로 전환하라는 Power BI 메시지가 표시됩니다.

DBeaver 연결

MongoDB JDBC 드라이버 사용하여 Atlas 전용 클러스터, Atlas 연합 데이터베이스 인스턴스 또는 자체 관리 EA( Enterprise Advanced ) 배포서버 DBeaver에 연결합니다.

전제 조건

SQL 인터페이스용으로 구성된MongoDB database :
- Atlas 전용 클러스터 또는 자체 관리형 Enterprise Advanced (EA) 배포서버 MongoDB 6.0 이상 실행 해야 합니다.
- Atlas 연합 데이터베이스 인스턴스 하나 이상의 데이터 저장소에 매핑되어야 하며, 읽는 각 Atlas cluster 는 MongoDB 5.0 이상을 실행 해야 합니다. 자세한 학습 은 연합 데이터베이스 인스턴스 배포를 참조하세요.

DBeaver (커뮤니티 에디션).
MongoDB JDBC 운전자. 설치하려면 SQL 인터페이스 드라이버 설정을 참조하세요.

절차

DBeaver에서 연결하려면 다음을 수행합니다.

MongoDB database 연결 정보를 가져옵니다.

연결 정보를 가져오는 방법에 대한 지침을 보려면 배포서버 유형에 해당하는 탭 선택하세요.

프로젝트 의 Atlas 전용 클러스터 또는 연합 데이터베이스 인스턴스 로 고 (Go) .
Connect 버튼을 클릭합니다.
Atlas SQL Interface 옵션을 선택합니다.
Select your driver 드롭다운에서 JDBC Driver 옵션을 선택합니다.
Database 드롭다운에서 연결하려는 데이터베이스 선택합니다.
연결 문자열을 복사합니다.
이 정보를 사용하여 이후 단계에서 DBeaver와 연결합니다.

MongoDB Java 운전자 와 호환되는 연결 문자열 사용합니다. 자세히 학습 연결 URI를 참조하세요.

DBeaver 애플리케이션 엽니다.

DBeaver에 드라이버 추가합니다.

DBeaver에서 Database 을 클릭하고 드롭다운 메뉴에서 Driver Manager 을 선택합니다.
New 0}을 클릭하여 Create new driver 모달을 엽니다.
Settings 탭 에서 다음 정보를 지정합니다.
드라이버 이름
MongoSQL
클래스 이름
com.mongodb.jdbc.MongoDriver
Libraries Add File 0} 탭에서 을 클릭하고 JDBC 드라이버 all.jar 파일을 추가합니다.
Find Class를 클릭합니다.
OK를 클릭합니다. Create new driver 모달이 닫힙니다.

데이터베이스 연결을 만듭니다.

DBeaver에서 Database 을 클릭하고 드롭다운 메뉴에서 New Database Connection 을 선택하여 Connect to a database 모달을 엽니다.
데이터베이스 목록에서 이전 단계에서 생성한 MongoDB 데이터베이스 드라이버를 선택합니다.
0}이 표시되지 않으면 모달 MongoDB 내에서 카테고리를 선택합니다.All
Next를 클릭합니다.

Main 0} 탭에 다음 정보를 입력합니다.

JDBC URL	이전 단계에서 가져온 연결 문자열입니다.
사용자 이름	연결에 대한 권한이 부여된 MongoDB 사용자입니다.
비밀번호	MongoDB 사용자와 연결된 비밀번호입니다.

Driver properties User Properties0} 탭에서 을 펼칩니다. 다음 키-값 속성을 추가합니다.
database
가상 데이터베이스의 이름입니다.
사용자
연결할 MongoDB 사용자입니다. 이전 단계에서 Username을 입력한 경우에는 필요하지 않습니다.

다음 단계

SQL 도구를 MongoDB database 에 연결한 후 데이터를 쿼리 할 수 있습니다. 자세한 학습 은 다음을 참조하세요.

참고

비공개 엔드포인트를 사용하여 연결하려면 비공개 엔드포인트로 MongoDB SQL 인터페이스에 연결을 참조하세요.

돌아가기

드라이버 설정

쿼리

드라이버 이름	`MongoSQL`
클래스 이름	`com.mongodb.jdbc.MongoDriver`

database	가상 데이터베이스의 이름입니다.
사용자	연결할 MongoDB 사용자입니다. 이전 단계에서 `Username`을 입력한 경우에는 필요하지 않습니다.