Learn the "why" behind slow queries and how to fix them in our 2-Part Webinar.
Register now >
Docs Menu
Docs Home
/ /

SQL 인터페이스 드라이버 설정

이 페이지에서는 BI 도구를 Atlas 또는 자체 관리형 EA( Enterprise Advanced ) 데이터베이스 에 연결하기 위한 MongoDB JDBC 또는 ODBC 드라이버를 설치 및 구성하는 방법을 설명합니다.

사용 중인 BI 도구에 적합한 드라이버 찾으려면 아래 표를 참조하세요.

드라이버
BI 도구

JDBC 드라이버

Tableau Desktop 또는 서버 또는 DBeaver, DataGrip 또는 Maven 프로젝트 와 같은 기타 JDBC 지원 도구 .

ODBC 드라이버

Power BI Desktop 또는 Excel과 같은 기타 ODBC 지원 도구.

참고

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

Tableau, DBeaver, DataGrip 및 JDBC API를 허용하는 기타 Java 애플리케이션(예: Maven 프로젝트)을 사용하여 데이터베이스에 연결하려면 MongoDB JDBC드라이버가 필요합니다.

  • MongoDB JDBC 드라이버 다음과 호환됩니다.

    • Windows x86_64

    • macOS x86_64 및 macOS aarch64 아키텍처

    • Linux x86_64 및 Linux arm64 아키텍처

  • 보안 연결을 위해서는 OpenSSL 3.0 이상이 필요합니다.

  • AWS에서 SCRAM-SHA-1, SCRAM-SHA-256, MONGODB-X509MongoDB 비밀번호 없는 인증으로 인증할 수 있습니다.

1

JDBC MongoDB 다운로드 센터에서 최신 드라이버 다운로드.

참고

JDBC 운전자는 두 가지 jar 형식으로 사용할 수 있습니다.

  • mongodb-jdbc-<version>-all.jar 드라이버와 필요한 모든 종속성이 포함되어 있습니다. Tableau 및 DBeaver에 필요합니다.

  • mongodb-jdbc-<version>.jar 번들 종속성이 없는 운전자 포함합니다. JetBrains 도구에 필요합니다.

2

jar 파일을 BI 도구의 적절한 디렉토리에 복사합니다. 예시를 들어 Tableau 용 JDBC 드라이버 설치하는 경우입니다.

  • Windows: C:\Program Files\Tableau\Drivers

  • macOS: ~/Library/Tableau/Drivers

  • Linux: /opt/tableau/tableau_driver/jdbc

3

MongoDB 릴리스 팀은 특정 MongoDB 패키지가 유효하고 수정되지 않았음을 인증하기 위해 모든 소프트웨어 패키지에 디지털 서명을 합니다. MongoDB는 각 릴리스 브랜치를 .asc 형식의 다른 PGP 키로 서명합니다.

  1. 다음 명령을 실행하여 Maven 중앙 리포지토리에서 .asc 파일을 다운로드합니다. <versionNumber>는 다운로드한 드라이버 버전으로 교체하고 <artifactToVerify>는 다운로드한 파일 이름으로 교체하세요.

    curl -O https://repo1.maven.org/maven2/org/mongodb/mongodb-jdbc/<versionNumber>/<artifactToVerify>.asc

    예를 들어 mongodb-jdbc-2.2.3-all.jar를 다운로드한 경우 다음 명령을 실행하면 됩니다.

    curl -O https://repo1.maven.org/maven2/org/mongodb/mongodb-jdbc/2.2.3/mongodb-jdbc-2.2.3-all.jar.asc
  2. 다음 명령을 실행하여 키 파일을 다운로드한 후 가져옵니다. <serverUrl>을 Maven에서 지원하는 현재 GPG 키 서버 중 하나로 바꾸세요.

    • keyserver.ubuntu.com

    • keys.openpgp.org

    • pgp.mit.edu

    gpg --keyserver <serverUrl> --recv-keys BDDC8671F1BE6F4D5464096624A4A8409351E954
    gpg: key BDDC8671F1BE6F4D5464096624A4A8409351E954: public key "MongoDB JDBC Driver Release Signing Key <packaging@mongodb.com>" imported
    gpg: Total number processed: 1
    gpg: imported: 1
  3. 다음 명령을 실행하여 MongoDB JDBC 드라이버 설치 파일 확인합니다. <detachedSignatureFile><artifactToVerify> 을 다운로드한 파일 이름으로 바꿉니다.

    gpg --verify <detachedSignatureFile> <artifactToVerify>

    예를 들어 mongodb-jdbc-2.2.3-all.jarmongodb-jdbc-2.2.3-all.jar.asc를 현재 디렉토리에 다운로드한 경우 다음을 다음을 실행하면 됩니다.

    gpg --verify mongodb-jdbc-2.2.3-all.jar.asc mongodb-jdbc-2.2.3-all.jar

    GPG는 다음과 유사한 응답을 반환해야 합니다.

    gpg: Signature made Wed May 22 13:24:36 2024 MDT
    gpg: using RSA key BDDC8671F1BE6F4D5464096624A4A8409351E954
    gpg: Good signature from "MongoDB JDBC Driver Release Signing Key <packaging@mongodb.com>"

    패키지가 올바르게 서명되었지만 로컬 trustdb에 있는 서명 키를 아직 신뢰하지 않는 경우 gpg는 다음 메시지를 반환합니다.

    gpg: WARNING: This key is not certified with a trusted signature!
    gpg: There is no indication that the signature belongs to the owner.
    Primary key fingerprint: D2C4 5B7E 66A5 DCA1 8B76 57A8 91A2 1577 3066 6110

    다음과 같은 오류 메시지가 나타나면 올바른 공개 키를 가져왔는지 확인합니다.

    gpg: Can't check signature: public key not found

