명령 실행

개요

이 가이드 에서는 코틀린 동기 (Kotlin Sync) 운전자 사용하여 데이터베이스 명령 실행 방법을 학습 수 있습니다. 데이터베이스 명령을 사용하여 서버 통계 가져오기, 복제본 세트 초기화 또는 집계 파이프라인 실행 과 같은 다양한 관리 및 진단 작업을 수행할 수 있습니다.

명령 실행

데이터베이스 명령 실행 하려면 문서 에 명령과 관련 매개변수를 지정한 다음 runCommand() 메서드에 문서 전달합니다.

다음 코드는 runCommand() 메서드를 사용하여 explain 명령을 실행 방법을 보여 줍니다. 이 명령은 호출 시 find 명령이 실행되는 방식에 대한 설명을 반환합니다.

val commandToExplain = Document("find", "restaurants")
val explanation = database.runCommand(Document("explain", commandToExplain))

데이터베이스 명령 및 해당 매개변수의 전체 목록은 데이터베이스 명령 가이드 참조하세요.

명령 옵션

readPreference 매개변수를 포함하여 runCommand() 메서드에 대한 선택적 명령 동작을 지정할 수 있습니다. 다음 예시 읽기 설정 (read preference) 지정하고 이를 runCommand() 메서드에 옵션으로 전달하는 방법을 보여 줍니다.

val command = Document("hello", 1)
val commandReadPreference = Document("readPreference", "secondary")
val commandResult = database.runCommand(command, commandReadPreference)

읽기 설정 옵션에 대한 자세한 내용은 MongoDB Server 매뉴얼의 읽기 설정 을 참조하세요.

응답

runCommand() 메서드는 명령이 실행된 후 데이터베이스 의 응답이 포함된 Document 객체 반환합니다. 각 데이터베이스 명령 서로 다른 기능을 수행하므로 응답 내용은 명령에 따라 다를 수 있습니다. 그러나 모든 응답에는 다음 필드가 있는 문서가 포함되어 있습니다.

예시

다음 예시 buildInfo 명령을 실행 방법과 이 명령이 생성하는 출력을 보여 줍니다.

import com.mongodb.MongoException
import com.mongodb.kotlin.client.MongoClient
import org.bson.Document
import org.bson.BsonInt64
import org.bson.json.JsonWriterSettings
fun main() {
    // Replace the placeholder with your MongoDB deployment's connection string
    val uri = "<connection string uri>"
    val mongoClient = MongoClient.create(uri)
    val database = mongoClient.getDatabase("sample_mflix")
    try {
        val command = Document("buildInfo", BsonInt64(1))
        val commandResult = database.runCommand(command)
        println(commandResult.toJson(JsonWriterSettings.builder().indent(true).build()))
    } catch (me: MongoException) {
        System.err.println("An error occurred: $me")
    }
    mongoClient.close()
}

{
  version: '8.0.4',
   ...<other command results>...
  ok: 1,
  '$clusterTime': {
      clusterTime: Timestamp({ ... }),
      signature: {
         ...
      }
  },
  operationTime: Timestamp({ ... })
}

추가 정보

이 가이드의 개념에 대한 자세한 내용은 다음 문서를 참조하세요.

• 코틀린 동기 (Kotlin Sync) API runCommand()

• 데이터베이스 명령

• explain 명령

• hello 명령

• buildInfo 명령