문서 메뉴

문서 홈애플리케이션 개발MongoDB 드라이버

MongoDB 스칼라 드라이버

이 페이지의 내용

  • 서론
  • 설치
  • MongoDB Atlas에 연결
  • 스테이블 API 없이 MongoDB Atlas에 연결하기
  • 로컬 기계에서 MongoDB Server에 연결하기
  • 호환성

공식 MongoDB Scala 드라이버의 설명서 사이트에 오신 것을 환영합니다. 애플리케이션에 드라이버를 추가하여 스칼라에서 MongoDB와 비동기적으로 작동하도록 할 수 있습니다.sbt 을(를) 사용하여 다운로드합니다. 또는 Apache Maven 또는 튜토리얼을 따라 실행 가능한 프로젝트를 설정하세요.

프로젝트에서 드라이버 사용을 시작하는 데 권장되는 방법은 sbt 또는 maven 와 같은 종속성 관리 시스템을 사용하는 것입니다. 설치 가이드 참조 을(를) 참조하세요.

다음 연결 스니펫을 사용하여 Atlas에서 MongoDB deployment에 대한 연결을 테스트할 수 있습니다.

import com.mongodb.{ServerApi, ServerApiVersion}
import org.mongodb.scala.{ConnectionString, MongoClient, MongoClientSettings}
import org.mongodb.scala.bson.Document
import scala.concurrent.Await
import scala.concurrent.duration.DurationInt
import scala.util.Using
object MongoClientConnectionExample {
def main(args: Array[String]): Unit = {
// Replace the placeholder with your Atlas connection string
val connectionString = "<connection string>";
// Construct a ServerApi instance using the ServerApi.builder() method
val serverApi = ServerApi.builder.version(ServerApiVersion.V1).build()
val settings = MongoClientSettings
.builder()
.applyConnectionString(ConnectionString(connectionString))
.serverApi(serverApi)
.build()
// Create a new client and connect to the server
Using(MongoClient(settings)) { mongoClient =>
// Send a ping to confirm a successful connection
val database = mongoClient.getDatabase("admin")
val ping = database.runCommand(Document("ping" -> 1)).head()
Await.result(ping, 10.seconds)
System.out.println("Pinged your deployment. You successfully connected to MongoDB!")
}
}
}

연결 스니펫은 스테이블 API(Stable API) 기능을 사용합니다. 이 기능은 스칼라 드라이버 v4.3 이상 사용 시 활성화할 수 있으며 MongoDB Server v5.0 이상에 연결할 수 있습니다. 이 기능을 사용하면 스테이블 API에서 다루는 모든 명령의 하위 호환성 문제에 대한 걱정 없이 드라이버나 서버를 업데이트할 수 있습니다.

Stable API 기능에 대해 자세히 알아보려면 서버 매뉴얼의 Stable API 를 참조하세요.

참고

2022년 2월부터 버전이 지정된 APIStable API로 표시됩니다. 이름은 변경되나 모든 개념과 기능은 동일하게 유지됩니다.

Stable API 기능에 대한 지원이 없는 MongoDB 버전 또는 드라이버를 사용하는 경우, 다음 코드 스니펫을 사용하여 Atlas에서 MongoDB 배포에 대한 연결을 테스트할 수 있습니다.

import org.mongodb.scala.MongoClient
import org.mongodb.scala.bson.Document
import scala.concurrent.Await
import scala.concurrent.duration.DurationInt
import scala.util.Using
object MongoClientConnectionExample {
def main(args: Array[String]): Unit = {
// Replace the placeholder with your Atlas connection string
val connectionString = "<connection string>";
// Create a new client and connect to the server
Using(MongoClient(connectionString)) { mongoClient =>
// Send a ping to confirm a successful connection
val database = mongoClient.getDatabase("admin")
val ping = database.runCommand(Document("ping" -> 1)).head()
Await.result(ping, 10.seconds)
System.out.println("Pinged your deployment. You successfully connected to MongoDB!")
}
}
}

Atlas cluster를 사용하는 대신 개발 목적으로 로컬 컴퓨터에서 MongoDB 서버를 실행해야 하는 경우, 다음을 완료해야 합니다:

  1. MongoDB Server의 Community 또는 Enterprise 버전을 다운로드합니다.

  2. MongoDB Server 를 설치하고 구성합니다 .

  3. 서버를 시작합니다.

중요

항상 악의적인 공격으로부터 MongoDB 서버를 보호하세요. 보안 체크 리스트에서 보안 권장 사항 목록을 확인하세요.

MongoDB Server를 성공적으로 시작한 후에는 드라이버 연결 코드에 연결 문자열을 지정하세요.

MongoDB Server가 로컬에서 실행되는 경우 연결 문자열("mongodb://localhost:<port>")을 사용할 수 있습니다. 여기서 <port>는 서버가 들어오는 연결을 수신하도록 구성한 포트 번호입니다.

다른 호스트 이름이나 IP 주소를 지정해야 하는 경우 연결 문자열에 대한 서버 매뉴얼 항목을 참조하세요.

서버에 연결할 수 있는지 테스트하려면 MongoDB Atlas 에 연결 코드 예제에서 연결 문자열을 바꾸고 실행하세요.

다음 호환성 표는 MongoDB의 특정 버전과 함께 사용할 수 있는 Mongo 스칼라 드라이버의 권장 버전을 명시합니다.

첫 번째 열에는 드라이버 버전이 나열됩니다.

중요

MongoDB는 서버 버전의 수명 종료(EOL) 날짜 이후 3년 동안 MongoDB Server와 드라이버 간의 호환성을 보장합니다. MongoDB 릴리스 및 EOL 날짜에 대한 자세한 내용은 MongoDB 소프트웨어 수명 주기 일정을 참조하세요.

아이콘
설명
모든 기능이 지원됩니다.
드라이버 버전은 MongoDB 버전에서 작동하지만 모든 새로운 MongoDB 기능이 지원되는 것은 아닙니다.
표시 없음
드라이버 버전은 MongoDB 버전과 함께 테스트되지 않습니다.
스칼라 드라이버 버전
MongoDB 7.0
MongoDB 6.1
MongoDB 6.0
MongoDB 5.0
MongoDB 4.4
MongoDB 4.2
MongoDB 4.0
몽고DB 3.6
MongoDB 3.4
MongoDB 3.2
MongoDB 3.0
MongoDB 2.6
4.11
4.10
4.9
4.8
4.7
4.6
4.5
4.4
4.3
4.2
4.1
4.0
2.9
2.8
2.7
2.6
2.5
2.4
2.3
2.2
2.1
2.0
1.2
1.1
1.0

이 드라이버는 이전 버전의 MongoDB를 지원하지 않습니다.

다음 호환성 표는 스칼라의 특정 버전과 함께 사용할 수 있는 Mongo 스칼라 드라이버의 권장 버전을 명시합니다.

첫 번째 열에는 드라이버 버전이 나열됩니다.

스칼라 드라이버 버전
스칼라 2.13
Scala 2.12
Scala 2.11
4.11
4.10
4.9
4.8
4.7
4.6
4.5
4.4
4.3
4.2
4.1
2.9
2.8
2.7
2.6
2.5
2.4
2.3
2.2
2.1
2.0
1.2
1.1
1.0

호환성 표를 읽는 방법에 대한 자세한 내용은 MongoDB 호환성 표에 대한 가이드를 참조하세요.

← MongoDB 루비 드라이버