/ /

설치

Docs Home

SQL 도구를 MongoDB에 연결

Connect your SQL tool, such as Tableau, Power BI, or DBeaver to your MongoDB Atlas or Enterprise Advanced (EA) database.

All three SQL Interface deployment options use the same JDBC and ODBC drivers, so the steps on this page are the same whether you connect to an Atlas dedicated cluster, an Atlas federated database instance, or a self-managed Enterprise Advanced (EA) deployment. Configure your deployment to accept SQL connections first. To learn how, see SQL Interface Server Setup.

참고

MongoDB officially supports Tableau (Desktop, Server, or Cloud) and Power BI Desktop (Desktop and Service) with its JDBC and ODBC drivers. You can use the JDBC and ODBC drivers with other SQL-92 compatible tools, but MongoDB cannot guarantee compatibility. Test your specific SQL Interface features to confirm support.

Tableau 연결

Connect an Atlas dedicated cluster, an Atlas federated database instance, or a self-hosted Enterprise Advanced (EA) database to Tableau (Desktop or Server) using the Tableau Connector for MongoDB.

전제 조건

SQL 인터페이스용으로 구성된: MongoDB 데이터베이스
- An Atlas dedicated cluster or a self-managed Enterprise Advanced (EA) deployment must run MongoDB 6.0 or later.
- An Atlas federated database instance must be mapped to one or more data stores, and each Atlas cluster that it reads from must run MongoDB 5.0 or later. To learn more, see Deploy a Federated Database Instance.

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

절차

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

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

참고

Tableau Desktop 및 Tableau 서버 버전 2025 이상에는 MongoDB용 Connector가 번들로 제공됩니다. 사용 중인 Tableau 버전에 이미 커넥터가 포함되어 있으면 이 단계를 건너뛰세요. Tableau와 함께 번들로 제공되는 버전이 아닌 다른 버전을 사용하려면 이 단계를 완료하세요.

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

Download the latest Tableau Connector taco file from the MongoDB download center.
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 연결 정보를 가져옵니다.

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

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

Tableau Desktop 또는 Tableau Server를 엽니다.

Connect 메뉴로 고 (Go) .

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

연결 모달이 표시됩니다.

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

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

다음의 연결 문자열을 입력하세요:

mongodb://localhost:<port>/?authSource=admin

<port>을( 를) SQL Interface 서버에서 수신하도록 구성된 포트 번호로 대체합니다.

authSource 매개변수는 MongoDB 사용자 인증에 사용되는 데이터베이스를 지정합니다. authSource을(를) 생략하면 Database 필드에 지정된 데이터베이스가 인증에 사용됩니다.

Database 필드에서 쿼리하려는 MongoDB 데이터베이스의 이름을 입력합니다.

인증 방법을 선택합니다.

드롭다운에서 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.

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 서버 (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 속성은 드라이버가 로그 파일을 쓰기 (write) 디렉토리를 설정합니다. 디렉토리가 이미 존재해야 합니다. logdir을(를) 생략하거나 console(으)로 설정하면 드라이버가 파일에 쓰기 (write)를 하는 대신 콘솔에 로그를 씁니다.

중요

프로덕션 환경에서는 SEVERE 로그 수준으로 시작합니다. 각 수준마다 많은 양의 출력이 추가되므로 문제를 진단해야 할 때만 수준을 높이십시오. FINER 수준에서 드라이버는 각 결과 세트의 각 셀에 대한 데이터를 조회하는 모든 호출을 기록합니다.

Tableau의 속성 파일에 대해 자세히 학습하려면 Tableau 설명서를 참조하십시오.

Power BI 연결

Connect an Atlas dedicated cluster, an Atlas federated database instance, or a self-hosted Enterprise Advanced (EA) database to Power BI using the Power BI Connector for MongoDB.

전제 조건

SQL 인터페이스용으로 구성된: MongoDB 데이터베이스
- An Atlas dedicated cluster or a self-managed Enterprise Advanced (EA) deployment must run MongoDB 6.0 or later.
- An Atlas federated database instance must be mapped to one or more data stores, and each Atlas cluster that it reads from must run MongoDB 5.0 or later. To learn more, see Deploy a Federated Database Instance.

MongoDB ODBC 운전자. 설치하려면 SQL 인터페이스 드라이버 설정을 참조하세요. 다이렉트 쿼리를 사용하려면 1.2 버전 이상을 설치해야 합니다.
Power BI 데스크톱 64비트. Microsoft는 매월 Power BI를 업데이트 및 출시하며, Atlas는 최신 버전의 Power BI 데스크톱만 지원합니다.
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 연결 정보를 가져옵니다.

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

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

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 쿼리를 데이터의 직접 소스로 사용합니다. 연결 후 Power Query 편집기에서 SQL 쿼리를 추가하거나 변경할 수도 있습니다.
Atlas User name, Password을 입력하고 Connect를 클릭합니다.
By default, users can access all namespaces that their roles and connection URI permit. If you use custom roles to restrict access, you can grant users access to additional namespaces in the Edit User menu. To learn more, see Configure Database Users.
지원되는 다른 인증 메커니즘에 대한 자세한 내용은 SQL 인터페이스 인증을 참조하세요.

Direct Query

Direct Query is a connection mode available with the Power BI Connector for MongoDB version 1.2 and later. To use Direct Query, you must install MongoDB ODBC Driver version 1.2 or later. You don't need to configure a DSN.

Direct Query는 표준 가져오기 모드 대신 사용할 수 있으며, 데이터베이스를 직접 쿼리할 수 있습니다. 이 방식은 최신 데이터를 보장하지만 결과를 반환하는 데 시간이 더 오래 걸릴 수 있습니다.

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

DBeaver 연결

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

전제 조건

SQL 인터페이스용으로 구성된: MongoDB 데이터베이스
- An Atlas dedicated cluster or a self-managed Enterprise Advanced (EA) deployment must run MongoDB 6.0 or later.
- An Atlas federated database instance must be mapped to one or more data stores, and each Atlas cluster that it reads from must run MongoDB 5.0 or later. To learn more, see Deploy a Federated Database Instance.

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

절차

DBeaver에서 연결하려면:

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

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

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

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 데이터베이스에 연결한 후 데이터를 쿼리할 수 있습니다. 자세한 내용은 다음을 참조하세요.

참고

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

돌아가기

드라이버 설정

쿼리

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

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