Docs Menu
Docs Home
/
MongoDB Atlas
/ / /

자바 데이터베이스 접속성(JDBC, Java Database Connectivity) 드라이버로 연결합니다.

이 페이지의 내용

  • 지원되는 인증 메커니즘
  • 전제 조건
  • 절차

본 페이지에서는 연합 데이터베이스 인스턴스에 연결하기 위한 MongoDB 자바 데이터베이스 접속성(JDBC, Java Database Connectivity) 드라이버를 설치 및 구성하는 방식에 대해 설명합니다.

SCRAM-SHA-1, SCRAM-SHA-256, MONGODB-X509, AWS를 통한 MongoDB 암호 없는 인증을 사용해 인증할 수 있습니다.

  • 하나 이상의 데이터 저장소에 매핑된 연합 데이터베이스 인스턴스입니다.

    참고

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

  • JDBC 드라이버를 사용하여 연합 데이터베이스 인스턴스에 연결하려는 애플리케이션 또는 BI 도구입니다.

  • MongoDB JDBC Driver

JDBC 드라이버를 사용해 Maven 프로젝트처럼 JDBCAPI를 허용하는 SQL 기반 Java 애플리케이션에 연결할 수 있습니다.

1
2

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

  1. 다음 명령을 실행하여 Maven 중앙 리포지토리에서 .asc 파일을 다운로드합니다.

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

    • keyserver.ubuntu.com

    • keys.openpgp.org

    • pgp.mit.edu

    gpg --keyserver {server_url} --recv-keys 91A2157730666110
    gpg: key 91A2157730666110: public key "Huan Li <huan.li@10gen.com>" imported
    gpg: Total number processed: 1
    gpg: imported: 1
  3. 다음 명령을 실행하여 MongoDB JDBC 드라이버 설치 파일을 확인합니다.

    gpg --verify mongodb-jdbc-2.1.2.jar.asc mongodb-jdbc-2.1.2.jar

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

    gpg: Signature made Wed May 22 13:24:36 2024 MDT
    gpg: using RSA key 91A2157730666110
    gpg: Good signature from "Huan Li <huan.li@10gen.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
1

Maven 애플리케이션과 연결하려면 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에서 연결 문자열을 가져올 수 있습니다. 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);

참고

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

돌아가기

MongoDB Shell