데이터베이스 및 컬렉션

개요

이 가이드 에서는 코틀린 동기 (Kotlin Sync) 운전자 로 MongoDB 데이터베이스 및 컬렉션을 사용하는 방법을 학습 수 있습니다.

MongoDB는 데이터를 다음 수준의 계층 구조로 구성합니다.

데이터베이스: 컬렉션을 저장 하는 MongoDB deployment 의 최상위 데이터 구조입니다.
컬렉션: MongoDB 문서 그룹입니다. 관계형 데이터베이스의 테이블과 유사합니다.
문서: string, 숫자, 날짜 및 기타 내장된 문서와 같은 리터럴 데이터를 저장 하는 단위입니다. 문서 필드 유형 및 구조에 대한 자세한 내용은 MongoDB Server 매뉴얼의 문서 가이드 를 참조하세요.

데이터베이스에 액세스

데이터베이스 액세스 하려면 데이터베이스 이름을 getDatabase() 메서드에 전달합니다.

다음 예제에서는 test_database 데이터베이스에 액세스합니다.

val db = client.getDatabase("test_database")

컬렉션에 액세스

컬렉션 에 액세스 하려면 데이터베이스 이름을 getCollection() 메서드에 전달합니다.

다음 예시 test_collection이라는 컬렉션 에 액세스합니다.

val collection = db.getCollection("test_collection")

팁

제공된 컬렉션 이름이 데이터베이스에 아직 존재하지 않는 경우, MongoDB는 데이터를 처음 삽입할 때 컬렉션을 암시적으로 생성합니다.

컬렉션 생성

MongoDB database 에서 컬렉션 명시적으로 만들려면 createCollection() 메서드에 컬렉션 이름을 전달합니다.

다음 예에서는 example_collection 이라는 이름의 collection을 만듭니다.

db.createCollection("example_collection")

최대 크기 및 문서 유효성 검사 규칙과 같은 컬렉션 옵션을 CreateCollectionOptions 인스턴스 에서 설정하여 지정할 수 있습니다. 그런 다음 CreateCollectionOptions 을 createCollection() 메서드에 전달합니다. 선택적 매개변수의 전체 목록은 CreateCollectionOptions API 설명서를 참조하세요.

컬렉션 목록 가져오기

listCollections() 메서드를 호출하여 데이터베이스의 컬렉션 목록을 쿼리할 수 있습니다. 이 메서드는 데이터베이스의 모든 컬렉션과 관련 메타데이터가 포함된 커서를 반환합니다.

다음 예시 에서는 listCollections() 메서드를 호출하고 반환된 반복자를 반복하여 컬렉션 액세스 및 컬렉션 만들기 예제의 컬렉션을 인쇄합니다.

val results = db.listCollections()
val jsonSettings = JsonWriterSettings.builder().indent(true).build()
results.forEach { result ->
    println(result.toJson(jsonSettings))
}

{
   "name": "example_collection",
   "type": "collection",
   "options": {},
   "info": {
      "readOnly": false,
      ...
   },
   "idIndex": { ... }
}
{
   "name": "test_collection",
   "type": "collection",
   "options": {},
   "info": {
      "readOnly": false,
      ...
   },
   "idIndex": { ... }
}

컬렉션 삭제

데이터베이스 에서 컬렉션 삭제 하려면 컬렉션 에서 drop() 메서드를 호출합니다.

다음 예시에서는 test_collection 컬렉션을 삭제합니다.

db.getCollection("test_collection").drop()

경고

컬렉션을 제거하면 컬렉션의 모든 데이터가 삭제됨

데이터베이스에서 컬렉션을 삭제하면 해당 컬렉션 내의 모든 문서와 모든 인덱스가 영구적으로 삭제됩니다.

컬렉션에 데이터가 더 이상 필요하지 않은 경우에만 컬렉션 을 삭제하세요.

읽기 및 쓰기 작업 구성

읽기 설정 (read preference), 읽기 고려 (read concern) 또는 쓰기 고려 (write concern) 를 지정하여 복제본 세트에서 읽기 및 쓰기 (write) 작업 실행 되는 방식을 제어할 수 있습니다.

기본값 으로 데이터베이스는 MongoClient 인스턴스 에서 읽기 및 쓰기 (write) 설정을 상속합니다. 컬렉션은 getCollection() 메서드가 호출되는 MongoClient 또는 MongoDatabase 인스턴스 에서 이러한 설정을 상속합니다. 다음 메서드를 호출하여 이러한 설정을 변경할 수 있습니다.

읽기 설정 (read preference), 읽기 고려 (read concern) 및 쓰기 고려 (write concern) 설정에 대한 자세한 학습 은 CRUD 작업 구성 가이드 참조하세요.

API 문서

이 가이드에서 사용되는 메서드 또는 유형에 대해 자세히 알아보려면 다음 API 설명서를 참조하세요.

돌아가기

연결 문제 해결

CRUD 작업