MongoClient 만들기

개요

MongoDB deployment에 연결하려면 다음 두 가지가 필요합니다.

• 연결할 MongoDB 배포서버 코틀린 (Kotlin) 드라이버 에 알려주는 연결 URI (연결 문자열 이라고도 함)입니다.

• MongoDB deployment에 대한 연결을 생성하고 해당 배포에서 작업을 수행할 수 있게 해 주는 MongoClient 객체입니다.

이러한 구성 요소 중 하나를 사용하여 MongoDB 에 연결된 동안 코틀린 (Kotlin) 드라이버 작동하는 방식을 사용자 지정할 수도 있습니다.

이 가이드에서는 연결 string 을 만들고 MongoClient 객체를 사용하여 MongoDB 에 연결하는 방법을 보여 줍니다.

연결 URI

연결 URI는 드라이버가 MongoDB 배포에 연결하는 데 사용하는 일련의 지침을 제공합니다. 이는 MongoDB에 연결하는 방법과 연결된 동안 작동하는 방법에 대해 드라이버에 지시합니다. 다음 그림에서는 샘플 연결 URI의 각 부분을 설명합니다.

This figure uses the Standard Connection String Format, mongodb for the protocol. You can also use the DNS Seed List Connection Format, mongodb+srv, if you want more flexibility of deployment and the ability to change the servers in rotation without reconfiguring clients.

비밀번호 기반 인증 메커니즘 을 사용하는 경우 연결 URI의 다음 부분에는 자격 증명 이 포함됩니다. user 값을 데이터베이스 사용자 이름 으로 바꾸고 pass 값을 데이터베이스 사용자 비밀번호로 바꿉니다. 인증 메커니즘 에 자격 증명 이 필요하지 않은 경우 연결 URI에서 이 부분을 생략합니다.

연결 URI의 다음 부분은 호스트 이름 또는 IP 주소를 지정하고 그 뒤에 MongoDB 인스턴스의 포트를 지정합니다. 이 예에서 sample.host 은 호스트 이름을 나타내고 27017 은 포트 번호입니다. 이 값을 MongoDB 인스턴스의 포인트 정보로 바꿉니다.

연결 URI의 마지막 부분에는 연결 옵션이 매개 변수로 포함되어 있습니다. 이 예시 에서는 maxPoolSize=20 및 w=majority라는 두 가지 연결 옵션을 설정하다 . 연결 옵션에 대한 자세한 내용은 연결 옵션 가이드를 참조하세요.

몽고클라이언트

MongoClient 클래스를 사용하여 MongoDB 에 연결하고 통신할 수 있습니다.

MongoClient.create() 0} 메서드를 사용하여 을 MongoClient 구성합니다.

다음 코드는 로컬 MongoDB 배포서버에 연결하는 MongoClient 를 만드는 방법을 보여줍니다.

import com.mongodb.kotlin.client.coroutine.MongoClient
val uri = "mongodb://localhost:27017/"
val client = MongoClient.create(uri)

MongoClient의 동작을 제어하는 데 사용할 수 있는 다양한 설정에 대해 학습하려면 MongoClient 설정 가이드를 참조하세요.

API 문서

이 섹션에 언급된 메서드 및 클래스에 대한 자세한 내용은 다음 API 문서를 참조하세요.

• 몽고클라이언트

• create()