If you use Atlas Data Federation, you can connect the MongoDB JDBC 드라이버 Maven 애플리케이션 과 연결할 수 있습니다.

1

Maven 중앙 리포지토리에서 종속성 스니펫을 복사합니다. 종속성 스니펫의 버전 번호를 JDBC 드라이버 버전과 일치하도록 편집합니다.

예를 들면 다음과 같습니다.

<dependency>
<groupId>org.mongodb</groupId>
<artifactId>mongodb-jdbc</artifactId>
<version>2.1.0</version>
</dependency>
2

프로젝트의 pom.xml 파일에서 다음과 같이 스니펫을 종속성 목록에 붙여넣습니다.

<dependencies>
<dependency>
<groupId>org.mongodb</groupId>
<artifactId>mongodb-jdbc</artifactId>
<version>2.1.0</version>
</dependency>
</dependencies>
3

연합 데이터베이스 인스턴스 에 연결하려면 연결 문자열 만들고 애플리케이션 에서 연결을 엽니다. JDBC 운전자의 연결 문자열은 jdbc: 접두사가 있는 경우를 제외하고 표준 MongoDB 연결 문자열 형식을 따릅니다.

jdbc:mongodb://[username:password]@[host].a.query.mongodb.net/<databaseName>[?option1=value1[&option2=value2]...]

Atlas UI에서 연결 문자열을 가져오려면 다음을 수행하세요.

  1. Atlas UI에서 Data Federation 페이지로 이동하여 연결하려는 페더레이션된 데이터베이스 인스턴스의 Connect를 클릭합니다.

  2. Access your data through tools에서 Atlas SQL을 선택합니다.

  3. Select your driver 아래의 드롭다운에서 JDBC Driver를 선택합니다.

  4. Get Connection String 아래에서 연결하려는 데이터베이스를 선택하고 연결 문자열을 복사합니다.

다음 예시 연결을 여는 방법을 보여줍니다. 연결 문자열 외에도 Properties 객체 매개변수를 통해 사용할 데이터베이스 지정해야 합니다. 자세한 학습 은 연결 문자열연결 속성을 참조하세요.

java.util.Properties p = new java.util.Properties();
p.setProperty("database", "<databaseName>");
Connection conn = DriverManager.getConnection("<connectionString>", p);

참고

드라이버 Atlas 에만 연결할 수 있으며 연합 데이터베이스 인스턴스 에는 연결할 수 없습니다. JDBC 드라이버 에 대한 연결 문자열 의 모든 특수 문자는 URL 인코딩되어야 합니다.

Power BI, Excel 또는 기타 ODBC 지원 BI 도구를 사용하여 데이터베이스 에 연결하려면 MongoDB ODBC 운전자 필요합니다.

시작하려면 배포서버 유형을 선택하세요.

BI 도구에 맞는 드라이버 설치한 후 BI 도구를 데이터베이스 에 연결합니다.

돌아가기

서버 설정

이 페이지의 내용