개요
MongoDB deployment에 연결하려면 다음 두 가지가 필요합니다.
연결할 MongoDB deployment 코틀린 (Kotlin) 운전자 에 알려주는 연결 URI (연결 문자열 이라고도 함)입니다.
MongoDB deployment에 대한 연결을 생성하고 해당 배포에서 작업을 수행할 수 있게 해 주는 MongoClient 객체입니다.
이러한 구성 요소 중 하나를 사용하여 MongoDB 에 연결된 동안 코틀린 (Kotlin) 드라이버 작동하는 방식을 사용자 지정할 수도 있습니다.
이 가이드에서는 연결 string 을 만들고 MongoClient 객체를 사용하여 MongoDB 에 연결하는 방법을 보여 줍니다.
연결 URI
연결 URI는 드라이버가 MongoDB 배포에 연결하는 데 사용하는 일련의 지침을 제공합니다. 이는 MongoDB에 연결하는 방법과 연결된 동안 작동하는 방법에 대해 드라이버에 지시합니다. 다음 그림에서는 샘플 연결 URI의 각 부분을 설명합니다.
이 그림에서는mongodb 프로토콜 에 표준 연결 문자열 형식인 를 사용합니다. mongodb+srv 배포서버 의 유연성을 높이고 클라이언트를 재구성하지 않고도 서버를 교대로 변경할 수 있는 기능 원하는 경우 DNS 시드 목록 연결 형식 을 사용할 수도 있습니다.
참고
배포가 MongoDB Atlas 에 있는 경우, Atlas 드라이버 연결 가이드 를 참조하고 언어 드롭다운에서 Kotlin 를 선택하여 연결 string 을 검색합니다.
비밀번호 기반 인증 메커니즘 을 사용하는 경우 연결 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의 단일 인스턴스 만 필요로 합니다. 최대 연결 수와 같은 모든 리소스 사용량 제한은 개별 MongoClient 인스턴스에 적용 .
의 동작을 제어하는 데 사용할 수 있는 다양한 설정에 MongoClient 대해 학습 MongoClient 설정 가이드 참조하세요.
팁
인스턴스가 더 이상 필요하지 않을 때는 항상 MongoClient.close() 을 호출하여 리소스를 정리하세요.
API 문서
이 섹션에 언급된 메서드 및 클래스에 대한 자세한 내용은 다음 API 문서를 참조하세요.